API Nextdoor Directory

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: Normale

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Ultime 24 ore

Ultimi 30 giorni

Elenca le voci della directory di una pagina Nextdoor, ad esempio i quartieri sotto la pagina di una città. Ogni voce include tipo, area, descrizione e numero di membri, dove visibile. Il numero di membri può non essere aggiornato. L'elenco non dà accesso alle community.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su nextdoor e action impostato su directory. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.

Nextdoor Directory legge le voci pubbliche della directory presenti in una pagina Nextdoor, a partire dal suo url completo: una pagina di città, quartiere, attività o directory. Ogni riga riporta il name della voce, il suo kind, una breve description, l'area a cui appartiene, il numero di membri quando applicabile, un'immagine e un link. Ti dice a quali quartieri e voci locali rimanda una pagina. Serve ai marketer locali che pianificano campagne di quartiere, ai team retail e franchising che mappano una zona e ai ricercatori che costruiscono un elenco delle community di una città.

Una pagina di città come https://nextdoor.com/city/san-francisco--ca/ è un punto di partenza naturale, mentre le pagine di quartieri e attività possono offrire solo dati limitati, come titoli, descrizioni e immagini. Usa kind per separare i tipi di voce prima di contarli e leggi member_count come il totale dei membri di una community. Vengono lette solo pagine pubbliche: la funzionalità non cerca profili personali e non restituisce nulla che richieda l'accesso.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Nextdoor Directory di EveryInfra (nextdoor/directory).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su nextdoor e action su directory, e inserisci i parametri in params.
- Parametri obbligatori:
  - url: Specifica l'URL completo di una pagina pubblica di Nextdoor dedicata a una città, un quartiere, un'attività o una directory.
- Parametri facoltativi:
  - limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 50. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 25)
- Restituisce un elenco di record. Campi principali di ogni record: name, url, kind, description, member_count, image_url, area.
- Esempio di corpo della richiesta:
{
  "platform": "nextdoor",
  "action": "directory",
  "params": {
    "url": "https://nextdoor.com/city/san-francisco--ca/"
  }
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

Nome	Posizione	Tipo	Obbligatorio	Predefinito	Descrizione
`Authorization`	header	`string`	Sì	-	Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
`platform`	body	`string`	Sì	`nextdoor`	Identificativo della piattaforma, valore fisso.
`action`	body	`string`	Sì	`directory`	Identificativo della funzionalità, valore fisso.
`url`	body.params	`string`	Sì	-	Specifica l'URL completo di una pagina pubblica di Nextdoor dedicata a una città, un quartiere, un'attività o una directory. L'azione profile estrae dalla pagina i dati del profilo locale, mentre l'azione directory estrae le voci pubbliche della directory. Non interroga i profili personali degli utenti né recupera feed privati che richiedono autenticazione. Le pagine di quartieri e attività possono esporre solo dati pubblici limitati, come titoli, descrizioni e foto.
`limit`	body.params	`integer (1–50)`	No	`25`	Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 50. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito.

Esempi di codice

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

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

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

Campi della risposta

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

Campo	Significato
`name`	Nome dell'oggetto stesso, per le funzionalità relative ad account, prodotti e attività.
`url`	Link al record sulla piattaforma.
`kind`	Mantiene il significato attribuito dalla piattaforma
`description`	Riepilogo o descrizione, di solito più breve di text.
`member_count`	Mantiene il significato attribuito dalla piattaforma
`image_url`	Link all'immagine. Le funzionalità con più immagini possono restituire un array image_urls.
`area`	Mantiene il significato attribuito dalla piattaforma
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

FAQ

Quali link Nextdoor posso passare come `url`?

L'URL completo di una pagina pubblica Nextdoor di città, quartiere, attività o directory, ad esempio https://nextdoor.com/city/san-francisco--ca/. Nextdoor Directory non cerca profili personali e non legge post o feed che richiedono l'accesso, quindi i link a singoli membri o a contenuti privati non sono l'input giusto.

In cosa si differenzia Directory da Nextdoor Details?

Nextdoor Directory e Nextdoor Details accettano lo stesso tipo di link a una pagina. Directory elenca le voci a cui rimanda una pagina, una riga per voce, mentre la funzionalità Details riassume in un singolo record l'area descritta dalla pagina stessa. Usa Directory per costruire un elenco di quartieri o di schede, e Details per leggere i dati di una singola area.

Perché una pagina restituisce poche voci o nessuna?

Alcune pagine Nextdoor, soprattutto quelle di quartieri e attività, contengono solo un titolo, una descrizione e immagini, quindi le voci di directory da elencare possono essere poche. Verifica che il link sia una pagina pubblica di uno dei tipi supportati. Una chiamata che non restituisce righe non viene addebitata, quindi puoi risalire alla pagina della città e riprovare.

Errori e addebiti

401: Chiave mancante o non valida.
402: Saldo insufficiente. Effettua prima una ricarica.
422: Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429: Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503: Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota: Nessun dato. Nessun addebito.

Errori

Riferimenti ufficiali

Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.

Nextdoor: contenuti pubblici della community e limiti di visibilità dei quartieri ↗
Nextdoor chiarisce che la navigazione tra community diverse si basa sui contenuti con visibilità Anyone (chiunque), e che le informazioni esterne a un quartiere restano soggette a restrizioni di privacy. Il fatto che il sito pubblico permetta di sfogliare community o di unirsi a esse non significa che questa API possa leggere post privati, nomi completi o elenchi dei residenti, né unirsi a quartieri per conto di un utente.
Verificato il 2026-09-04