API Zillow Ricerca per codice ZIP

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Zillow Ricerca per codice ZIP di EveryInfra (zillow/zip_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 zillow e action su zip_search, e inserisci i parametri in params.
- Parametri obbligatori:
  - zip: Un CAP statunitense (ZIP code) per zip_search, preferibilmente come stringa di cinque caratteri, così da conservare gli zeri iniziali. Sono accettati anche una stringa separata da virgole o spazi e un array di CAP.
- Parametri facoltativi:
  - days_on_zillow: Un intervallo di tempo predefinito per zip_search: vuoto per nessuna restrizione; 1, 7, 14, 30 o 90 per i giorni; oppure 6m, 12m, 24m o 36m per i mesi. (valori consentiti: 1 / 12m / 14 / 24m / 30 / 36m / 6m / 7)
  - for_rent: Un booleano JSON che include gli annunci di affitto in zip_search. Non è esclusivo e si può combinare con altri filtri di stato. Non inviare la stringa "false".
  - for_sale_by_agent: Un booleano JSON che include in zip_search gli immobili messi in vendita da un agente. È true per impostazione predefinita solo quando non è selezionato alcuno stato tra vendita diretta dal proprietario, affitto o vendut…
  - for_sale_by_owner: Un booleano JSON che include in zip_search gli immobili messi in vendita direttamente dal proprietario. Non dimostra che la transazione sia priva di commissioni o costi di intermediazione.
  - max_price: Il filtro sul prezzo massimo dell'annuncio per search e zip_search. In zip_search sostituisce price_max. Non è il limite superiore di una stima del valore dell'immobile di Zillow.
  - min_price: Il campo standard del prezzo minimo per search e zip_search. In zip_search sostituisce price_min. Non è la commissione di un agente.
  - sold: Un booleano JSON che include gli immobili venduti in zip_search. Selezionarlo non garantisce che ogni zona renda pubblico il prezzo di vendita.
  - 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: zpid, url, status, status_type, price, currency, address, street, city, state, zipcode, latitude; 29 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=zillow.
- Esempio di corpo della richiesta:
{
  "platform": "zillow",
  "action": "zip_search",
  "params": {
    "zip": "78701"
  }
}
- 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.