craigslist 0.1.1

Python wrapper for craigslist.

Python wrapper for craigslist. Requires Python 3.6+.

Install

pip3 install craigslist

CLI

$ craigslist --help
usage: craigslist [-h] {search} ...

examples:
craigslist search washingtondc apa --postal 20071 --search_distance 1
craigslist search newyork aap --postal 10023 --search_distance 1 --hasPic --availabilityMode within_30_days --limit 100
craigslist search sfbay ccc --postal 94305 --search_distance 1 --limit 10
craigslist search vancouver sss "shoes" --condition new like_new --hasPic --max_price 20 --limit 10
craigslist search washingtondc jjj --is_telecommuting --is_internship

positional arguments:
  {search}
    search    search craigslist

optional arguments:
  -h, --help  show this help message and exit

For more details, try:

$ craigslist search --help

API

See the examples folder.

simple

import craigslist

for post in craigslist.search('washingtondc', 'apa', postal=20071, search_distance=1):
    print(post)

# craiglist posts expire. replace the url below with something current
post = craigslist.get('https://washingtondc.craigslist.org/nva/apa/5875729002.html')

async

import asyncio
import craigslist

async def main():
    async for post in craigslist.search_async('washingtondc', 'apa', postal=20071, search_distance=1):
        print(post)

    # craiglist posts expire. replace the url below with something current
    post = await craigslist.get_async('https://washingtondc.craigslist.org/nva/apa/5875729002.html')

loop = asyncio.get_event_loop()
loop.run_until_complete(main())
loop.close()

Development

Setup

mkvirtualenv craigslist -p python3.6
make install

Test

workon craigslist
make test

Disclaimer

• This library is not associated with Craigslist.

• Please read the Craigslist terms of use.