Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API Nextdoor Каталог

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Получите записи из каталога страницы Nextdoor, например районы на странице города. Для каждой записи указаны тип, территория, описание и число участников, если оно показано. Число участников может быть устаревшим. Список не даёт доступа к сообществам.

Nextdoor Directory читает публичные элементы каталога на одной странице Nextdoor по её полному url: странице города, района, компании или каталога. Каждая запись содержит name элемента, его тип в kind, краткое описание в description, район в area, к которому он относится, число участников, если оно предусмотрено для этого типа элемента, изображение и ссылку. Так можно узнать, на какие районы и местные объекты ведёт страница. Это нужно местным маркетологам, которые планируют кампании по районам, командам ритейла и франшиз, изучающим территорию, и исследователям, составляющим список сообществ в городе.

Естественная отправная точка — страница города, например https://nextdoor.com/city/san-francisco--ca/, а страницы районов и компаний могут давать лишь ограниченные данные: заголовки, описания и изображения. Используйте kind, чтобы разделить типы элементов перед подсчётом. member_count означает общее число участников сообщества. Возможность читает только публичные страницы: это не поиск личных профилей, и данные со страниц, требующих входа, не возвращаются.

Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Nextdoor Каталог (nextdoor/directory).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: nextdoor и action: directory, а параметры передайте в params.
- Обязательные параметры:
  - url: Полный URL публичной страницы города, района, компании или каталога в Nextdoor. Действие profile извлекает со страницы данные локального профиля, а действие directory — публичные записи каталога.
- Необязательные параметры:
  - limit: Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 25)
- Возвращает список записей. Основные поля каждой записи: name, url, kind, description, member_count, image_url, area.
- Пример тела запроса:
{
  "platform": "nextdoor",
  "action": "directory",
  "params": {
    "url": "https://nextdoor.com/city/san-francisco--ca/"
  }
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаnextdoorИдентификатор платформы, фиксированное значение.
actionbodystringДаdirectoryИдентификатор возможности, фиксированное значение.
urlbody.paramsstringДа-Полный URL публичной страницы города, района, компании или каталога в Nextdoor. Действие profile извлекает со страницы данные локального профиля, а действие directory — публичные записи каталога. Личные профили пользователей и приватные ленты, требующие авторизации, недоступны. Страницы районов и компаний могут содержать лишь ограниченные публичные данные, например заголовки, описания и фото.
limitbody.paramsinteger (1–50)Нет25Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств.

Примеры кода

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 (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Реальный ответ

Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

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

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
nameНазвание самого объекта для возможностей по аккаунтам, товарам и компаниям.
urlСсылка на запись на платформе.
kindТрактуется так же, как на самой платформе
descriptionКраткое содержание или описание, обычно короче text.
member_countТрактуется так же, как на самой платформе
image_urlСсылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls.
areaТрактуется так же, как на самой платформе
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

FAQ

Какие ссылки Nextdoor можно передать в url?

Полный URL публичной страницы города, района, организации или каталога Nextdoor, например https://nextdoor.com/city/san-francisco--ca/. Nextdoor Directory не ищет личные профили и не читает посты или ленты, доступные только после входа, поэтому ссылки на отдельных участников или закрытый контент не подходят.

Чем Directory отличается от Nextdoor Details?

Nextdoor Directory и Nextdoor Details принимают ссылки на страницы одних и тех же типов. Directory возвращает список элементов, на которые ведёт страница, по одной записи на элемент, а Details одной записью описывает район, представленный самой страницей. Используйте Directory, чтобы составить список районов или объектов, а Details — чтобы получить показатели одного района.

Почему страница возвращает мало элементов или не возвращает их вовсе?

Некоторые страницы Nextdoor, особенно страницы районов и организаций, содержат только заголовок, описание и изображения, поэтому элементов каталога может быть немного. Проверьте, что ссылка ведёт на публичную страницу одного из поддерживаемых типов. Вызов, не вернувший ни одной записи, не оплачивается, поэтому можно перейти на уровень выше, к странице города, и попробовать снова.

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

  • Nextdoor: публичный контент сообществ и границы видимости по районам ↗

    Nextdoor поясняет, что просматривать другие сообщества можно только в рамках контента с видимостью Anyone, а информация за пределами района остаётся под ограничениями конфиденциальности. То, что на публичном сайте можно просматривать сообщества и вступать в них, не означает, что этот API может читать закрытые публикации, полные имена, списки жителей или вступать в районы от имени пользователя.

    Проверено 2026-09-04