# Nextdoor Details API (nextdoor.profile)

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

## Health

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

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

## Response fields (items in `results`)

| field | meaning |
|---|---|
| name | Name of the object itself, for account, product and business capabilities. |
| page_type | platform-native meaning |
| url | Link to the record on the platform. |
| description | Summary or description, usually shorter than text. |
| tagline | platform-native meaning |
| state | platform-native meaning |
| country_code | platform-native meaning |
| lat | platform-native meaning |
| lng | platform-native meaning |
| residents_count | platform-native meaning |
| average_age | platform-native meaning |
| average_income | platform-native meaning |
| homeowner_pct | platform-native meaning |
| affordability_score | platform-native meaning |
| friendliness_score | platform-native meaning |
| neighborhood_count | platform-native meaning |
| business_directory_count | platform-native meaning |
| local_group_count | platform-native meaning |
| classifieds_count | platform-native meaning |
| events_count | platform-native meaning |
| safety_post_count | platform-native meaning |
| trending_post_count | platform-native meaning |
| photo_video_post_count | platform-native meaning |
| faq_count | platform-native meaning |
| faqs | platform-native meaning |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| access_status | 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": "profile",
  "params": {
    "url": "<公开 Nextdoor 城市、社区或商家完整 URL>"
  }
}'
```

```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": "profile",
        "params": {
            "url": "<公开 Nextdoor 城市、社区或商家完整 URL>",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

```text
{
  "id": "req_…",
  "platform": "nextdoor",
  "action": "profile",
  "results": {
    "name": …,
    "page_type": …,
    "url": …,
    "description": …,
    "tagline": …,
    "state": …,
    "country_code": …,
    "lat": …,
    "lng": …,
    "residents_count": …,
    "average_age": …,
    "average_income": …,
    "homeowner_pct": …,
    "affordability_score": …,
    "friendliness_score": …,
    "neighborhood_count": …,
    "business_directory_count": …,
    "local_group_count": …,
    "classifieds_count": …,
    "events_count": …,
    "safety_post_count": …,
    "trending_post_count": …,
    "photo_video_post_count": …,
    "faq_count": …,
    "faqs": …,
    "image_url": …,
    "access_status": …,
    "platform": …
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

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