API EverySearch Luoghi

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: Normale

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Ultime 24 ore

Ultimi 30 giorni

Ricerca di luoghi e attività locali

Prezzo $0.69 per 1.000 richieste ($0.000694 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati.

Prompt per l'AI

Aiutami a scrivere uno script che chiami l'API «Luoghi» di EveryInfra.

Contratto dell'API:
- Richiesta: POST https://api.everyinfra.com/api/v1/search con l'header Authorization: Bearer <API Key>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; non inserirla nel codice.
- Nel corpo della richiesta, imposta tool su places e inserisci i parametri in params.
- Parametri obbligatori:
  - q: Query di ricerca.
- Parametri facoltativi:
  - location: Un luogo, come una città o un quartiere; viene cercato insieme alla query.
  - num: Numero di luoghi, fino a 20; con valori più alti ne vengono restituiti 20.
- Esempio di corpo della richiesta:
{
  "tool": "places",
  "params": {
    "q": "coffee",
    "location": "New York",
    "num": 3
  }
}
- Addebito: Prezzo $0.69 per 1.000 richieste ($0.000694 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati.
- In caso di 422, correggi i parametri seguendo i suggerimenti e i valori consentiti indicati nell'errore. In caso di 429 o 503, attendi il tempo indicato in Retry-After e riprova.

Prima di scrivere il codice, chiedimi quanti elementi devo elaborare e in quale formato salvare i risultati, poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

Nome	Posizione	Tipo	Obbligatorio	Predefinito	Descrizione
`Authorization`	header	`string`	Sì	-	Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
`tool`	body	`string`	Sì	`places`	Nome dello strumento, valore fisso.
`q`	body.params	`string`	Sì	-	Query di ricerca.
`location`	body.params	`string`	No	-	Un luogo, come una città o un quartiere; viene cercato insieme alla query.
`num`	body.params	`integer (1–20)`	No	`10`	Numero di luoghi, fino a 20; con valori più alti ne vengono restituiti 20.

Esempi di codice

bash

curl -X POST 'https://api.everyinfra.com/api/v1/search' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "tool": "places",
  "params": {
    "q": "coffee",
    "location": "New York",
    "num": 3
  }
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

json

{  "id": "req_…",  "tool": "places",  "results": [    {      "title": "Dam Roast House & Browder Bookstore",      "address": "554 Nevada Way, Boulder City, NV 89005",      "latitude": 35.9771895,      "longitude": -114.838469,      "rating": 4.8,      "rating_count": 561,      "category": "Coffee shop",      "categories": [        "Coffee shop",        "Book store"      ],      "phone": "•••",      "website": "http://www.damroasthousebc.com/",      "opening_hours": {        "Saturday": "6 AM–5 PM",        "Sunday": "6 AM–5 PM",        "Monday": "6 AM–5 PM",        "Tuesday": "6 AM–5 PM",        "Wednesday": "6 AM–5 PM",        "Thursday": "6 AM–5 PM",        "Friday": "6 AM–5 PM"      },      "thumbnail_url": "https://lh3.googleusercontent.com/grass-cs/AABkmLf4-cpUw7kELwRhr17jbq5mKywqGj6YQcgRTRCjzyrp1IwiTyzk9E5y9cqSHfEc-gOK7eaWAMR1ahVoIM-rJ8Jfq50GDUFqSlYvRjJ9SXzrafaOW42dbzfD3_ex1ZfWf2Pw5YpJqad8nn7C",      "place_id": "ChIJu5l4IRYryYARDeIpoXxvZEs"    },    {      "title": "The Coffee Cup Cafe",      "address": "512 Nevada Way, Boulder City, NV 89005",      "latitude": 35.9776607,      "longitude": -114.8379609,      "rating": 4.8,      "rating_count": 3948,      "category": "Coffee shop",      "categories": [        "Coffee shop",        "Bar",        "Cafe"      ],      "phone": "•••",      "website": "http://worldfamouscoffeecup.com/",      "opening_hours": {        "Saturday": "6 AM–2 PM",        "Sunday": "6 AM–2 PM",        "Monday": "6 AM–2 PM",        "Tuesday": "6 AM–2 PM",        "Wednesday": "6 AM–2 PM",        "Thursday": "6 AM–2 PM",        "Friday": "6 AM–2 PM"      },      "thumbnail_url": "https://lh3.googleusercontent.com/grass-cs/AABkmLeandCndjsMrUCyaMWX17I-LspQ9FviwQnndWDPuRWDs3PT8wAG99vD5KHNvjIafGiRp3A7rEUaZuNkxHXdOabApOI1onpOxhYZKMqNseQeiO3w-0IMKZvyMrIR4PjR9L_ayKY",      "place_id": "ChIJ_92jHDQryYARn-GaGEjl2fw"    }  ],  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Errori e addebiti

401: Chiave mancante o non valida.
402: Saldo insufficiente. Effettua prima una ricarica.
422: Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429: Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503: Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota: Nessun dato. Nessun addebito.

Errori