API di Realtor
Cerca agenti immobiliari su Realtor oppure filtra gli annunci di immobili residenziali negli Stati Uniti in base allo stato dell'immobile: in vendita, in affitto o già venduto. In questo modo puoi verificarne i dettagli.
Indica la località con un codice postale statunitense di cinque cifre oppure con la città e la sigla dello stato.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su realtor e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 3 funzionalità
- $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Realtor: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $1.39 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Trova agenti immobiliari su Realtor per città e stato in keyword. | Normale | |
Ricerca immobiliproperty_search | Cerca annunci immobiliari su Realtor per ZIP code statunitense o City, ST in keyword, con filtri per prezzo, camere da letto, bagni, stato dell'annuncio e ordinamento. | Normale | |
Dettagli dell'immobileproperty_detail | Recupera un immobile da Realtor dal suo URL di dettaglio, dall'ID o dall'indirizzo. | Normale |
Cosa accetta ogni azione di API di Realtor?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000Righe vuote: $1.39 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Trova agenti immobiliari su Realtor per città e stato in | keyword | agent_type, min_rating | Valori del catalogo: defaultLimit=100, maxLimit=500. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · name · url · title · text · office_name · broker_name · city · state · postal_code · country · license_no · rating · rating_scale · review_count · active_listings · recently_sold · price_min · price_max · specialties · languages · served_areas · emails · phones · image_url · platform | |
property_searchRicerca immobili Cerca annunci immobiliari su Realtor per ZIP code statunitense o City, ST in | keyword | baths_min, beds_min, city, max_price, min_price, sort, status | Valori del catalogo: defaultLimit=20, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · title · status · price · sold_price · sold_at · listed_at · property_type · beds · baths · area_sqft · lot_sqft · year_built · address · city · state · postal_code · county · lat · lng · image_url · photo_count · is_new_listing · is_price_reduced · is_foreclosure · advertiser_emails · advertiser_phones · platform | |
property_detailDettagli dell'immobile Recupera un immobile da Realtor dal suo URL di dettaglio, dall'ID o dall'indirizzo. Ottieni stato, prezzo di listino e di vendita, data di vendita, camere da letto, bagni, superficie interna in piedi quadrati e anno di costruzione. Non sostituisce un'ispezione, una perizia o una verifica del titolo di proprietà. | url | — | — | id · url · title · status · price · sold_price · sold_at · updated_at · property_type · beds · baths · area_sqft · year_built · address · city · state · postal_code · platform |
Cosa significano i parametri search di API di Realtor?
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.
keywordObbligatorio- Specifica la località di ricerca per le richieste a Realtor. Per
search, inserisci città e stato (ad es.Austin, TX) per trovare agenti. Perproperty_search, inserisci un CAP statunitense a 5 cifre o l'abbreviazioneCity, ST. Non sono accettate descrizioni arbitrarie degli immobili. agent_typeFacoltativo- Specifica il tipo di agente per
search. I valori consentiti sonoboth(agenti di acquirenti e di venditori, predefinito),buyer(solo agenti degli acquirenti) eseller(solo agenti dei venditori). Questo parametro non indica lo stato dell'annuncio dell'immobile.Valori ammessi:bothbuyersellerRealtor: 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 min_ratingFacoltativo- Filtra gli agenti per valutazione minima in
search. Passa un array di stringhe, ad esempio["4"]. I valori consentiti sono0,1,2,3,4e5, dove0disattiva il filtro. Questo parametro filtra le valutazioni degli agenti, non quelle degli immobili.Valori ammessi:012345
Cosa significano i parametri property_search di API di Realtor?
Cerca annunci immobiliari su Realtor per ZIP code statunitense o City, ST in keyword, con filtri per prezzo, camere da letto, bagni, stato dell'annuncio e ordinamento. Prezzo di listino, prezzo di vendita e relative date sono campi separati, e un risultato non conferma che la casa sia ancora disponibile.
keywordObbligatorio- Specifica la località di ricerca per le richieste a Realtor. Per
search, inserisci città e stato (ad es.Austin, TX) per trovare agenti. Perproperty_search, inserisci un CAP statunitense a 5 cifre o l'abbreviazioneCity, ST. Non sono accettate descrizioni arbitrarie degli immobili. baths_minFacoltativo- Imposta il numero minimo di bagni. Il valore viene usato come intero, quindi non può rappresentare un valore che includa un mezzo bagno, ad esempio 1.5.
beds_minFacoltativo- Imposta il numero minimo di camere da letto come intero. Non è il numero totale di locali dell'immobile.
cityFacoltativo- Sostituisce il nome della città per
property_search. Se cerchi per CAP, non passare una città in conflitto, per evitare condizioni di località contraddittorie. max_priceFacoltativo- Specifica il prezzo massimo dell'annuncio per l'input standard e ha la priorità su
price_maxnella stessa richiesta. Interpreta i prezzi separatamente per gli annunci di vendita e di affitto. Il filtro usa numeri interi: i decimali vengono arrotondati per eccesso (145.98 diventa 146). min_priceFacoltativo- Specifica il prezzo minimo dell'annuncio per l'input standard e ha la priorità su
price_minnella stessa richiesta. Questo parametro filtra i prezzi degli immobili, non i compensi degli agenti. Il filtro usa numeri interi: i decimali vengono arrotondati per difetto (39.81 diventa 39). sortFacoltativo- Ordine degli annunci per
property_search, sempre decrescente:newest(annunci più recenti prima, predefinito),price_desc(prezzo richiesto),sold_price_desc(prezzo di vendita finale),recently_sold,bedrooms_desc,lot_size_desc,photo_count_descorecently_updated. Non esiste un'opzione crescente, quindi gli annunci non possono essere ordinati partendo dal prezzo più basso.Valori ammessi:bedrooms_desclot_size_descnewestphoto_count_descprice_descrecently_soldrecently_updatedsold_price_desc statusFacoltativo- Uno stato dell'annuncio per
property_search, inviato come stringa; il valore predefinito èfor_sale. I valori noti sonosold,for_rent,ready_to_build,off_market,otherenew_community. Il valore non viene verificato rispetto a un elenco fisso, quindi le altre stringhe non vengono rifiutate. Invia un solo stato, non un array.
Cosa significano i parametri property_detail di API di Realtor?
Recupera un immobile da Realtor dal suo URL di dettaglio, dall'ID o dall'indirizzo. Ottieni stato, prezzo di listino e di vendita, data di vendita, camere da letto, bagni, superficie interna in piedi quadrati e anno di costruzione. Non sostituisce un'ispezione, una perizia o una verifica del titolo di proprietà.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Specifica l'URL di dettaglio Realtor per
property_detail, che dovrebbe contenere un suffisso_M<digits>-<digits>da cui ricavare ilproperty_id. In questo campo puoi passare anche l'ID dell'immobile o l'indirizzo completo. Non è garantito che altri URL senza un ID ricavabile vengano risolti.
Come usare l'API di Realtor
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"realtor","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Realtor
Cosa posso ottenere con l'API di Realtor?
Imposta platform su realtor. Il catalogo attuale elenca ricerca, ricerca immobili e dettagli dell'immobile. Questi nomi di azione identificano oggetti o viste diversi di Realtor; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Realtor?
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. Invialo come keyword all'interno di params.
Quali campi può restituire search di Realtor?
Il suo schema dichiarato include name, title, text e office_name. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Realtor rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.