POST

Stato di salute dell'API

Operatività nelle ultime 24 ore
Normale
  • Buono / normale
  • Disponibile
  • Limitato
  • Quasi del tutto inattivo
Normale

Ultime 24 ore

Ultimi 30 giorni

Trova agenti immobiliari su Realtor per città e stato in keyword. Filtra per specializzazione su acquirenti o venditori e per valutazione minima. Ottieni agenzia, broker, numero di licenza e recensioni. I dettagli indicati non confermano una licenza valida né costituiscono una raccomandazione.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su realtor e action impostato su search. 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.

Prompt per l'AI

#
Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Realtor Ricerca di EveryInfra (realtor/search).

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 realtor e action su search, e inserisci i parametri in params.
- Parametri obbligatori:
  - keyword: Specifica la località di ricerca per le richieste a Realtor. Per search, inserisci città e stato (ad es. Austin, TX) per trovare agenti.
- Parametri facoltativi:
  - agent_type: Specifica il tipo di agente per search. I valori consentiti sono both (agenti di acquirenti e di venditori, predefinito), buyer (solo agenti degli acquirenti) e seller (solo agenti dei venditori). (valori consentiti: both / buyer / seller)
  - min_rating: Filtra gli agenti per valutazione minima in search. Passa un array di stringhe, ad esempio ["4"]. I valori consentiti sono 0, 1, 2, 3, 4 e 5, dove 0 disattiva il filtro. (valori consentiti: 0 / 1 / 2 / 3 / 4 / 5)
  - limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 500. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 100)
- Restituisce un elenco di record. Campi principali di ogni record: id, name, url, title, text, office_name, broker_name, city, state, postal_code, country, license_no; 25 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=realtor.
- Esempio di corpo della richiesta:
{
  "platform": "realtor",
  "action": "search",
  "params": {
    "keyword": "Austin, TX"
  }
}
- 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

#
NomePosizioneTipoObbligatorioPredefinitoDescrizione
AuthorizationheaderstringSì-Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
platformbodystringSìrealtorIdentificativo della piattaforma, valore fisso.
actionbodystringSìsearchIdentificativo della funzionalità, valore fisso.
keywordbody.paramsstringSì-Specifica la località di ricerca per le richieste a Realtor. Per search, inserisci città e stato (ad es. Austin, TX) per trovare agenti. Per property_search, inserisci un CAP statunitense a 5 cifre o l'abbreviazione City, ST. Non sono accettate descrizioni arbitrarie degli immobili.
agent_typebody.paramsstring (enum)No-Specifica il tipo di agente per search. I valori consentiti sono both (agenti di acquirenti e di venditori, predefinito), buyer (solo agenti degli acquirenti) e seller (solo agenti dei venditori). Questo parametro non indica lo stato dell'annuncio dell'immobile.Valori consentitibothbuyerseller
min_ratingbody.paramsstring (enum)No-Filtra gli agenti per valutazione minima in search. Passa un array di stringhe, ad esempio ["4"]. I valori consentiti sono 0, 1, 2, 3, 4 e 5, dove 0 disattiva il filtro. Questo parametro filtra le valutazioni degli agenti, non quelle degli immobili.Valori consentiti012345
limitbody.paramsinteger (1–500)No100Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 500. 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": "realtor",
  "action": "search",
  "params": {
    "keyword": "Austin, TX"
  }
}'

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

#
Acquisita il November 7, 2026 at 14:47 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{  "id": "req_…",  "platform": "realtor",  "action": "search",  "results": [    {      "id": "•••",      "name": "T•••e",      "url": "•••",      "title": "12 years 6 months of experience",      "text": "•••",      "office_name": "Horizon Realty",      "broker_name": "Horizon Realty - Broker",      "city": "AUSTIN",      "state": "TX",      "postal_code": "78759",      "country": "US",      "license_no": "•••",      "rating": 5,      "review_count": 1,      "active_listings": 2,      "recently_sold": 20,      "price_min": 220000,      "price_max": 260000,      "specialties": [        "Buyer's agent",        "Seller's agent"      ],      "served_areas": [        "Georgetown, TX",        "Liberty Hill, TX",        "Round Rock, TX"      ],      "emails": [        "•••"      ],      "phones": [        "•••"      ],      "image_url": "https://ap.rdcpix.com/•••",      "platform": "realtor",      "rating_scale": 5    },    {      "id": "•••",      "name": "C•••s",      "url": "http://www.ChristopherWatters.com/•••",      "title": "19 years 10 months of experience",      "text": "•••",      "office_name": "Watters International Realty",      "broker_name": "Watters International Realty",      "city": "AUSTIN",      "state": "TX",      "postal_code": "78731",      "country": "US",      "license_no": "•••",      "rating": 4.6,      "review_count": 9,      "active_listings": 212,      "recently_sold": 298,      "price_min": 50000,      "price_max": 18999000,      "specialties": [        "Residential",        "Condos",        "Single-family homes"      ],      "languages": [        "English"      ],      "served_areas": [        "Austin, TX",        "Dallas, TX",        "Fort Worth, TX"      ],      "emails": [        "•••"      ],      "phones": [        "•••"      ],      "image_url": "https://ap.rdcpix.com/•••",      "platform": "realtor",      "rating_scale": 5    }  ],  "count": 100,  "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.

CampoSignificato
idID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse.
nameNome dell'oggetto stesso, per le funzionalità relative ad account, prodotti e attività.
urlLink al record sulla piattaforma.
titleTitolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo).
textTesto del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma).
office_nameMantiene il significato attribuito dalla piattaforma
broker_nameMantiene il significato attribuito dalla piattaforma
cityNome della città nella lingua della piattaforma, non normalizzato.
stateMantiene il significato attribuito dalla piattaforma
postal_codeMantiene il significato attribuito dalla piattaforma
countryPaese o regione: nome completo o codice ISO a seconda della piattaforma, non normalizzato.
license_noMantiene il significato attribuito dalla piattaforma
ratingValutazione. La scala varia in base alla piattaforma: rating_scale nella stessa riga indica il valore massimo (di solito 5; Booking, Douban, iQIYI e NAVER usano 10). Converti con rating_scale prima di confrontare piattaforme diverse, altrimenti il confronto può risultare invertito.
rating_scaleValore massimo di rating nella stessa riga: 5 per le scale a cinque stelle, 10 per quelle a dieci punti. Presente solo se la riga ha una valutazione.
review_countNumero di recensioni, per le funzionalità relative a prodotti e attività. null significa non reso noto, non 0.
active_listingsMantiene il significato attribuito dalla piattaforma
recently_soldMantiene il significato attribuito dalla piattaforma
price_minMantiene il significato attribuito dalla piattaforma
price_maxMantiene il significato attribuito dalla piattaforma
specialtiesMantiene il significato attribuito dalla piattaforma
languagesMantiene il significato attribuito dalla piattaforma
served_areasMantiene il significato attribuito dalla piattaforma
emailsIndirizzi email di contatto (un record può averne più di uno), passati così come sono e senza duplicati.
phonesMantiene il significato attribuito dalla piattaforma
image_urlLink all'immagine. Le funzionalità con più immagini possono restituire un array image_urls.
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

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.

  • Realtor: le differenze tra agente dell'acquirente e agente del venditore ↗

    La ricerca agenti di Realtor classifica gli agenti come Buy, Sell e Both, spiegando che l'agente dell'acquirente e l'agente che gestisce l'annuncio per il venditore svolgono ruoli diversi. Questo chiarisce le categorie professionali e non indica che EveryInfra offra servizi di intermediazione immobiliare.

    Verificato il 2026-09-04

Le nostre statistiche di visita interne sono sempre attive. Google Analytics viene caricato solo se scegli «Consenti analisi». Informativa sulla privacy