Craigslist API

API ID 14944

Classified postings in every section: for sale, housing, jobs, gigs, services, community, events and resumes, with area, price and category filters, full posting details, areas and category counts.

API Documentation

Endpoints

Request
Returns every Craigslist area (local site) with its id, hostname, name, country, region, coordinates, timezone and subareas. The area hostname and the subarea abbreviation are what the search endpoints take.
Endpoint ID: 39137
GET https://zylalabs.com/api/14944/craigslist+api/39137/get+all+areas+with+their+subareas
INPUT PARAMETERS

Get all areas with their subareas — Endpoint Features

Object Description
country Optional Two-letter country code to list the areas of one country only (e.g. US)

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

country
API EXAMPLE RESPONSE
JSON
[
    {
        "id": 1,
        "hostname": "sfbay",
        "abbreviation": "sfo",
        "name": "SF bay area",
        "shortName": "SF bay area",
        "country": "US",
        "region": "CA",
        "latitude": 37.5,
        "longitude": -122.25,
        "timezone": "America/Los_Angeles",
        "subareas": [
            {
                "id": 1,
                "abbreviation": "sfc",
                "name": "city of san francisco",
                "shortName": "san francisco"
            },
            {
                "id": 2,
                "abbreviation": "sby",
                "name": "south bay area",
                "shortName": "south bay"
            },
            {
                "id": 3,
                "abbreviation": "eby",
                "name": "east bay area",
                "shortName": "east bay"
            },
            {
                "id": 4,
                "abbreviation": "pen",
                "name": "peninsula",
                "shortName": "peninsula"
            },
            {
                "id": 5,
                "abbreviation": "nby",
                "name": "north bay / marin",
                "shortName": "north bay"
            },
            {
                "id": 6,
                "abbreviation": "scz",
                "name": "santa cruz co",
                "shortName": "santa cruz"
            }
        ]
    },
    {
        "id": 2,
        "hostname": "seattle",
        "abbreviation": "sea",
        "name": "seattle-tacoma",
        "shortName": "seattle",
        "country": "US",
        "region": "WA",
        "latitude": 47.6064,
        "longitude": -122.331001,
        "timezone": "America/Los_Angeles",
        "subareas": [
            {
                "id": 1,
                "abbreviation": "see",
                "name": "seattle",
                "shortName": "seattle"
            },
            {
                "id": 2,
                "abbreviation": "est",
                "name": "eastside",
                "shortName": "eastside"
            },
            {
                "id": 3,
                "abbreviation": "sno",
                "name": "snohomish county",
                "shortName": "snohomish co"
            },
            {
                "id": 4,
                "abbreviation": "kit",
                "name": "kitsap / west puget",
                "shortName": "kitsap co"
            },
            {
                "id": 5,
                "abbreviation": "tac",
                "name": "tacoma / pierce",
                "shortName": "tacoma"
            },
            {
                "id": 6,
                "abbreviation": "oly",
                "name": "olympia / thurston",
                "shortName": "olympia"
            },
            {
                "id": 7,
                "abbreviation": "skc",
                "name": "south king co",
                "shortName": "south king"
            }
        ]
    },
    {
        "id": 3,
        "hostname": "newyork",
        "abbreviation": "nyc",
        "name": "new york city",
        "shortName": "new york",
        "country": "US",
        "region": "NY",
        "latitude": 40.714199,
        "longitude": -74.006401,
        "timezone": "America/New_York",
        "subareas": [
            {
                "id": 1,
                "abbreviation": "mnh",
                "name": "manhattan",
                "shortName": "manhattan"
            },
            {
                "id": 2,
                "abbreviation": "brk",
                "name": "brooklyn",
                "shortName": "brooklyn"
            },
            {
                "id": 3,
                "abbreviation": "que",
                "name": "queens",
                "shortName": "queens"
            },
            {
                "id": 4,
                "abbreviation": "brx",
                "name": "bronx",
                "shortName": "bronx"
            },
            {
                "id": 5,
                "abbreviation": "stn",
                "name": "staten island",
                "shortName": "staten island"
            },
            {
                "id": 6,
                "abbreviation": "jsy",
                "name": "new jersey",
                "shortName": "new jersey"
            },
            {
                "id": 7,
                "abbreviation": "lgi",
                "name": "long island",
                "shortName": "long island"
            },
            {
                "id": 8,
                "abbreviation": "wch",
                "name": "westchester",
                "shortName": "westchester"
            },
            {
                "id": 9,
                "abbreviation": "fct",
                "name": "fairfield co, CT",
                "shortName": "fairfield"
            }
        ]
    },
    {
        "id": 4,
        "hostname": "boston",
        "abbreviation": "bos",
        "name": "boston",
        "shortName": "boston",
        "country": "US",
        "region": "MA",
        "latitude": 42.358299,
        "longitude": -71.060303,
        "timezone": "America/New_York",
        "subareas": [
            {
                "id": 1,
                "abbreviation": "gbs",
                "name": "boston/cambridge/brookline",
                "shortName": "boston/camb/brook"
            },
            {
                "id": 2,
                "abbreviation": "nwb",
                "name": "northwest/merrimack",
                "shortName": "northwest/merrimack"
            },
            {
                "id": 3,
                "abbreviation": "bmw",
                "name": "metro west",
                "shortName": "metro west"
            },
            {
                "id": 4,
                "abbreviation": "nos",
                "name": "north shore",
                "shortName": "north shore"
            },
            {
                "id": 5,
                "abbreviation": "sob",
                "name": "south shore",
                "shortName": "south shore"
            }
        ]
    },
    {
        "id": 7,
        "hostname": "losangeles",
        "abbreviation": "lax",
        "name": "los angeles",
        "shortName": "los angeles",
        "country": "US",
        "region": "CA",
        "latitude": 34.0522,
        "longitude": -118.242996,
        "timezone": "America/Los_Angeles",
        "subareas": [
            {
                "id": 1,
                "abbreviation": "wst",
                "name": "westside-southbay-310",
                "shortName": "westside-southbay"
            },
            {
                "id": 2,
                "abbreviation": "sfv",
                "name": "san fernando valley",
                "shortName": "SF valley"
            },
            {
                "id": 3,
                "abbreviation": "lac",
                "name": "central LA 213/323",
                "shortName": "central LA"
            },
            {
                "id": 4,
                "abbreviation": "sgv",
                "name": "san gabriel valley",
                "shortName": "san gabriel valley"
            },
            {
                "id": 5,
                "abbreviation": "lgb",
                "name": "long beach / 562",
                "shortName": "long beach"
            },
            {
                "id": 6,
                "abbreviation": "ant",
                "name": "antelope valley",
                "shortName": "antelope valley"
            }
        ]
    },
    {
        "id": 8,
        "hostname": "sandiego",
        "abbreviation": "sdo",
        "name": "san diego",
        "shortName": "san diego",
        "country": "US",
        "region": "CA",
        "latitude": 32.715302,
        "longitude": -117.155998,
        "timezone": "America/Los_Angeles",
        "subareas": [
            {
                "id": 1,
                "abbreviation": "csd",
                "name": "city of san diego",
                "shortName": "city of san diego"
            },
            {
                "id": 2,
                "abbreviation": "nsd",
                "name": "north san diego county",
                "shortName": "north SD county"
            },
            {
                "id": 3,
                "abbreviation": "esd",
                "name": "east san diego county",
                "shortName": "east SD county"
            },
            {
                "id": 4,
                "abbreviation": "ssd",
                "name": "south san diego county",
                "shortName": "south SD county"
            }
        ]
    },
    {
        "id": 9,
        "hostname": "portland",
        "abbreviation": "pdx",
        "name": "portland, OR",
        "shortName": "portland",
        "country": "US",
        "region": "OR",
        "latitude": 45.523602,
        "longitude": -122.675003,
        "timezone": "America/Los_Angeles",
        "subareas": [
            {
                "id": 1,
                "abbreviation": "mlt",
                "name": "multnomah county",
                "shortName": "multnomah co"
            },
            {
                "id": 2,
                "abbreviation": "wsc",
                "name": "washington county",
                "shortName": "washington co"
            },
            {
                "id": 3,
                "abbreviation": "clk",
                "name": "clark/cowlitz WA"
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
Get all areas with their subareas — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14944/craigslist+api/39137/get+all+areas+with+their+subareas?country=US' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the Craigslist area and subarea that cover a pair of coordinates, together with the city, region, country and postal code at that point.
Endpoint ID: 39138
GET https://zylalabs.com/api/14944/craigslist+api/39138/get+the+area+that+covers+given+coordinates
INPUT PARAMETERS

Get the area that covers given coordinates — Endpoint Features

Object Description
latitude Required Latitude of the point (e.g. 40.7128)
longitude Required Longitude of the point (e.g. -74.0060)

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

latitude
longitude
API EXAMPLE RESPONSE
JSON
{
    "area": "newyork",
    "areaId": 3,
    "subarea": "que",
    "city": "New York",
    "region": "NY",
    "country": "US",
    "postal": "10156",
    "latitude": 40.714,
    "longitude": -74.007
}
Get the area that covers given coordinates — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14944/craigslist+api/39138/get+the+area+that+covers+given+coordinates?latitude=40.7128&longitude=-74.0060' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the Craigslist sections (for sale, housing, jobs, gigs, services, community, events, resumes) with the categories of each: id, abbreviation and name. Both the section and the category abbreviation are accepted wherever a category is asked for.
Endpoint ID: 39139
GET https://zylalabs.com/api/14944/craigslist+api/39139/get+all+sections+with+their+categories
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "abbreviation": "hhh",
        "name": "housing",
        "categories": [
            {
                "id": 1,
                "abbreviation": "apa",
                "name": "apartments / housing for rent"
            },
            {
                "id": 2,
                "abbreviation": "hou",
                "name": "wanted: apts"
            },
            {
                "id": 18,
                "abbreviation": "roo",
                "name": "rooms & shares"
            },
            {
                "id": 19,
                "abbreviation": "sha",
                "name": "wanted: room/share"
            },
            {
                "id": 39,
                "abbreviation": "sub",
                "name": "sublets & temporary"
            },
            {
                "id": 40,
                "abbreviation": "off",
                "name": "office & commercial"
            },
            {
                "id": 41,
                "abbreviation": "prk",
                "name": "parking & storage"
            },
            {
                "id": 58,
                "abbreviation": "sbw",
                "name": "wanted: sublet/temp"
            },
            {
                "id": 65,
                "abbreviation": "swp",
                "name": "housing swap"
            },
            {
                "id": 99,
                "abbreviation": "vac",
                "name": "vacation rentals"
            },
            {
                "id": 121,
                "abbreviation": "rew",
                "name": "wanted: real estate"
            },
            {
                "id": 143,
                "abbreviation": "reo",
                "name": "real estate - by owner"
            },
            {
                "id": 144,
                "abbreviation": "reb",
                "name": "real estate - by broker"
            }
        ]
    },
    {
        "abbreviation": "ccc",
        "name": "community",
        "categories": [
            {
                "id": 3,
                "abbreviation": "com",
                "name": "general community"
            },
            {
                "id": 29,
                "abbreviation": "vol",
                "name": "volunteers"
            },
            {
                "id": 35,
                "abbreviation": "act",
                "name": "activity partners"
            },
            {
                "id": 36,
                "abbreviation": "rid",
                "name": "rideshare"
            },
            {
                "id": 37,
                "abbreviation": "pet",
                "name": "pets"
            },
            {
                "id": 56,
                "abbreviation": "kid",
                "name": "childcare"
            },
            {
                "id": 63,
                "abbreviation": "mis",
                "name": "missed connections"
            },
            {
                "id": 70,
                "abbreviation": "ats",
                "name": "artists"
            },
            {
                "id": 71,
                "abbreviation": "muc",
                "name": "musicians"
            },
            {
                "id": 87,
                "abbreviation": "pol",
                "name": "politics"
            },
            {
                "id": 88,
                "abbreviation": "laf",
                "name": "lost & found"
            },
            {
                "id": 90,
                "abbreviation": "rnr",
                "name": "rants & raves"
            },
            {
                "id": 91,
                "abbreviation": "grp",
                "name": "groups"
            },
            {
                "id": 116,
                "abbreviation": "vnn",
                "name": "local news and views"
            }
        ]
    },
    {
        "abbreviation": "bbb",
        "name": "services",
        "categories": [
            {
                "id": 4,
                "abbreviation": "biz",
                "name": "small biz ads"
            },
            {
                "id": 76,
                "abbreviation": "cps",
                "name": "computer services"
            },
            {
                "id": 77,
                "abbreviation": "crs",
                "name": "creative services"
            },
            {
                "id": 79,
                "abbreviation": "evs",
                "name": "event services"
            },
            {
                "id": 80,
                "abbreviation": "hss",
                "name": "household services"
            },
            {
                "id": 81,
                "abbreviation": "lss",
                "name": "lessons & tutoring"
            },
            {
                "id": 82,
                "abbreviation": "lbs",
                "name": "labor / hauling / moving"
            },
            {
                "id": 83,
                "abbreviation": "sks",
                "name": "skilled trade services"
            },
            {
                "id": 103,
                "abbreviation": "lgs",
                "name": "legal services"
            },
            {
                "id": 104,
                "abbreviation": "fns",
                "name": "financial services"
            },
            {
                "id": 105,
                "abbreviation": "rts",
                "name": "real estate services"
            },
            {
                "id": 106,
                "abbreviation": "aos",
                "name": "automotive services"
            },
            {
                "id": 138,
                "abbreviation": "bts",
                "name": "beauty services"
            },
            {
                "id": 139,
                "abbreviation": "wet",
                "name": "writing / editing / translation"
            },
            {
                "id": 140,
                "abbreviation": "trv",
                "name": "travel/vacation services"
            },
            {
                "id": 154,
                "abbreviation": "fgs",
                "name": "farm & garden services"
            },
            {
                "id": 155,
                "abbreviation": "pas",
                "name": "pet services"
            },
            {
                "id": 156,
                "abbreviation": "mas",
                "name": "marine services"
            },
            {
                "id": 158,
                "abbreviation": "cys",
                "name": "cycle services"
            },
            {
                "id": 207,
                "abbreviation": "cms",
                "name": "cell phone / mobile services"
            },
            {
                "id": 210,
                "abbreviation": "hws",
                "name": "health/wellness services"
            }
        ]
    },
    {
        "abbreviation": "sss",
        "name": "for sale",
        "categories": [
            {
                "id": 5,
                "abbreviation": "for",
                "name": "general for sale - by owner"
            },
            {
                "id": 7,
                "abbreviation": "sys",
                "name": "computers - by owner"
            },
            {
                "id": 20,
                "abbreviation": "wan",
                "name": "wanted - by owner"
            },
            {
                "id": 42,
                "abbreviation": "bar",
                "name": "barter"
            },
            {
                "id": 44,
                "abbreviation": "tix",
                "name": "tickets - by owner"
            },
            {
                "id": 68,
                "abbreviation": "bik",
                "name": "bicycles - by owner"
            },
            {
                "id": 69,
                "abbreviation": "mcy",
                "name": "motorcycles/scooters - by owner"
            },
            {
                "id": 73,
                "abbreviation": "gms",
                "name": "garage & moving sales"
            },
            {
                "id": 92,
                "abbreviation": "bks",
                "name": "books & magazines - by owner"
            },
            {
                "id": 93,
                "abbreviation": "spo",
                "name": "sporting goods - by owner"
            },
            {
                "id": 94,
                "abbreviation": "clo",
                "name": "clothing & accessories - by owner"
            },
            {
                "id": 95,
                "abbreviation": "clt",
                "name": "collectibles - by owner"
            },
            {
                "id": 96,
                "abbreviation": "ele",
                "name": "electronics - by owner"
            },
            {
                "id": 97,
                "abbreviation": "hsh",
                "name": "household items - by owner"
            },
            {
                "id": 98,
                "abbreviation": "msg",
                "name": "musical instruments - by owner"
            },
            {
                "id": 101,
                "abbreviation": "zip",
                "name": "free stuff"
            },
            {
                "id": 107,
                "abbreviation": "bab",
                "name": "baby & kid stuff - by owner"
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
Get all sections with their categories — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14944/craigslist+api/39139/get+all+sections+with+their+categories' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Searches the postings of an area and returns them 120 per page: id, uuid, title, url, price, category, posting time, location with coordinates and images. Depending on the category a posting also carries bedrooms and square feet, odometer and monthly payment, compensation, company and job title, or event, open house and sale dates.
Endpoint ID: 39140
GET https://zylalabs.com/api/14944/craigslist+api/39140/search+postings+in+an+area
INPUT PARAMETERS

Search postings in an area — Endpoint Features

Object Description
area Required Area hostname (e.g. newyork), as returned by /general/areas
category Optional Section or category abbreviation (e.g. sss for everything for sale, apa for apartments, cta for cars and trucks, jjj for jobs), as returned by /general/categories and /search/category-counts. Defaults to sss.
query Optional Search term (e.g. iphone)
subarea Optional Subarea abbreviation to search one part of the area only (e.g. brk), as returned by /general/areas
sort Optional Order of the results: newest, oldest, price-asc, price-desc, relevance, distance or upcoming. Without it a search with a query is ordered by relevance and any other by newest.
min_price Optional Lowest price
max_price Optional Highest price
has_image Optional Set to true to return only postings with an image
posted_today Optional Set to true to return only postings from today
titles_only Optional Set to true to match the query against posting titles only
postal Optional Postal code to search around (e.g. 10001), together with search_distance
search_distance Optional Distance from the postal code, in the distance unit of the area (miles or kilometres), up to 1000
filters Optional Category filters as comma-separated name:value pairs (e.g. min_bedrooms:2,housing_type:1,housing_type:6). Repeat a name to pass several values. Use /search/filters to list the names and values of a category.
page Optional Page number, 120 postings per page (default 1)

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

area
category
query
subarea
sort
min_price
max_price
has_image
posted_today
titles_only
postal
search_distance
filters
page
API EXAMPLE RESPONSE
JSON
{
    "page": 1,
    "pageSize": 120,
    "totalResults": 92,
    "totalPages": 1,
    "sort": "newest",
    "currency": "USD",
    "postings": [
        {
            "id": 7991026251,
            "uuid": "nuaXtLtq35RqEkDhtaHYUC",
            "title": "New Apple iPhone 7 Black Unlocked Smartphone Mobile Cellphone Phone",
            "url": "https://newyork.craigslist.org/brk/ele/d/brooklyn-new-apple-iphone-black/7991026251.html",
            "price": 140,
            "priceText": "$140",
            "category": {
                "id": 96,
                "abbreviation": "ele",
                "name": "electronics - by owner"
            },
            "postedTimestamp": 1794770214,
            "location": {
                "area": "newyork",
                "subarea": "brk",
                "description": "Brooklyn",
                "neighborhood": null,
                "latitude": 40.6257,
                "longitude": -73.9564
            },
            "images": [
                "https://images.craigslist.org/00L0L_eoetfZCFWQ0_03D03D_600x450.jpg",
                "https://images.craigslist.org/01212_aBurytUVmqT_03X03j_600x450.jpg"
            ]
        },
        {
            "id": 7984399287,
            "uuid": "rTjaZzWLEpBC1NEkmq2u1n",
            "title": "New Apple iPhone 5C Pink Unlocked Smartphone Mobile Cellphone Phone",
            "url": "https://newyork.craigslist.org/brk/mob/d/brooklyn-new-apple-iphone-5c-pink/7984399287.html",
            "price": 100,
            "priceText": "$100",
            "category": {
                "id": 153,
                "abbreviation": "mob",
                "name": "cell phones - by owner"
            },
            "postedTimestamp": 1794770203,
            "location": {
                "area": "newyork",
                "subarea": "brk",
                "description": "Brooklyn",
                "neighborhood": null,
                "latitude": 40.6257,
                "longitude": -73.9564
            },
            "images": [
                "https://images.craigslist.org/00q0q_iZyJKBJuxaC_042041_600x450.jpg",
                "https://images.craigslist.org/00X0X_12SuncYwqwc_03D03D_600x450.jpg",
                "https://images.craigslist.org/00d0d_7WD5FFi0aDl_04Q04Q_600x450.jpg"
            ]
        },
        {
            "id": 7966973025,
            "uuid": "ajQGMh3y7QNajqFJEBa9bG",
            "title": "MSRP $249 - Bowers & Wilkins Pi6 Wireless Earbuds with aptX Adaptive",
            "url": "https://newyork.craigslist.org/brk/ele/d/brooklyn-msrp-bowers-wilkins-pi6/7966973025.html",
            "price": 150,
            "priceText": "$150",
            "category": {
                "id": 96,
                "abbreviation": "ele",
                "name": "electronics - by owner"
            },
            "postedTimestamp": 1794765522,
            "location": {
                "area": "newyork",
                "subarea": "brk",
                "description": "Brooklyn",
                "neighborhood": null,
                "latitude": 40.6179,
                "longitude": -73.9856
            },
            "images": [
                "https://images.craigslist.org/00404_9xbrCljqO2N_08406B_600x450.jpg",
                "https://images.craigslist.org/00303_lJmi3NbVGyC_0ew0b5_600x450.jpg",
                "https://images.craigslist.org/00J0J_jOkBqBe023P_0pV0j8_600x450.jpg",
                "https://images.craigslist.org/00A0A_hUgnyCClDB7_09N09G_600x450.jpg",
                "https://images.craigslist.org/00m0m_gDOLRnZVxer_0qJ0lM_600x450.jpg",
                "https://images.craigslist.org/01111_eOyIpDTRWQ1_08406K_600x450.jpg",
                "https://images.craigslist.org/00606_flnUCptQpkF_0nn0lj_600x450.jpg",
                "https://images.craigslist.org/00606_aFyxndIwAKw_0gm0db_600x450.jpg",
                "https://images.craigslist.org/00j0j_1kHAmrMhLku_0m30fk_600x450.jpg",
                "https://images.craigslist.org/00r0r_bzISh7Gqn4w_0qd0gd_600x450.jpg",
                "https://images.craigslist.org/00d0d_jBRHnxC7dMD_0kT0ln_600x450.jpg",
                "https://images.craigslist.org/00f0f_zP0dcCdi8T_0oc0oc_600x450.jpg",
                "https://images.craigslist.org/00a0a_a6Eua4eNc8P_0oc0oc_600x450.jpg",
                "https://images.craigslist.org/00x0x_79Tg2XS31Sd_0oc0oc_600x450.jpg",
                "https://images.craigslist.org/00C0C_5ZWLcFymIcT_0mn0le_600x450.jpg",
                "https://images.craigslist.org/00y0y_i7G7epsyNAM_0oc0oc_600x450.jpg",
                "https://images.craigslist.org/00A0A_77Kbj6itJV0_0oc0oc_600x450.jpg",
                "https://images.craigslist.org/00o0o_h9Q3lyxiIoD_0he09G_600x450.jpg",
                "https://images.craigslist.org/00G0G_gXgM4o4W1o9_0bl09G_600x450.jpg",
                "https://images.craigslist.org/00000_cXybp9XlesM_0c109G_600x450.jpg",
                "https://images.craigslist.org/00R0R_kpEJidRFW4v_0aB09G_600x450.jpg",
                "https://images.craigslist.org/00s0s_1SKGuGR5E74_0bO09G_600x450.jpg"
            ]
        },
        {
            "id": 7966920420,
            "uuid": "km6Nb2bcH5VtfBJWSXQdzH",
            "title": "MSRP $249 - Bowers & Wilkins Pi6 Wireless Earbuds with aptX Adaptive",
            "url": "https://newyork.craigslist.org/brk/ele/d/brooklyn-msrp-bowers-wilkins-pi6/7966920420.html",
            "price": 150,
            "priceText": "$150",
            "category": {
                "id": 96,
                "abbreviation": "ele",
                "name": "electronics - by owner"
            },
            "postedTimestamp": 1794765521,
            "location": {
                "area": "newyork",
                "subarea": "brk",
                "description": "Brooklyn",
                "neighborhood": null,
                "latitude": 40.6179,
                "longitude": -73.9856
            },
            "images": [
                "https://images.craigslist.org/00303_lJmi3NbVGyC_0ew0b5_600x450.jpg",
                "https://images.craigslist.org/00a0a_kTUQzsJmJ0h_0oc0ix_600x450.jpg",
                "https://images.craigslist.org/00J0J_jOkBqBe023P_0pV0j8_600x450.jpg",
                "https://images.craigslist.org/00m0m_gDOLRnZVxer_0qJ0lM_600x450.jpg",
                "https://images.craigslist.org/00606_aFyxndIwAKw_0gm0db_600x450.jpg",
                "https://images.craigslist.org/00j0j_1kHAmrMhLku_0m30fk_600x450.jpg",
                "https://images.craigslist.org/00r0r_bzISh7Gqn4w_0qd0gd_600x450.jpg",
                "https://images.craigslist.org/00d0d_jBRHnxC7dMD_0kT0ln_600x450.jpg",
                "https://images.craigslist.org/00f0f_zP0dcCdi8T_0oc0oc_600x450.jpg",
                "https://images.craigslist.org/00a0a_a6Eua4eNc8P_0oc0oc_600x450.jpg",
                "https://images.craigslist.org/00x0x_79Tg2XS31Sd_0oc0oc_600x450.jpg",
                "https://images.craigslist.org/00C0C_5ZWLcFymIcT_0mn0le_600x450.jpg",
                "https://images.craigslist.org/00y0y_i7G7epsyNAM_0oc0oc_600x450.jpg",
                "https://images.craigslist.org/00A0A_77Kbj6itJV0_0oc0oc_600x450.jpg",
                "https://images.craigslist.org/00o0o_h9Q3lyxiIoD_0he09G_600x450.jpg",
                "https://images.craigslist.org/00G0G_gXgM4o4W1o9_0bl09G_600x450.jpg",
                "https://images.craigslist.org/00000_cXybp9XlesM_0c109G_600x450.jpg",
                "https://images.craigslist.org/00R0R_kpEJidRFW4v_0aB09G_600x450.jpg",
                "https://images.craigslist.org/00s0s_1SKGuGR5E74_0bO09G_600x450.jpg"
            ]
        },
        {
            "id": 7966727166,
            "uuid": "vEfJEqXHCCx9RXkpE3Nrwb",
            "title": "Sonos One SL Smart Connected Speaker, WiFi-Enabled, Stereo Sound, BLK",
            "url": "https://newyork.craigslist.org/brk/hsh/d/brooklyn-sonos-one-sl-smart-connected/7966727166.html",
            "price": 149,
            "priceText": "$149",
            "category": {
                "id": 97,
                "abbreviation": "hsh",
                "name": "household items - by owner"
            },
            "postedTimestamp": 1794765509,
            "location": {
                "area": "newyork",
                "subarea": "brk",
                "description": "Brooklyn",
                "neighborhood": null,
                "latitude": 40.6179,
                "longitude": -73.9856
            },
            "images": [
                "https://images.craigslist.org/00V0V_8hRpsmzp3k2_0gN0n0_600x450.jpg",
                "https://images.craigslist.org/00H0H_b0bl7jj8kqj_0h00is_600x450.jpg",
                "https://images.craigslist.org/00e0e_jAML8GY5WIf_0dl0in_600x450.jpg",
                "https://images.craigslist.org/00F0F_eOBXdfiFjtD_0iq0it_600x450.jpg",
                "https://images.craigslist.org/00T0T_edriJkamzom_0iJ0jT_600x450.jpg",
                "https://images.craigslist.org/00N0N_29OaavG2R96_0jm0jm_600x450.jpg",
                "https://images.craigslist.org/00p0p_iTLPZI9HaGv_0oc0oc_600x450.jpg"
            ]
        },
        {
            "id": 7965977562,
            "uuid": "2xaopG4yUT7aew3GWPsT89",
            "title": "MSRP $249 - Bowers & Wilkins Pi6 Wireless Earbuds with aptX Adaptive",
            "url": "https://newyork.craigslist.org/brk/ele/d/brooklyn-msrp-bowers-wilkins-pi6/7965977562.html",
            "price": 150,
            "priceText": "$150",
            "category": {
                "id": 96,
                "abbreviation": "ele"
            }
        }
    ],
    "_note": "Response truncated for documentation purposes"
}
Search postings in an area — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14944/craigslist+api/39140/search+postings+in+an+area?area=newyork&category=sss&query=iphone&subarea=brk&sort=newest&min_price=100&max_price=1000&has_image=false&posted_today=false&titles_only=false&postal=10001&search_distance=10&filters=condition:10&page=1' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns one classified posting in full with its title price category time description location attributes and images.
Endpoint ID: 39141
GET https://zylalabs.com/api/14944/craigslist+api/39141/get+the+details+of+a+posting
INPUT PARAMETERS

Get the details of a posting — Endpoint Features

Object Description
posting_uuid Required Posting uuid, as returned by the posting search

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

posting_uuid
API EXAMPLE RESPONSE
JSON
{
    "id": 8001121092,
    "uuid": "rfuQVnvudem5UTzNxACeUw",
    "title": "2002 Mercedes e320 4matic wagon",
    "url": "https://www.craigslist.org/view/d/brooklyn-2002-mercedes-e320-4matic-wagon/rfuQVnvudem5UTzNxACeUw",
    "price": 13000,
    "priceText": "$13,000",
    "section": "for sale",
    "category": {
        "id": 145,
        "abbreviation": "cto",
        "name": "cars & trucks - by owner"
    },
    "postedTimestamp": 1794771098,
    "updatedTimestamp": 1794771098,
    "repostOf": 7997265462,
    "company": null,
    "hasContactInfo": true,
    "description": "2002 e320 4matic wagon. 85,000 miles. All servicing done on time. Seats 7. No rust. Custom roof rack. Coco mats. 3 keys. No rust. \n\nLast 3 years:\nFront struts\nRear shocks\nAccumulators \nAccelerator pedal sensor\nBrake light switch \nWater pump\nThermostat\nTransmission filter kit\nTires April 2025",
    "descriptionHtml": "2002 e320 4matic wagon. 85,000 miles. All servicing done on time. Seats 7. No rust. Custom roof rack. Coco mats. 3 keys. No rust. <br>\n<br>\nLast 3 years:<br>\nFront struts<br>\nRear shocks<br>\nAccumulators <br>\nAccelerator pedal sensor<br>\nBrake light switch <br>\nWater pump<br>\nThermostat<br>\nTransmission filter kit<br>\nTires April 2025<br>\n",
    "location": {
        "area": "newyork",
        "areaName": "new york",
        "subarea": "brk",
        "subareaName": "brooklyn",
        "description": "Brooklyn",
        "neighborhood": null,
        "address": null,
        "latitude": 40.6732,
        "longitude": -73.9571
    },
    "attributes": [
        {
            "key": "auto_make_model",
            "label": "make/model",
            "value": "mercedes-benz e-class"
        },
        {
            "key": "auto_year",
            "label": "year",
            "value": "2002"
        },
        {
            "key": "condition",
            "label": "condition",
            "value": "excellent"
        },
        {
            "key": "auto_cylinders",
            "label": "cylinders",
            "value": "6 cylinders"
        },
        {
            "key": "auto_drivetrain",
            "label": "drive",
            "value": "4wd"
        },
        {
            "key": "auto_fuel_type",
            "label": "fuel",
            "value": "gas"
        },
        {
            "key": "auto_miles",
            "label": "odometer",
            "value": "85,000"
        },
        {
            "key": "auto_paint",
            "label": "paint color",
            "value": "black"
        },
        {
            "key": "auto_title_status",
            "label": "title status",
            "value": "clean"
        },
        {
            "key": "auto_transmission",
            "label": "transmission",
            "value": "automatic"
        },
        {
            "key": "auto_bodytype",
            "label": "type",
            "value": "wagon"
        }
    ],
    "images": [
        "https://images.craigslist.org/00A0A_3JzYjLZRedZ_0t30CI_1200x900.jpg",
        "https://images.craigslist.org/00g0g_3DJIp10vQah_0CI0t3_1200x900.jpg",
        "https://images.craigslist.org/00101_h9qlaOGkRZ9_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00z0z_7ppf1AyEPZ4_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00J0J_3OcjMaYKDwc_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00M0M_jR9Kdxduu1_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00E0E_lRxkfEAZl6L_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00N0N_hbtsiGoa3va_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00404_fuVuvcuKtK8_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00b0b_5tpNIokARHS_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/01111_8pDqr6fmO1H_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00z0z_ilTSUZcTecM_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00s0s_9jaKupkWNpG_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00e0e_gQhIfLO2TdW_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00707_dMe5ru6InXw_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00l0l_aMi9EubHByE_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00B0B_iTw97olJmgR_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00X0X_6fD1ILdjxnK_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00q0q_d6pc0Jt29SO_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00h0h_4t1IOHUVhHX_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00M0M_dxrh3gmlHtd_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00303_bu2y3mSW3rd_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00202_4KbEyRMsZcd_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/01717_jf76F2ScCo4_0t20CI_1200x900.jpg"
    ]
}
Get the details of a posting — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14944/craigslist+api/39141/get+the+details+of+a+posting?posting_uuid=rfuQVnvudem5UTzNxACeUw' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns one posting in full, looked up by its Craigslist address instead of its uuid. The response is the same as the one of /posting/details.
Endpoint ID: 39142
GET https://zylalabs.com/api/14944/craigslist+api/39142/get+the+details+of+a+posting+by+its+url
INPUT PARAMETERS

Get the details of a posting by its url — Endpoint Features

Object Description
url Required Address of the posting on Craigslist

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

url
API EXAMPLE RESPONSE
JSON
{
    "id": 8001121092,
    "uuid": "rfuQVnvudem5UTzNxACeUw",
    "title": "2002 Mercedes e320 4matic wagon",
    "url": "https://www.craigslist.org/view/d/brooklyn-2002-mercedes-e320-4matic-wagon/rfuQVnvudem5UTzNxACeUw",
    "price": 13000,
    "priceText": "$13,000",
    "section": "for sale",
    "category": {
        "id": 145,
        "abbreviation": "cto",
        "name": "cars & trucks - by owner"
    },
    "postedTimestamp": 1794771098,
    "updatedTimestamp": 1794771098,
    "repostOf": 7997265462,
    "company": null,
    "hasContactInfo": true,
    "description": "2002 e320 4matic wagon. 85,000 miles. All servicing done on time. Seats 7. No rust. Custom roof rack. Coco mats. 3 keys. No rust. \n\nLast 3 years:\nFront struts\nRear shocks\nAccumulators \nAccelerator pedal sensor\nBrake light switch \nWater pump\nThermostat\nTransmission filter kit\nTires April 2025",
    "descriptionHtml": "2002 e320 4matic wagon. 85,000 miles. All servicing done on time. Seats 7. No rust. Custom roof rack. Coco mats. 3 keys. No rust. <br>\n<br>\nLast 3 years:<br>\nFront struts<br>\nRear shocks<br>\nAccumulators <br>\nAccelerator pedal sensor<br>\nBrake light switch <br>\nWater pump<br>\nThermostat<br>\nTransmission filter kit<br>\nTires April 2025<br>\n",
    "location": {
        "area": "newyork",
        "areaName": "new york",
        "subarea": "brk",
        "subareaName": "brooklyn",
        "description": "Brooklyn",
        "neighborhood": null,
        "address": null,
        "latitude": 40.6732,
        "longitude": -73.9571
    },
    "attributes": [
        {
            "key": "auto_make_model",
            "label": "make/model",
            "value": "mercedes-benz e-class"
        },
        {
            "key": "auto_year",
            "label": "year",
            "value": "2002"
        },
        {
            "key": "condition",
            "label": "condition",
            "value": "excellent"
        },
        {
            "key": "auto_cylinders",
            "label": "cylinders",
            "value": "6 cylinders"
        },
        {
            "key": "auto_drivetrain",
            "label": "drive",
            "value": "4wd"
        },
        {
            "key": "auto_fuel_type",
            "label": "fuel",
            "value": "gas"
        },
        {
            "key": "auto_miles",
            "label": "odometer",
            "value": "85,000"
        },
        {
            "key": "auto_paint",
            "label": "paint color",
            "value": "black"
        },
        {
            "key": "auto_title_status",
            "label": "title status",
            "value": "clean"
        },
        {
            "key": "auto_transmission",
            "label": "transmission",
            "value": "automatic"
        },
        {
            "key": "auto_bodytype",
            "label": "type",
            "value": "wagon"
        }
    ],
    "images": [
        "https://images.craigslist.org/00A0A_3JzYjLZRedZ_0t30CI_1200x900.jpg",
        "https://images.craigslist.org/00g0g_3DJIp10vQah_0CI0t3_1200x900.jpg",
        "https://images.craigslist.org/00101_h9qlaOGkRZ9_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00z0z_7ppf1AyEPZ4_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00J0J_3OcjMaYKDwc_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00M0M_jR9Kdxduu1_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00E0E_lRxkfEAZl6L_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00N0N_hbtsiGoa3va_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00404_fuVuvcuKtK8_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00b0b_5tpNIokARHS_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/01111_8pDqr6fmO1H_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00z0z_ilTSUZcTecM_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00s0s_9jaKupkWNpG_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00e0e_gQhIfLO2TdW_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00707_dMe5ru6InXw_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00l0l_aMi9EubHByE_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00B0B_iTw97olJmgR_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00X0X_6fD1ILdjxnK_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00q0q_d6pc0Jt29SO_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00h0h_4t1IOHUVhHX_0t20CI_1200x900.jpg",
        "https://images.craigslist.org/00M0M_dxrh3gmlHtd_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00303_bu2y3mSW3rd_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/00202_4KbEyRMsZcd_0CI0t2_1200x900.jpg",
        "https://images.craigslist.org/01717_jf76F2ScCo4_0t20CI_1200x900.jpg"
    ]
}
Get the details of a posting by its url — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14944/craigslist+api/39142/get+the+details+of+a+posting+by+its+url?url=https://newyork.craigslist.org/brk/cto/d/brooklyn-2002-mercedes-e320-4matic-wagon/8001121092.html' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the search terms Craigslist suggests for the beginning of a query. With the make-model type it suggests vehicle makes and models instead, which is what the auto_make_model filter takes.
Endpoint ID: 39143
GET https://zylalabs.com/api/14944/craigslist+api/39143/get+suggestions+for+a+search+term
INPUT PARAMETERS

Get suggestions for a search term — Endpoint Features

Object Description
query Required Beginning of the search term (e.g. iph)
type Optional What to suggest: search for search terms (default) or make-model for vehicle makes and models

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

query
type
API EXAMPLE RESPONSE
JSON
[
    "iphone",
    "epiphone",
    "iphone buyer",
    "iphone 16",
    "iphone 15",
    "iphone 14",
    "iphone 13",
    "iphone 12",
    "iphone 11",
    "iphone 16 pro max",
    "iphones",
    "iphone 14 pro max"
]
Get suggestions for a search term — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14944/craigslist+api/39143/get+suggestions+for+a+search+term?query=iph&type=search' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns how many postings match a search term in an area, per section and per category. The abbreviations are the ones /posting/search takes as its category.
Endpoint ID: 39144
GET https://zylalabs.com/api/14944/craigslist+api/39144/get+the+number+of+results+per+category
INPUT PARAMETERS

Get the number of results per category — Endpoint Features

Object Description
area Required Area hostname (e.g. newyork), as returned by /general/areas
query Required Search term (e.g. iphone)

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

area
query
API EXAMPLE RESPONSE
JSON
[
    {
        "abbreviation": "ccc",
        "name": "community",
        "count": 2,
        "categories": [
            {
                "abbreviation": "laf",
                "name": "lost & found",
                "count": 2
            }
        ]
    },
    {
        "abbreviation": "hhh",
        "name": "housing",
        "count": 3,
        "categories": [
            {
                "abbreviation": "sha",
                "name": "wanted: room/share",
                "count": 1
            },
            {
                "abbreviation": "sub",
                "name": "sublets & temporary",
                "count": 2
            }
        ]
    },
    {
        "abbreviation": "jjj",
        "name": "jobs",
        "count": 55,
        "categories": [
            {
                "abbreviation": "mar",
                "name": "marketing/advertising/pr",
                "count": 1
            },
            {
                "abbreviation": "tfr",
                "name": "tv/film/video/radio",
                "count": 1
            },
            {
                "abbreviation": "med",
                "name": "art/media/design",
                "count": 2
            },
            {
                "abbreviation": "fbh",
                "name": "food/beverage/hospitality",
                "count": 2
            },
            {
                "abbreviation": "lab",
                "name": "general labor",
                "count": 1
            },
            {
                "abbreviation": "tch",
                "name": "technical support",
                "count": 2
            },
            {
                "abbreviation": "etc",
                "name": "et cetera",
                "count": 2
            },
            {
                "abbreviation": "trp",
                "name": "transportation",
                "count": 43
            },
            {
                "abbreviation": "csr",
                "name": "customer service",
                "count": 1
            }
        ]
    },
    {
        "abbreviation": "bbb",
        "name": "services",
        "count": 72,
        "categories": [
            {
                "abbreviation": "fns",
                "name": "financial services",
                "count": 1
            },
            {
                "abbreviation": "crs",
                "name": "creative services",
                "count": 5
            },
            {
                "abbreviation": "cms",
                "name": "cell phone / mobile services",
                "count": 9
            },
            {
                "abbreviation": "cps",
                "name": "computer services",
                "count": 49
            },
            {
                "abbreviation": "biz",
                "name": "small biz ads",
                "count": 7
            },
            {
                "abbreviation": "aos",
                "name": "automotive services",
                "count": 1
            }
        ]
    },
    {
        "abbreviation": "sss",
        "name": "for sale",
        "count": 1215,
        "categories": [
            {
                "abbreviation": "ppa",
                "name": "appliances",
                "count": 5
            },
            {
                "abbreviation": "ata",
                "name": "antiques",
                "count": 2
            },
            {
                "abbreviation": "foa",
                "name": "general for sale",
                "count": 26
            },
            {
                "abbreviation": "gra",
                "name": "farm & garden",
                "count": 3
            },
            {
                "abbreviation": "bka",
                "name": "books & magazines",
                "count": 1
            },
            {
                "abbreviation": "vga",
                "name": "video gaming",
                "count": 2
            },
            {
                "abbreviation": "cla",
                "name": "clothing & accessories",
                "count": 39
            },
            {
                "abbreviation": "ema",
                "name": "cds / dvds / vhs",
                "count": 1
            },
            {
                "abbreviation": "hsa",
                "name": "household items",
                "count": 63
            },
            {
                "abbreviation": "ela",
                "name": "electronics",
                "count": 368
            },
            {
                "abbreviation": "jwa",
                "name": "jewelry",
                "count": 3
            },
            {
                "abbreviation": "pha",
                "name": "photo/video",
                "count": 6
            },
            {
                "abbreviation": "waa",
                "name": "wanted",
                "count": 36
            },
            {
                "abbreviation": "wta",
                "name": "auto wheels & tires",
                "count": 1
            },
            {
                "abbreviation": "fua",
                "name": "furniture",
                "count": 3
            },
            {
                "abbreviation": "baa",
                "name": "baby & kid stuff",
                "count": 1
            },
            {
                "abbreviation": "mca",
                "name": "motorcycles/scooters",
                "count": 1
            },
            {
                "abbreviation": "cta",
                "name": "cars & trucks",
                "count": 118
            },
            {
                "abbreviation": "sya",
                "name": "computers",
                "count": 10
            },
            {
                "abbreviation": "bia",
                "name": "bicycles",
                "count": 3
            },
            {
                "abbreviation": "sga",
                "name": "sporting goods",
                "count": 1
            },
            {
                "abbreviation": "moa",
                "name": "cell phones",
                "count": 490
            },
            {
                "abbreviation": "bfa",
                "name": "business",
                "count": 10
            },
            {
                "abbreviation": "ara",
                "name": "arts & crafts",
                "count": 8
            },
            {
                "abbreviation": "tla",
                "name": "tools",
                "count": 1
            },
            {
                "abbreviation": "cba",
                "name": "collectibles",
                "count": 2
            },
            {
                "abbreviation": "msa",
                "name": "musical instruments",
                "count": 6
            },
            {
                "abbreviation": "syp",
                "name": "computer parts",
                "count": 3
            },
            {
                "abbreviation": "mpa",
                "name": "motorcycle parts & accessories",
                "count": 1
            },
            {
                "abbreviation": "haa",
                "name": "health and beauty",
                "count": 1
            }
        ]
    },
    {
        "abbreviation": "ggg",
        "name": "gigs",
        "count": 42,
        "categories": [
            {
                "abbreviation": "lbg",
                "name": "labor gigs",
                "count": 21
            },
            {
                "abbreviation": "cpg",
                "name": "computer gigs",
                "count": 1
            },
            {
                "abbreviation": "cwg",
                "name": "crew gigs",
                "count": 5
            },
            {
                "abbreviation": "crg",
                "name": "creative gigs",
                "count": 2
            },
            {
                "abbreviation": "evg",
                "name": "event gigs",
                "count": 2
            },
            {
                "abbreviation": "tlg",
                "name": "talent gigs",
                "count": 2
            },
            {
                "abbreviation": "dmg",
                "name": "domestic gigs",
                "count": 9
            }
        ]
    }
]
Get the number of results per category — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14944/craigslist+api/39144/get+the+number+of+results+per+category?area=newyork&query=iphone' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the filters a section or category can be searched by: name, label, type (boolean, number, select, multi or text) and the accepted values. They go into the filters parameter of /posting/search as name:value pairs.
Endpoint ID: 39145
GET https://zylalabs.com/api/14944/craigslist+api/39145/get+the+filters+of+a+category
INPUT PARAMETERS

Get the filters of a category — Endpoint Features

Object Description
category Required Section or category abbreviation (e.g. apa for apartments, cta for cars and trucks), as returned by /general/categories

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

category
API EXAMPLE RESPONSE
JSON
[
    {
        "name": "min_bedrooms",
        "label": "min bedrooms",
        "type": "number",
        "options": []
    },
    {
        "name": "max_bedrooms",
        "label": "max bedrooms",
        "type": "number",
        "options": []
    },
    {
        "name": "min_bathrooms",
        "label": "min bathrooms",
        "type": "number",
        "options": []
    },
    {
        "name": "max_bathrooms",
        "label": "max bathrooms",
        "type": "number",
        "options": []
    },
    {
        "name": "minSqft",
        "label": "min sq ft",
        "type": "number",
        "options": []
    },
    {
        "name": "maxSqft",
        "label": "max sq ft",
        "type": "number",
        "options": []
    },
    {
        "name": "pets_cat",
        "label": "cats ok",
        "type": "boolean",
        "options": [
            {
                "value": "1",
                "label": "cats ok"
            }
        ]
    },
    {
        "name": "pets_dog",
        "label": "dogs ok",
        "type": "boolean",
        "options": [
            {
                "value": "1",
                "label": "dogs ok"
            }
        ]
    },
    {
        "name": "is_furnished",
        "label": "furnished",
        "type": "boolean",
        "options": [
            {
                "value": "1",
                "label": "furnished"
            }
        ]
    },
    {
        "name": "no_smoking",
        "label": "no smoking",
        "type": "boolean",
        "options": [
            {
                "value": "1",
                "label": "no smoking"
            }
        ]
    },
    {
        "name": "wheelchaccess",
        "label": "wheelchair accessible",
        "type": "boolean",
        "options": [
            {
                "value": "1",
                "label": "wheelchair accessible"
            }
        ]
    },
    {
        "name": "airconditioning",
        "label": "air conditioning",
        "type": "boolean",
        "options": [
            {
                "value": "1",
                "label": "air conditioning"
            }
        ]
    },
    {
        "name": "ev_charging",
        "label": "EV charging",
        "type": "boolean",
        "options": [
            {
                "value": "1",
                "label": "EV charging"
            }
        ]
    },
    {
        "name": "broker_fee",
        "label": "no broker fee",
        "type": "boolean",
        "options": [
            {
                "value": "1",
                "label": "no broker fee"
            }
        ]
    },
    {
        "name": "application_fee",
        "label": "no application fee",
        "type": "boolean",
        "options": [
            {
                "value": "1",
                "label": "no application fee"
            }
        ]
    },
    {
        "name": "rent_period",
        "label": "rent period",
        "type": "multi",
        "options": [
            {
                "value": "1",
                "label": "daily"
            },
            {
                "value": "2",
                "label": "weekly"
            },
            {
                "value": "3",
                "label": "monthly"
            }
        ]
    },
    {
        "name": "availabilityMode",
        "label": "availability",
        "type": "select",
        "options": [
            {
                "value": "1",
                "label": "within 30 days"
            },
            {
                "value": "2",
                "label": "beyond 30 days"
            }
        ]
    },
    {
        "name": "housing_type",
        "label": "housing type",
        "type": "multi",
        "options": [
            {
                "value": "1",
                "label": "apartment"
            },
            {
                "value": "2",
                "label": "condo"
            },
            {
                "value": "3",
                "label": "cottage/cabin"
            },
            {
                "value": "4",
                "label": "duplex"
            },
            {
                "value": "5",
                "label": "flat"
            },
            {
                "value": "6",
                "label": "house"
            },
            {
                "value": "7",
                "label": "in-law"
            },
            {
                "value": "8",
                "label": "loft"
            },
            {
                "value": "9",
                "label": "townhouse"
            },
            {
                "value": "10",
                "label": "manufactured"
            },
            {
                "value": "11",
                "label": "assisted living"
            },
            {
                "value": "12",
                "label": "land"
            }
        ]
    },
    {
        "name": "laundry",
        "label": "laundry",
        "type": "multi",
        "options": [
            {
                "value": "1",
                "label": "w/d in unit"
            },
            {
                "value": "4",
                "label": "w/d hookups"
            },
            {
                "value": "2",
                "label": "laundry in bldg"
            },
            {
                "value": "3",
                "label": "laundry on site"
            },
            {
                "value": "5",
                "label": "no laundry on site"
            }
        ]
    },
    {
        "name": "parking",
        "label": "parking",
        "type": "multi",
        "options": [
            {
                "value": "1",
                "label": "carport"
            },
            {
                "value": "2",
                "label": "attached garage"
            },
            {
                "value": "3",
                "label": "detached garage"
            },
            {
                "value": "4",
                "label": "off-street parking"
            },
            {
                "value": "5",
                "label": "street parking"
            },
            {
                "value": "6",
                "label": "valet parking"
            },
            {
                "value": "7",
                "label": "no parking"
            }
        ]
    }
]
Get the filters of a category — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/14944/craigslist+api/39145/get+the+filters+of+a+category?category=apa' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API Access Key & Authentication

After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Craigslist API simply include your bearer token in the Authorization header.

Headers
Header Description
Authorization Required Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.

No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.

(Save 2 months with annual billing 🎉)

Starts at
$10,000/Year


  • Custom Volume
  • Custom Rate Limit
  • Specialized Customer Support
  • Real-Time API Monitoring

Overview

Classified postings in every section: for sale, housing, jobs, gigs, services, community, events and resumes, with area, price and category filters, full posting details, areas and category counts.

Craigslist API FAQs

The Craigslist API provides access to classified postings across all major sections, including for sale, housing, jobs, gigs, services, community, events, and resumes.

The API supports filtering classified postings by area, price, and category, allowing users to narrow down search results to specific locations, price ranges, and types of listings.

Full posting details include the title, description, price where it applies, location with address and coordinates, images, and every category attribute such as condition, make, model, odometer, bedrooms or compensation.

Yes, the Craigslist API can provide counts of available postings, allowing users to gauge the volume of listings within particular geographic areas and categories.

Practical use cases include building custom real estate search applications, job boards aggregating listings, price comparison tools for items, event discovery platforms, and services marketplaces.

By providing access to categorized and filtered listings, along with counts, the API enables analysis of popular items, job markets, housing availability, and service demands in specific regions.

The core value proposition lies in its ability to programmatically access a vast and diverse dataset of classified advertisements, enabling the creation of specialized applications, data analysis, and automation of tasks related to local commerce and services.

General FAQs

To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.

You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.

The free trial lasts for 7 days and allows you to make up to 50 API requests.

No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.

Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.

Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.

Prices are listed in USD (United States Dollar), EUR (Euro), CAD (Canadian Dollar), AUD (Australian Dollar), and GBP (British Pound). We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the world's most reliable payment companies. If you have any trouble paying by card, just contact us at [email protected]

Additionally, if you already have an active subscription in any of these currencies (USD, EUR, CAD, AUD, GBP), that currency will remain for subsequent subscriptions. You can change the currency at any time as long as you don't have any active subscriptions.
The local currency shown on the pricing page is based on the country of your IP address and is provided for reference only. The actual prices are in USD (United States Dollar). When you make a payment, the charge will appear on your card statement in USD, even if you see the equivalent amount in your local currency on our website. This means you cannot pay directly with your local currency.
Occasionally, a bank may decline the charge due to its fraud protection settings. We suggest reaching out to your bank initially to check if they are blocking our charges. Also, you can access the Billing Portal and change the card associated to make the payment. If these does not work and you need further assistance, please contact our team at [email protected]
Prices are determined by a recurring monthly or yearly subscription, depending on the chosen plan.
API calls are deducted from your plan based on successful requests. Each plan comes with a specific number of calls that you can make per month. Only successful calls, indicated by a Status 200 response, will be counted against your total. This ensures that failed or incomplete requests do not impact your monthly quota.
Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.
To upgrade your current subscription plan, simply go to the pricing page of the API and select the plan you want to upgrade to. The upgrade will be instant, allowing you to immediately enjoy the features of the new plan. Please note that any remaining calls from your previous plan will not be carried over to the new plan, so be aware of this when upgrading. You will be charged the full amount of the new plan.
To check how many API calls you have left for the current month, refer to the 'X-Zyla-API-Calls-Monthly-Remaining' field in the response header. For example, if your plan allows 1,000 requests per month and you've used 100, this field in the response header will indicate 900 remaining calls.

You can monitor your API usage through the response headers included with every request:

x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.

The 'X-Zyla-RateLimit-Reset' header shows the number of seconds until your rate limit resets. This tells you when your request count will start fresh. For example, if it displays 3,600, it means 3,600 seconds are left until the limit resets.

Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.

Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.

After 7 days, you will be charged the full amount for the plan you were subscribed to during the trial. Therefore, it's important to cancel before the trial period ends. Refund requests for forgetting to cancel on time are not accepted.
When you subscribe to an API free trial, you can make up to 50 API calls. If you wish to make additional API calls beyond this limit, the API will prompt you to perform an "Start Your Paid Plan." You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab.
You can contact us through our chat channel to receive immediate assistance. We are always online from 8 am to 5 pm (EST). If you reach us after that time, we will get back to you as soon as possible. Additionally, you can contact us via email at [email protected]

Please have a look at our Refund Policy: https://zylalabs.com/terms#refund