{
    "info": {
        "author": "Julio M Alegria",
        "author_email": "juliomalegria@gmail.com",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "python-craigslist\n=================\n\nA simple `Craigslist <http://www.craigslist.org>`__ wrapper.\n\nLicense: `MIT-Zero <https://romanrm.net/mit-zero>`__.\n\nDisclaimer\n----------\n\n* I don't work for or have any affiliation with Craigslist.\n* This module was implemented for educational purposes. It should not be used for crawling or downloading data from Craigslist.\n\nInstallation\n------------\n\n::\n\n    pip install python-craigslist\n\nClasses\n-------\n\nBase class:\n\n* ``CraigslistBase``\n\nSubclasses:\n\n* ``CraigslistCommunity`` (craigslist.org > community)\n* ``CraigslistHousing`` (craigslist.org > housing)\n* ``CraigslistJobs`` (craigslist.org > jobs)\n* ``CraigslistPersonals`` (craigslist.org > personals)\n* ``CraigslistForSale`` (craigslist.org > for sale)\n* ``CraigslistEvents`` (craigslist.org > event calendar)\n* ``CraigslistServices`` (craigslist.org > services)\n* ``CraigslistGigs`` (craigslist.org > gigs)\n* ``CraigslistResumes`` (craigslist.org > resumes)\n\nUsage\n-----\n\nEvery subclass has its own set of filters. To get a list of all the filters\nsupported by a specific subclass, use the ``.show_filters()`` class-method:\n\n.. code:: python\n\n   >>> from craigslist import CraigslistJobs, CraigslistForSale\n   >>> CraigslistJobs.show_filters()\n\n   Base filters:\n   * posted_today = True/False\n   * query = ...\n   * search_titles = True/False\n   * has_image = True/False\n   Section specific filters:\n   * is_internship = True/False\n   * is_telecommuting = True/False\n   * is_contract = True/False\n   * is_parttime = True/False\n   * is_nonprofit = True/False\n   * employment_type = u'full-time', u'part-time', u'contract', u\"employee's choice\"\n\n   >>> CraigslistForSale.show_filters(category='cta')\n\n   Base filters:\n   * posted_today = True/False\n   * query = ...\n   * search_titles = True/False\n   * has_image = True/False\n   Section specific filters:\n   * min_year = ...\n   * model = ...\n   * min_price = ...\n   * max_miles = ...\n   * make = ...\n   * max_price = ...\n   * min_miles = ...\n   * max_year = ...\n   * auto_title_status = u'clean', u'salvage', u'rebuilt', u'parts only', u'lien', u'missing'\n   * auto_transmission = u'manual', u'automatic', u'other'\n   * auto_fuel_type = u'gas', u'diesel', u'hybrid', u'electric', u'other'\n   * auto_paint = u'black', u'blue', u'brown', u'green', u'grey', u'orange', u'purple', u'red', u'silver', u'white', u'yellow', u'custom'\n   * auto_bodytype = u'bus', u'convertible', u'coupe', u'hatchback', u'mini-van', u'offroad', u'pickup', u'sedan', u'truck', u'SUV', u'wagon', u'van', u'other'\n   * auto_drivetrain = u'fwd', u'rwd', u'4wd'\n   * auto_size = u'compact', u'full-size', u'mid-size', u'sub-compact'\n   * auto_cylinders = u'3 cylinders', u'4 cylinders', u'5 cylinders', u'6 cylinders', u'8 cylinders', u'10 cylinders', u'12 cylinders', u'other'\n   * condition = u'new', u'like new', u'excellent', u'good', u'fair', u'salvage'\n\nWhere to get ``site`` and ``area`` from?\n----------------------------------------\n\nWhen initializing any of the subclasses, you'll need to provide the ``site``, and optionall the ``area``, from where you want to query data.\n\nTo get the right ``site``, follow these steps:\n\n1. Go to `craigslist.org/about/sites <https://www.craigslist.org/about/sites>`__.\n2. Find the country or city you're interested on, and click on it.\n3. You'll be directed to ``<site>.craigslist.org``. The value of ``<site>`` in the URL is the one you should use.\n\nNot all sites have areas. To check if your site has areas, check for links next to the title of the Craigslist page, on the top center. For example, for New York you'll see:\n\n.. image:: https://user-images.githubusercontent.com/1008637/45307206-bb404d80-b51e-11e8-8e6d-edfbdbd0a6fa.png\n\nClick on the one you're interested, and you'll be redirected to ``<site>.craigslist.org/<area>``. The value of ``<area>`` in the URL is the one you should use. If there are no areas next to the title, it means your site has no areas, and you can leave that argument unset.\n\nWhere to get ``category`` from?\n-------------------------------\n\nYou can additionally provide a ``category`` when initializing any of the subclasses. To obtain the code of this ``category``, follow these steps:\n\n1. Go to ``<site>.craigslist.org`` or just `craigslist.org <https://www.craigslist.org>`__ (you'll be directed to the last used ``site``).\n2. You'll see a list of categories and subcategories (see image below).\n3. Click on the interested subcategory. You'll be redirected to the search view for that subcategory. The URL you were redirected will end with ``/search/<category>``. This would be the code for your category.\n\n.. image:: https://user-images.githubusercontent.com/14173022/46252889-3614ce00-c424-11e8-9bac-060c236b8b58.png\n\nExamples\n--------\n\nLooking for a room in San Francisco?\n\n.. code:: python\n\n    from craigslist import CraigslistHousing\n    cl_h = CraigslistHousing(site='sfbay', area='sfc', category='roo',\n                             filters={'max_price': 1200, 'private_room': True})\n\n    for result in cl_h.get_results(sort_by='newest', geotagged=True):\n        print result\n\n    {\n        'id': u'4851150747',\n        'name': u'Near SFSU, UCSF and NEWLY FURNISHED - CLEAN, CONVENIENT and CLEAN!',\n        'url': u'http://sfbay.craigslist.org/sfc/roo/4851150747.html',\n        'datetime': u'2015-01-27 23:44',\n        'price': u'$1100',\n        'where': u'inner sunset / UCSF',\n        'has_image': False,\n        'has_map': True,\n        'geotag': (37.738473, -122.494721)\n    }\n    # ...\n\nMaybe an software engineering internship in Silicon Valley?\n\n.. code:: python\n\n    from craigslist import CraigslistJobs\n    cl_j = CraigslistJobs(site='sfbay', area='sby', category='sof',\n                          filters={'is_internship': True, 'employment_type': ['full-time', 'part-time']})\n\n    for result in cl_j.get_results():\n        print result\n\n    {\n        'id': u'5708651182',\n        'name': u'GAME DEVELOPER INTERNSHIP AT TYNKER - AVAILABLE NOW!',\n\t'url': u'http://sfbay.craigslist.org/pen/eng/5708651182.html',\n\t'datetime': u'2016-07-30 13:30',\n\t'price': None,\n\t'where': u'mountain view',\n\t'has_image': True,\n\t'has_map': True,\n\t'geotag': None\n    }\n    # ...\n\nEvents with free food in New York?\n\n.. code:: python\n\n    from craigslist import CraigslistEvents\n    cl_e = CraigslistEvents(site='newyork', filters={'free': True, 'food': True})\n\n    for result in cl_e.get_results(sort_by='newest', limit=5):\n        print result\n\n    {\n        'id': u'4866178242',\n        'name': u'Lituation Thursdays @ Le Reve',\n        'url': u'http://newyork.craigslist.org/mnh/eve/4866178242.html',\n        'datetime': u'1/29',\n        'price': None,\n        'where': u'Midtown East',\n        'has_image': True,\n        'has_map': True,\n        'geotag': None\n    }\n    # ...\n\nSupport\n-------\n\nIf you find any bug or you want to propose a new feature, please use the `issues tracker <https://github.com/juliomalegria/python-craigslist/issues>`__. I'll be happy to help you! :-)",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "https://github.com/juliomalegria/python-craigslist/tarball/1.0.7",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/juliomalegria/python-craigslist",
        "keywords": "",
        "license": "MIT-Zero",
        "maintainer": "",
        "maintainer_email": "",
        "name": "python-craigslist",
        "package_url": "https://pypi.org/project/python-craigslist/",
        "platform": "",
        "project_url": "https://pypi.org/project/python-craigslist/",
        "project_urls": {
            "Download": "https://github.com/juliomalegria/python-craigslist/tarball/1.0.7",
            "Homepage": "https://github.com/juliomalegria/python-craigslist"
        },
        "release_url": "https://pypi.org/project/python-craigslist/1.0.7/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "Simple Craigslist wrapper.",
        "version": "1.0.7"
    },
    "last_serial": 5736418,
    "releases": {
        "1.0.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "0c09ef4a5821cc4ea13a3c01bb7698bb",
                    "sha256": "e53508d63843ce1688316f2cfa70963ef7a6c4ceb110436b47a5982ee9c676f0"
                },
                "downloads": -1,
                "filename": "python-craigslist-1.0.0.tar.gz",
                "has_sig": false,
                "md5_digest": "0c09ef4a5821cc4ea13a3c01bb7698bb",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 10714,
                "upload_time": "2015-01-28T09:02:46",
                "url": "https://files.pythonhosted.org/packages/20/12/c15e1ebac2fd7c5eea2106b7171a071469459d688c9154cde3cfc06089f3/python-craigslist-1.0.0.tar.gz"
            }
        ],
        "1.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ce8c18ceca6bfaefefc15ba7906d0f5f",
                    "sha256": "40c16f43bbbbbb2f3982070677c212fb743b1643912c121d8351332a981ba878"
                },
                "downloads": -1,
                "filename": "python-craigslist-1.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "ce8c18ceca6bfaefefc15ba7906d0f5f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 11667,
                "upload_time": "2016-07-27T04:17:53",
                "url": "https://files.pythonhosted.org/packages/b7/25/11b4d865b03f3cf0449b38f503b46f41ce37f0be2ae527e10b25fe20f6da/python-craigslist-1.0.1.tar.gz"
            }
        ],
        "1.0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "6a06c1ae4471cdfe95acd95639c0fd38",
                    "sha256": "13c06bc4d573571ccefcd33373d9ce8625193348d5aacb47fb897653b3f0e90d"
                },
                "downloads": -1,
                "filename": "python-craigslist-1.0.2.tar.gz",
                "has_sig": false,
                "md5_digest": "6a06c1ae4471cdfe95acd95639c0fd38",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 13198,
                "upload_time": "2016-09-18T00:58:49",
                "url": "https://files.pythonhosted.org/packages/b0/ce/ba0610fdbc4b8698b193cef42f814f0e05cfceda97a61df2b8e7a453ca73/python-craigslist-1.0.2.tar.gz"
            }
        ],
        "1.0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "8f0047b338027372adc2ccced85dc1ef",
                    "sha256": "bc154c068e68163497e22934710d949224bbe8d604bf140686fb046706ef49fc"
                },
                "downloads": -1,
                "filename": "python-craigslist-1.0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "8f0047b338027372adc2ccced85dc1ef",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 13559,
                "upload_time": "2016-11-06T20:32:30",
                "url": "https://files.pythonhosted.org/packages/e5/97/20bb7f78a3215cc4c6aaf05c808ac55b9ff6e67fdc650166d0693a9c31d1/python-craigslist-1.0.3.tar.gz"
            }
        ],
        "1.0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ca26c2dc0fe9388d1530ccc26119a1a2",
                    "sha256": "0082b374e49c4b9ccbe88404c62c0956a6bc9ce7302384938222f0d23ec62c04"
                },
                "downloads": -1,
                "filename": "python-craigslist-1.0.4.tar.gz",
                "has_sig": false,
                "md5_digest": "ca26c2dc0fe9388d1530ccc26119a1a2",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14504,
                "upload_time": "2017-06-13T08:59:18",
                "url": "https://files.pythonhosted.org/packages/cf/44/cdc135eeaf8d1f8dc27a5329dee99d4aaa807b050107867958cd00ceeccb/python-craigslist-1.0.4.tar.gz"
            }
        ],
        "1.0.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "5c469471f671982d92be9c7158504f7f",
                    "sha256": "f832ac96e5f15097edc0c4be79b7446c985454ed9f5e76444c2a97b6893444c7"
                },
                "downloads": -1,
                "filename": "python-craigslist-1.0.5.tar.gz",
                "has_sig": false,
                "md5_digest": "5c469471f671982d92be9c7158504f7f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14651,
                "upload_time": "2017-12-14T16:18:39",
                "url": "https://files.pythonhosted.org/packages/ae/86/638f59becb44721f487fecc99df50c6030ed3a17625e6d7ce47d7acf9055/python-craigslist-1.0.5.tar.gz"
            }
        ],
        "1.0.6": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "c107445f9514205ee05417f15176d2ae",
                    "sha256": "871b5ea131b969fd7702e405de170fca5356cfc7ca4e4ee3bdc067bb66dfc999"
                },
                "downloads": -1,
                "filename": "python-craigslist-1.0.6.tar.gz",
                "has_sig": false,
                "md5_digest": "c107445f9514205ee05417f15176d2ae",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 17462,
                "upload_time": "2018-03-04T14:21:20",
                "url": "https://files.pythonhosted.org/packages/1c/a4/2803dafd92f4343f3f6b896fa63ce5784c0b82d588ef7b6441382bf8066f/python-craigslist-1.0.6.tar.gz"
            }
        ],
        "1.0.7": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "639f6bcca2fb5e7f9444c9ceb9d461cb",
                    "sha256": "e01e887c8bf815f9b79788ad59d33309a31b5db77de7c0b628012841fb1803ba"
                },
                "downloads": -1,
                "filename": "python-craigslist-1.0.7.tar.gz",
                "has_sig": false,
                "md5_digest": "639f6bcca2fb5e7f9444c9ceb9d461cb",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 19116,
                "upload_time": "2019-08-27T12:15:54",
                "url": "https://files.pythonhosted.org/packages/8d/b7/efff796e68c674ce026aa8a5bec07f19f887b8b37540ea82e740471fe2e8/python-craigslist-1.0.7.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "639f6bcca2fb5e7f9444c9ceb9d461cb",
                "sha256": "e01e887c8bf815f9b79788ad59d33309a31b5db77de7c0b628012841fb1803ba"
            },
            "downloads": -1,
            "filename": "python-craigslist-1.0.7.tar.gz",
            "has_sig": false,
            "md5_digest": "639f6bcca2fb5e7f9444c9ceb9d461cb",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 19116,
            "upload_time": "2019-08-27T12:15:54",
            "url": "https://files.pythonhosted.org/packages/8d/b7/efff796e68c674ce026aa8a5bec07f19f887b8b37540ea82e740471fe2e8/python-craigslist-1.0.7.tar.gz"
        }
    ]
}