# Nextdoor Directory API (nextdoor.directory)

- Canonical page: [https://everyinfra.com/en/nextdoor-api/directory](https://everyinfra.com/en/nextdoor-api/directory?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "nextdoor", "action": "directory", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 25, max 50 per call
- Mode: sync; add "mode": "async" for slow tasks

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.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=nextdoor&action=directory

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | 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. |
| limit | integer (1–50) | no | 25 | 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. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| name | Name of the object itself, for account, product and business capabilities. |
| url | Link to the record on the platform. |
| kind | platform-native meaning |
| description | Summary or description, usually shorter than text. |
| member_count | platform-native meaning |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| area | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```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/"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "nextdoor",
        "action": "directory",
        "params": {
            "url": "https://nextdoor.com/city/san-francisco--ca/",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 53. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "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": { … }
}
```

## 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.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=nextdoor
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
