Craigslist Scraper

ENDPOINTS
GET/search/counts

Search Counts

Count the listings matching a query in every section and category of one location.

QUERY PARAMS

Keywords to count listings for.

Example: bike

Where to search. One param, four forms, auto-detected.

Examples:

  • Craigslist site: newyork (also nyc or new york)
  • Any link on that site: https://newyork.craigslist.org
  • Postal code: 94103 (searches a radius around it)
  • Coordinates: 40.7128,-74.0060 (searches a radius around the point)

Find site names with /locations/search.

Three-letter subarea code that narrows a site to one district. Needs a Craigslist site in location. Get the codes from /locations/search.

Example: brk (Brooklyn on newyork)

Search radius around a postal code or coordinates, in the local distance unit (miles in the US, km in Canada). Needs a postal code or coordinates in location.

Default: 30

Allowed values: 1-1000

{
  "query": "bike",
  "site": "newyork",
  "subarea": null,
  "total_count": 4552,
  "sections": [
    {
      "section": "for_sale",
      "code": "sss",
      "name": "for sale",
      "count": 3544,
      "categories": [
        {
          "code": "bia",
          "name": "bicycles",
          "count": 2316
        },
        {
          "code": "bip",
          "name": "bicycle parts",
          "count": 375
        },
        {
          "code": "sga",
          "name": "sporting goods",
          "count": 172
        },
        {
          "code": "mca",
          "name": "motorcycles/scooters",
          "count": 95
        },
        {
          "code": "foa",
          "name": "general for sale",
          "count": 89
        },
        {
          "code": "ela",
          "name": "electronics",
          "count": 83
        },
        {
          "code": "mpa",
          "name": "motorcycle parts & accessories",
          "count": 69
        },
        {
          "code": "hsa",
          "name": "household items",
          "count": 53
        },
        {
          "code": "baa",
          "name": "baby & kid stuff",
          "count": 50
        },
        {
          "code": "cla",
          "name": "clothing & accessories",
          "count": 29
        },
        {
          "code": "waa",
          "name": "wanted",
          "count": 22
        },
        {
          "code": "pta",
          "name": "auto parts",
          "count": 21
        },
        {
          "code": "fua",
          "name": "furniture",
          "count": 18
        },
        {
          "code": "haa",
          "name": "health and beauty",
          "count": 15
        },
        {
          "code": "sna",
          "name": "atvs, utvs, snowmobiles",
          "count": 14
        },
        {
          "code": "taa",
          "name": "toys & games",
          "count": 14
        },
        {
          "code": "zip",
          "name": "free stuff",
          "count": 12
        },
        {
          "code": "tla",
          "name": "tools",
          "count": 10
        },
        {
          "code": "cba",
          "name": "collectibles",
          "count": 9
        },
        {
          "code": "bar",
          "name": "barter",
          "count": 8
        },
        {
          "code": "ppa",
          "name": "appliances",
          "count": 8
        },
        {
          "code": "cta",
          "name": "cars & trucks",
          "count": 6
        },
        {
          "code": "ata",
          "name": "antiques",
          "count": 6
        },
        {
          "code": "gms",
          "name": "garage & moving sales",
          "count": 6
        },
        {
          "code": "maa",
          "name": "materials",
          "count": 6
        },
        {
          "code": "boo",
          "name": "boats",
          "count": 5
        },
        {
          "code": "bka",
          "name": "books & magazines",
          "count": 5
        },
        {
          "code": "pha",
          "name": "photo/video",
          "count": 5
        },
        {
          "code": "msa",
          "name": "musical instruments",
          "count": 4
        },
        {
          "code": "wta",
          "name": "auto wheels & tires",
          "count": 4
        },
        {
          "code": "ara",
          "name": "arts & crafts",
          "count": 4
        },
        {
          "code": "tra",
          "name": "trailers",
          "count": 3
        },
        {
          "code": "sya",
          "name": "computers",
          "count": 2
        },
        {
          "code": "jwa",
          "name": "jewelry",
          "count": 1
        },
        {
          "code": "hva",
          "name": "heavy equipment",
          "count": 1
        },
        {
          "code": "gra",
          "name": "farm & garden",
          "count": 1
        },
        {
          "code": "rva",
          "name": "recreational vehicles",
          "count": 1
        },
        {
          "code": "bfa",
          "name": "business",
          "count": 1
        },
        {
          "code": "bpa",
          "name": "boat parts & accessories",
          "count": 1
        }
      ]
    },
    {
      "section": "housing",
      "code": "hhh",
      "name": "housing",
      "count": 766,
      "categories": [
        {
          "code": "apa",
          "name": "apartments / housing for rent",
          "count": 463
        },
        {
          "code": "rea",
          "name": "real estate",
          "count": 130
        },
        {
          "code": "off",
          "name": "office & commercial",
          "count": 62
        },
        {
          "code": "roo",
          "name": "rooms & shares",
          "count": 46
        },
        {
          "code": "sub",
          "name": "sublets & temporary",
          "count": 30
        },
        {
          "code": "prk",
          "name": "parking & storage",
          "count": 23
        },
        {
          "code": "vac",
          "name": "vacation rentals",
          "count": 10
        },
        {
          "code": "hou",
          "name": "wanted: apts",
          "count": 1
        },
        {
          "code": "rew",
          "name": "wanted: real estate",
          "count": 1
        }
      ]
    },
    {
      "section": "services",
      "code": "bbb",
      "name": "services",
      "count": 150,
      "categories": [
        {
          "code": "lbs",
          "name": "labor / hauling / moving",
          "count": 108
        },
        {
          "code": "hss",
          "name": "household services",
          "count": 18
        },
        {
          "code": "sks",
          "name": "skilled trade services",
          "count": 10
        },
        {
          "code": "cps",
          "name": "computer services",
          "count": 6
        },
        {
          "code": "aos",
          "name": "automotive services",
          "count": 3
        },
        {
          "code": "cys",
          "name": "cycle services",
          "count": 3
        },
        {
          "code": "biz",
          "name": "small biz ads",
          "count": 1
        },
        {
          "code": "fgs",
          "name": "farm & garden services",
          "count": 1
        }
      ]
    },
    {
      "section": "jobs",
      "code": "jjj",
      "name": "jobs",
      "count": 48,
      "categories": [
        {
          "code": "fbh",
          "name": "food/beverage/hospitality",
          "count": 14
        },
        {
          "code": "trp",
          "name": "transportation",
          "count": 14
        },
        {
          "code": "lab",
          "name": "general labor",
          "count": 8
        },
        {
          "code": "etc",
          "name": "et cetera",
          "count": 7
        },
        {
          "code": "csr",
          "name": "customer service",
          "count": 4
        },
        {
          "code": "wri",
          "name": "writing/editing",
          "count": 1
        }
      ]
    },
    {
      "section": "gigs",
      "code": "ggg",
      "name": "gigs",
      "count": 27,
      "categories": [
        {
          "code": "lbg",
          "name": "labor gigs",
          "count": 25
        },
        {
          "code": "cwg",
          "name": "crew gigs",
          "count": 1
        },
        {
          "code": "crg",
          "name": "creative gigs",
          "count": 1
        }
      ]
    },
    {
      "section": "community",
      "code": "ccc",
      "name": "community",
      "count": 14,
      "categories": [
        {
          "code": "laf",
          "name": "lost & found",
          "count": 4
        },
        {
          "code": "ats",
          "name": "artists",
          "count": 4
        },
        {
          "code": "rnr",
          "name": "rants & raves",
          "count": 3
        },
        {
          "code": "com",
          "name": "general community",
          "count": 1
        },
        {
          "code": "rid",
          "name": "rideshare",
          "count": 1
        },
        {
          "code": "mis",
          "name": "missed connections",
          "count": 1
        }
      ]
    },
    {
      "section": "resumes",
      "code": "rrr",
      "name": "resumes",
      "count": 2,
      "categories": [
        {
          "code": "res",
          "name": "resumes / job wanted",
          "count": 2
        }
      ]
    },
    {
      "section": "events",
      "code": "eee",
      "name": "events/classes",
      "count": 1,
      "categories": [
        {
          "code": "eve",
          "name": "events",
          "count": 1
        }
      ]
    }
  ]
}