API Zillow Dettagli

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Zillow Dettagli di EveryInfra (zillow/profile).

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 zillow e action su profile, e inserisci i parametri in params.
- Parametri obbligatori:
  - url: Un URL homedetails di un immobile su Zillow per profile o property_detail. Quest'ultima accetta in questo campo anche un indirizzo completo.
- Parametri facoltativi:
  - property_status: Un'indicazione dello stato noto dell'immobile di destinazione per profile: for_sale, recently_sold o for_rent. Aiuta a leggere un singolo immobile specificato e non è un filtro di ricerca. (valori consentiti: for_rent / for_sale / recently_sold)
- Restituisce un oggetto. Campi principali: zpid, url, home_status, home_type, price, currency, address, city, state, zipcode, county, latitude; 43 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=zillow.
- Esempio di corpo della richiesta:
{
  "platform": "zillow",
  "action": "profile",
  "params": {
    "url": "https://www.zillow.com/homedetails/6105-W-Club-Ln-Richmond-VA-23226/12345678_zpid/"
  }
}
- 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.