API Realtor Ricerca immobili

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Realtor Ricerca immobili di EveryInfra (realtor/property_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 property_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:
  - baths_min: 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_min: Imposta il numero minimo di camere da letto come intero. Non è il numero totale di locali dell'immobile.
  - city: 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_price: Specifica il prezzo massimo dell'annuncio per l'input standard e ha la priorità su price_max nella stessa richiesta. Interpreta i prezzi separatamente per gli annunci di vendita e di affitto.
  - min_price: Specifica il prezzo minimo dell'annuncio per l'input standard e ha la priorità su price_min nella stessa richiesta. Questo parametro filtra i prezzi degli immobili, non i compensi degli agenti.
  - sort: 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_… (valori consentiti: bedrooms_desc / lot_size_desc / newest / photo_count_desc / price_desc / recently_sold / recently_updated / sold_price_desc)
  - status: Uno stato dell'annuncio per property_search, inviato come stringa; il valore predefinito è for_sale. I valori noti sono sold, for_rent, ready_to_build, off_market, other e new_community.
  - limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 200. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 20)
- Restituisce un elenco di record. Campi principali di ogni record: id, url, title, status, price, sold_price, sold_at, listed_at, property_type, beds, baths, area_sqft; 28 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=realtor.
- Esempio di corpo della richiesta:
{
  "platform": "realtor",
  "action": "property_search",
  "params": {
    "keyword": "10022"
  }
}
- 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.