nvNeuralVerge
E-commerce & Marketplaces

Craigslist Areas Directory — Regional Sites, Aliases & Coordinates

This source returns the directory of Craigslist regional sites as data: for each area, its alias, area code, hostname, country, region, coordinates, timezone and sub-areas.

Example response
{
  "session_id": "11111111-1111-1111-1111-111111111111",
  "kind": "craigslist_areas",
  "country": null,
  "human": "# Craigslist areas\n\n- **Records returned:** 707\n- **Proxy traffic:** 31.4 KB",
  "machine": {
    "total_items": 707,
    "first_item": {
      "id": 1,
      "alias": "sfbay",
      "code": "sfo",
      "hostname": "sfbay.craigslist.org",
      "description": "SF bay area",
      "short_description": "SF bay area",
      "country": "US",
      "region": "CA",
      "lat": 37.5,
      "lon": -122.25,
      "timezone": "America/Los_Angeles",
      "web_url": "https://sfbay.craigslist.org",
      "subareas": [
        {
          "id": 1,
          "alias": "sfc",
          "description": "city of san francisco",
          "short_description": "san francisco"
        },
        {
          "id": 2,
          "alias": "sby",
          "description": "south bay area",
          "short_description": "south bay"
        }
      ]
    },
    "items": [
      {
        "id": 1,
        "alias": "sfbay",
        "code": "sfo",
        "hostname": "sfbay.craigslist.org",
        "description": "SF bay area",
        "short_description": "SF bay area",
        "country": "US",
        "region": "CA",
        "lat": 37.5,
        "lon": -122.25,
        "timezone": "America/Los_Angeles",
        "web_url": "https://sfbay.craigslist.org",
        "subareas": [
          {
            "id": 1,
            "alias": "sfc",
            "description": "city of san francisco",
            "short_description": "san francisco"
          },
          {
            "id": 2,
            "alias": "sby",
            "description": "south bay area",
            "short_description": "south bay"
          }
        ]
      },
      {
        "id": 2,
        "alias": "seattle",
        "code": "sea",
        "hostname": "seattle.craigslist.org",
        "description": "seattle-tacoma",
        "short_description": "seattle",
        "country": "US",
        "region": "WA",
        "lat": 47.6064,
        "lon": -122.331001,
        "timezone": "America/Los_Angeles",
        "web_url": "https://seattle.craigslist.org",
        "subareas": [
          {
            "id": 1,
            "alias": "see",
            "description": "seattle",
            "short_description": "seattle"
          },
          {
            "id": 2,
            "alias": "est",
            "description": "eastside",
            "short_description": "eastside"
          }
        ]
      }
    ],
    "proxy_traffic_bytes": 32189
  },
  "total_points": 5
}
You send
Nothing required — optionally a country
You get back
Regional sites with alias, area code, hostname, country, region, coordinates, timezone and sub-areas
Coverage
The Craigslist regional sites directory, with an optional country filter.
Price
5 points per run — $5 per 1,000
Flat 5 points per successful run, however many areas come back.
Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

ApproachWhat it takesCostTrade-off
Browsing Craigslist's site list by handClick through each country and region and note the subdomainsFree, and tediousEasy to miss sub-areas, and the aliases aren't always the obvious name
Maintaining your own listBuild and update a table of areasEngineering timeGoes stale when Craigslist adds or merges sites
NeuralVergeOne request, optionally filtered by country5 points flatReturns the directory as it stands at request time, with no history
Response

What you get back

Every field in the response shown above.

FieldTypeDescription
total_itemsnumberHow many areas were returned.
idnumberCraigslist's numeric area ID.
aliasstringArea alias, the value used for area in Craigslist postings search.
codestringArea code, e.g. sfo.
hostnamestringHostname of the regional site.
descriptionstringArea name.
short_descriptionstringShort area name.
countrystringCountry code, e.g. US.
regionstringRegion or state code, e.g. CA.
latnumberLatitude.
lonnumberLongitude.
timezonestringIANA timezone name.
web_urlstringAddress of the regional site.
subareasarraySub-areas, each with id, alias, description and short_description.
Integration

How to run it

The same lookup works from the app, the API, or as a tool an agent can call mid-task.

No required parameters; add "country": "US" to restrict the directory to one country. Use alias as area, and a sub-area's alias as subarea, in Craigslist postings search. The sample shows the first two areas of the directory.

curl -X POST https://api.neuralverge.ai/functions/v1/run-craigslist-areas \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Choosing search areas

Find the alias for each city or region you want to search.

Multi-region monitoring

Loop a postings search over every area in a country.

Geographic mapping

Use the coordinates and timezones to place areas on a map.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

The Craigslist regional sites directory, with an optional country filter.

Freshness

Read at request time.

Handling

This source returns the publicly visible list of Craigslist regional sites, stamped with a session id you can trace.

What it will not do
  • —Area and sub-area descriptions are Craigslist's own naming, which doesn't always match a city's official name.
  • —The directory reflects the sites that exist at request time; it doesn't show past changes.
FAQ

Questions, answered

Pass an area's alias as area, and a sub-area's alias as subarea, in Craigslist postings search.

Related

Related sources

Try craigslist areas on your own data

One request format across every source in the catalog.

Get started