POST

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

List the entries in the directory of a Nextdoor page, such as the neighborhoods under a city page. Each entry has kind, area, description and member count where shown. Member counts may be out of date. The listing grants no access to the communities.

Send POST https://api.everyinfra.com/api/v1/social with platform set to nextdoor and action set to directory. Price $1.39 per 1,000 requests ($0.001389 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.

Nextdoor Directory reads the public directory entries listed on one Nextdoor page, given its full url: a city, neighborhood, business or directory page. Each row carries the entry's name, its kind, a short description, the area it belongs to, a member count where one applies, an image and a link. It answers which neighborhoods and local entries a page leads to, for local marketers planning neighborhood campaigns, retail and franchise teams mapping an area, and researchers building a list of communities in a city.

A city page such as https://nextdoor.com/city/san-francisco--ca/ is a natural starting point, while neighborhood and business pages may offer only limited data, such as titles, descriptions and images. Use kind to separate entry types before you count them, and read member_count as a community's member total. Only public pages are read: this is not a lookup of personal profiles, and nothing behind sign-in is returned.

AI prompt

#
Please help me write a data collection script with the EveryInfra Nextdoor Directory endpoint (nextdoor/directory).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to nextdoor and action to directory, and put the parameters inside params.
- Required parameters:
  - url: Specifies the full URL of a public Nextdoor city, neighborhood, business, or directory page. The profile action parses local profile data from the page, while the directory action extracts public directory entries.
- Optional parameters:
  - limit: The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 25)
- Returns a list of records. Main fields of each record: name, url, kind, description, member_count, image_url, area.
- Example request body:
{
  "platform": "nextdoor",
  "action": "directory",
  "params": {
    "url": "https://nextdoor.com/city/san-francisco--ca/"
  }
}
- Price: $1.39 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesnextdoorPlatform identifier, fixed value.
actionbodystringYesdirectoryCapability identifier, fixed value.
urlbody.paramsstringYes-Specifies the full URL of a public Nextdoor city, neighborhood, business, or directory page. The profile action parses local profile data from the page, while the directory action extracts public directory entries. It does not query personal user profiles or fetch private feeds requiring authentication. Neighborhood and business pages may expose only limited public data such as titles, descriptions, and photos.
limitbody.paramsinteger (1–50)No25The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge.

Code samples

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "nextdoor",
  "action": "directory",
  "params": {
    "url": "https://nextdoor.com/city/san-francisco--ca/"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

Response example

#
Captured September 26, 2026 at 08:56 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "nextdoor",  "action": "directory",  "results": [    {      "name": "400 Alemany Blvd",      "url": "https://nextdoor.com/neighborhood/400alemanyblvd--san-francisco--ca/",      "kind": "neighborhood",      "area": "San Francisco",      "platform": "nextdoor"    },    {      "name": "4800 3rd Street",      "url": "https://nextdoor.com/neighborhood/4800thirdstreet--san-francisco--ca/",      "kind": "neighborhood",      "area": "San Francisco",      "platform": "nextdoor"    }  ],  "count": 53,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
nameName of the object itself, for account, product and business capabilities.
urlLink to the record on the platform.
kindKeeps the platform's own meaning
descriptionSummary or description, usually shorter than text.
member_countKeeps the platform's own meaning
image_urlImage link. Capabilities with several images may return an image_urls array.
areaKeeps the platform's own meaning
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

FAQ

#

Which Nextdoor links can I pass as url?

#

The full URL of a public Nextdoor city, neighborhood, business or directory page, for example https://nextdoor.com/city/san-francisco--ca/. Nextdoor Directory is not a personal profile lookup and does not read posts or feeds that require signing in, so links to individual members or private content are not the right input.

How is Directory different from Nextdoor Details?

#

Nextdoor Directory and Nextdoor Details take the same kind of page link. Directory lists the entries a page leads to, one row per entry, while the Details capability summarizes the area described by the page itself in a single record. Use Directory to build a list of neighborhoods or listings, and Details to read the figures for one area.

Why does a page return few or no entries?

#

Some Nextdoor pages, especially neighborhood and business pages, carry only a title, a description and images, so there may be few directory entries to list. Check that the link is a public page of one of the supported kinds. A call that returns no rows is not charged, so you can move up to the city page and try again.

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

Official references

#

Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.

  • Nextdoor: Public Community Content and Neighborhood Visibility Boundaries ↗

    Nextdoor clarifies that cross-community browsing relies on content scoped for Anyone, and information outside a neighborhood remains subject to privacy restrictions. Public website capabilities to browse or join communities do not mean this API can read private posts, full names, resident lists, or join neighborhoods on a user's behalf.

    Checked 2026-09-04

Google Analytics needs consent. Privacy