API Craigslist Ricerca

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Craigslist Ricerca di EveryInfra (craigslist/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 craigslist e action su search, e inserisci i parametri in params.
- Parametri obbligatori:
  - keyword: Specifica il termine di ricerca per gli annunci di Craigslist, ad esempio bicycle. Gli annunci restituiti dipendono dalla categoria selezionata, quindi lo stesso termine può cercare vendite, immobili o offerte di lavoro.
- Parametri facoltativi:
  - category: Specifica lo slug della categoria degli annunci: for_sale (predefinito), cars_trucks, electronics, furniture, housing_apartments_houses, housing_rooms_shares, housing_sublets_temporary, jobs, gigs, resumes, services, com… (valori consentiti: cars_trucks / community / electronics / events / for_sale / furniture / gigs / housing_apartments_houses)
  - country: Seleziona il sottodominio della città di destinazione, non un codice paese. Accetta i valori elencati nello schema, ad esempio newyork, sfbay o toronto. (valori consentiti: anchorage / atlanta / austin / baltimore / boston / calgary / charlotte / chicago)
  - location: Funge da input di riserva per region e viene valutato solo quando region è omesso. Corrisponde a un sottodominio cittadino di Craigslist, non a indirizzi, CAP o coordinate geografiche.
  - max_price: Imposta il prezzo massimo degli annunci per il sottodominio cittadino e la categoria selezionati. Si usa insieme a min_price; valuta e cicli di fatturazione dipendono dai singoli annunci.
  - min_price: Imposta il prezzo minimo degli annunci per il sottodominio cittadino e la categoria selezionati.
  - region: Specifica lo slug del sottodominio della città, ad esempio newyork, sfbay o toronto. Accetta i valori esatti dell'elenco o alias comuni come nyc, la, dc e sanfrancisco. Gli input non riconosciuti ricadono su newyork.
  - sort: Ordina i risultati per data di pubblicazione (newest), prezzo crescente (price_asc) o rilevanza (relevance); se omesso, ordina per data di pubblicazione. (valori consentiti: newest / price_asc / relevance)
  - 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, text, price, currency, category, location, posted_at, lat, lng, emails; 14 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=craigslist.
- Esempio di corpo della richiesta:
{
  "platform": "craigslist",
  "action": "search",
  "params": {
    "keyword": "bicycle"
  }
}
- 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.