API Crexi Ricerca

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Crexi Ricerca di EveryInfra (crexi/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 crexi e action su search, e inserisci i parametri in params.
- Parametri obbligatori:
  - keyword: È il parametro di ricerca obbligatorio per gli immobili commerciali su Crexi, ma funziona come filtro per stato quando viene fornito come sigla postale di uno stato USA (ad esempio TX, CA o FL), non come ricerca testuale…
- Parametri facoltativi:
  - max_price: Filtra gli annunci Crexi per prezzo richiesto massimo in USD. I decimali vengono arrotondati per eccesso a un numero intero prima della richiesta di ricerca.
  - min_price: Filtra gli annunci per prezzo richiesto minimo in USD. Accetta valori numerici, preferibilmente interi.
  - property_types: Filtra gli immobili commerciali per categoria di asset con una stringa o un array di stringhe, ad esempio Office, Retail o Multifamily.
  - sort: Ordina i risultati di ricerca Crexi in modo decrescente per relevance (grado di corrispondenza nella directory, predefinito) o newest (ordine per data dell'annuncio). (valori consentiti: newest / relevance)
  - state: Filtra per una singola sigla postale di uno stato USA, ad esempio TX. Viene letto solo quando states è omesso e ha la precedenza sul filtro per stato tramite keyword.
  - states: Filtra i risultati di ricerca per sigle postali degli stati USA usando una stringa o un array di stringhe, ad esempio TX o ["TX", "CA"], convertite automaticamente in maiuscolo.
  - transaction_type: Filtra gli annunci per tipo di transazione: sale (predefinito) o lease, senza distinzione tra maiuscole e minuscole. Qualsiasi altro valore, ad esempio rent, restituisce 422 invece di passare a sale. (valori consentiti: lease / sale)
  - limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. 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, name, text, address, city, county, state, postal_code, latitude, longitude, price; 22 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=crexi.
- Esempio di corpo della richiesta:
{
  "platform": "crexi",
  "action": "search",
  "params": {
    "keyword": "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.