API Realtor Ricerca
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
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
#| 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ì | realtor | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | search | Identificativo della funzionalità, valore fisso. |
keyword | body.params | string | Sì | - | 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_type | body.params | string (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_rating | body.params | string (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 |
limit | body.params | integer (1–500) | No | 100 | 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. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
Esempi di codice
#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
#{ "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.
| Campo | Significato |
|---|---|
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
name | Nome dell'oggetto stesso, per le funzionalità relative ad account, prodotti e attività. |
url | Link al record sulla piattaforma. |
title | Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo). |
text | Testo 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_name | Mantiene il significato attribuito dalla piattaforma |
broker_name | Mantiene il significato attribuito dalla piattaforma |
city | Nome della città nella lingua della piattaforma, non normalizzato. |
state | Mantiene il significato attribuito dalla piattaforma |
postal_code | Mantiene il significato attribuito dalla piattaforma |
country | Paese o regione: nome completo o codice ISO a seconda della piattaforma, non normalizzato. |
license_no | Mantiene il significato attribuito dalla piattaforma |
rating | Valutazione. 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_scale | Valore 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_count | Numero di recensioni, per le funzionalità relative a prodotti e attività. null significa non reso noto, non 0. |
active_listings | Mantiene il significato attribuito dalla piattaforma |
recently_sold | Mantiene il significato attribuito dalla piattaforma |
price_min | Mantiene il significato attribuito dalla piattaforma |
price_max | Mantiene il significato attribuito dalla piattaforma |
specialties | Mantiene il significato attribuito dalla piattaforma |
languages | Mantiene il significato attribuito dalla piattaforma |
served_areas | Mantiene il significato attribuito dalla piattaforma |
emails | Indirizzi email di contatto (un record può averne più di uno), passati così come sono e senza duplicati. |
phones | Mantiene il significato attribuito dalla piattaforma |
image_url | Link all'immagine. Le funzionalità con più immagini possono restituire un array image_urls. |
platform | Identificativo 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.
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