API di Yelp

Yelp Ricerca API

Cerca su Yelp attività per parola chiave e località: fino a 20 inserzioni con valutazioni, categorie e informazioni essenziali sull'attività per richiesta.

2,50 USD/1k richieste, paghi a richiesta, nessun abbonamento.

Best pizza Near Chicago, IL - Yelp
yelp.com/search?find_desc=pizza&find_loc=Chicago%2C%20IL
yelp
AllDeliveryTakeoutPriceOpen Now

Best pizza Near Chicago, IL

1.

2,418

$$ · Pizza, American (Traditional)

Lincoln Park

2.
3.
Lou's Deep Dish Kitchen
Yelp
Cosa ha restituito l'APIitems[0]
{
"id": "abc123XyzChicagoDeepDish",
"name": "Lou's Deep Dish Kitchen",
"alias": "lous-deep-dish-kitchen-chicago",
"address1": "2145 N Halsted St",
"address2": "",
"address3": "",
"city": "Chicago",
"state": "IL",
... 18 campi in più
}
Disponibilità
100,00%
30d · 76 chiamate
Richieste
91
30 g · settimanale, ultime 12 sett.
Risposta
15,7s
mediana · 30d

Prezzi e provider

Prezzi dell'API Yelp Ricerca: una sola API, 2 provider intercambiabili

Serve per primo il provider più economico. Se fallisce, subentra il successivo nella stessa chiamata.

Un provider contrassegnato come Non attivo ha smesso di rispondere in modo affidabile ed è stato tolto dalla rotazione, quindi le tue chiamate vanno agli altri. Viene rimesso da solo quando torna a rispondere in modo affidabile.

Paghi
25,00 USD
2,50 USD/1k richieste, solo per ciò che usi. Nessun piano mensile.
Le tue prime 40 richieste sono gratuite con il saldo iniziale di 0,10 USD.

Provalo

Ottieni Yelp Ricerca in una sola richiesta

requireFieldsarray
Facoltativo; se lo ometti l'instradamento resta invariato, e serve la fonte più economica. Indica i campi di output che questa richiesta deve poter restituire, per esempio `is_closed` o `price`, e verrà servita solo da una fonte che li restituisce tutti. I campi che non indichi vengono comunque restituiti ogni volta che la fonte che serve li ha. Può far salire il prezzo: quando la fonte più economica non può restituire un campo indicato, serve una fonte più cara, e ti viene quotato e addebitato il suo prezzo. Un campo indicato può comunque mancare su un luogo che davvero non lo ha. Indicare una combinazione che nessuna singola fonte restituisce insieme viene rifiutato come input non valido, senza addebito.
Apri in
Risposta di esempio
Le esecuzioni gratuite restituiscono solo i primi 3 risultati. Ricarica una chiave per ottenere la risposta completa.

Questo esempio mostra 29 campi su 30. Vedi tutti i campi

{
  "found": true,
  "data": {
    "items": [
      {
        "id": "abc123XyzChicagoDeepDish",
        "name": "Lou's Deep Dish Kitchen",
        "alias": "lous-deep-dish-kitchen-chicago",
        "address1": "2145 N Halsted St",
        "address2": "",
        "address3": "",
        "city": "Chicago",
        "state": "IL",
        "zip": "60614",
        "country": "US",
        "latitude": 41.9214,
        "longitude": -87.6486,
        "neighborhoods": [
          "Lincoln Park"
        ],
        "phone": "+13125550142",
        "localized_phone": "(312) 555-0142",
        "dialable_phone": "+13125550142",
        "review_count": 2418,
        "avg_rating": 4.5,
        "unrounded_avg_rating": 4.47,
        "is_closed": false,
        "price": 2,
        "localized_price": "$$",
        "categories": [
          {
            "alias": "pizza",
            "title": "Pizza"
          },
          {
            "alias": "tradamerican",
            "title": "American (Traditional)"
          }
        ],
        "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/9f2a1b7c6e4d8a3b5c1f0e2d4a6b8c9d/o.jpg",
        "photo_count": 384,
        "url": "https://www.yelp.com/biz/lous-deep-dish-kitchen-chicago"
      },
      {
        "id": "def456UptownSlice",
        "name": "Uptown Slice House",
        "alias": "uptown-slice-house-chicago",
        "address1": "4560 N Broadway St",
        "address2": "",
        "address3": "",
        "city": "Chicago",
        "state": "IL",
        "zip": "60640",
        "country": "US",
        "latitude": 41.9647,
        "longitude": -87.6558,
        "neighborhoods": [
          "Uptown"
        ],
        "phone": "+17735550198",
        "localized_phone": "(773) 555-0198",
        "dialable_phone": "+17735550198",
        "review_count": 967,
        "avg_rating": 4,
        "unrounded_avg_rating": 4.02,
        "is_closed": false,
        "price": 1,
        "localized_price": "$",
        "categories": [
          {
            "alias": "pizza",
            "title": "Pizza"
          }
        ],
        "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b/o.jpg",
        "photo_count": 156,
        "url": "https://www.yelp.com/biz/uptown-slice-house-chicago"
      },
      {
        "id": "ghi789WickerParkPie",
        "name": "Wicker Park Pie Co.",
        "alias": "wicker-park-pie-co-chicago",
        "address1": "1780 N Milwaukee Ave",
        "address2": "Suite 2",
        "address3": "",
        "city": "Chicago",
        "state": "IL",
        "zip": "60622",
        "country": "US",
        "latitude": 41.9127,
        "longitude": -87.6763,
        "neighborhoods": [
          "Wicker Park"
        ],
        "phone": "+17735550176",
        "localized_phone": "(773) 555-0176",
        "dialable_phone": "+17735550176",
        "review_count": 512,
        "avg_rating": 4.5,
        "unrounded_avg_rating": 4.46,
        "is_closed": false,
        "price": 2,
        "localized_price": "$$",
        "categories": [
          {
            "alias": "pizza",
            "title": "Pizza"
          },
          {
            "alias": "italian",
            "title": "Italian"
          }
        ],
        "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b/o.jpg",
        "photo_count": 92,
        "url": "https://www.yelp.com/biz/wicker-park-pie-co-chicago"
      }
    ]
  }
}

Riferimento completo di parametri e risposta - ogni campo, tipo ed esempio per questo endpoint.

Riferimento

Una richiesta, una sola forma di risposta.

Ogni campo che invii e ogni campo che ricevi, ciascuno con un esempio reale.

Ultima verifica 2026-11-21 · disponibilità e latenza misurate su 30d

Corpo della richiesta

JSON, inviato a questo endpoint.

  • locationstring

    Chicago, IL

    Città e stato che definiscono l'area di ricerca (es. San Francisco, CA).

  • querystring

    pizza

    Termine o categoria da cercare (es. sushi).

  • limitinteger

    3

    Numero massimo di risultati da restituire (da 1 a 20, predefinito 20).

  • requireFieldsarray

    Facoltativo; se lo ometti l'instradamento resta invariato, e serve la fonte più economica. Indica i campi di output che questa richiesta deve poter restituire, per esempio `is_closed` o `price`, e verrà servita solo da una fonte che li restituisce tutti. I campi che non indichi vengono comunque restituiti ogni volta che la fonte che serve li ha. Può far salire il prezzo: quando la fonte più economica non può restituire un campo indicato, serve una fonte più cara, e ti viene quotato e addebitato il suo prezzo. Un campo indicato può comunque mancare su un luogo che davvero non lo ha. Indicare una combinazione che nessuna singola fonte restituisce insieme viene rifiutato come input non valido, senza addebito.

Tu invii. Un piccolo corpo JSON. I valori mostrati sono esempi da sostituire con i tuoi.

Risposta

JSON, un valore di esempio per campo.

each itemdata.items[]

Business listing records: name, categories, rating, review count, address, and core business info. Populated whenever the provider has data for the entity.

  • address1string

    2145 N Halsted St

    Primary street address line.

  • address2stringpuò richiedere

    Secondary address line.

  • address3stringpuò richiedere

    Tertiary address line.

  • aliasstring

    lous-deep-dish-kitchen-chicago

    URL slug for the business. Populated whenever the provider has data for the entity.

  • avg_ratingnumber

    4.5

    Rounded average star rating.

  • categoriesobject[]

    Business category tags.

  • citystring

    Chicago

    City name.

  • countrystring

    US

    ISO country code.

  • dialable_phonestringpuò richiedere

    +13125550142

    Dialable phone number.

  • idstring

    abc123XyzChicagoDeepDish

    Stable Yelp business identifier. Populated whenever the provider has data for the entity.

  • is_closedbooleanpuò richiedere

    false

    Whether the business is permanently closed.

  • latitudenumber

    41.9214

    Latitude of the business.

  • localized_phonestringpuò richiedere

    (312) 555-0142

    Formatted local phone number.

  • localized_pricestring

    $$

    Localized price tier (e.g. $$).

  • longitudenumber

    -87.6486

    Longitude of the business.

  • namestring

    Lou's Deep Dish Kitchen

    Business display name. Populated whenever the provider has data for the entity.

  • neighborhoodsstring[]può richiedere

    Neighborhood labels for the location.

  • phonestring

    +13125550142

    Raw phone number.

  • photo_countintegerpuò richiedere

    384

    Total photo count.

  • photo_urlstring

    https://s3-media0.fl.yelpcdn.com/bphoto/9f2a1b7c6e4d8a3b5c1f0e2d4a6b8c9d/o.jpg

    Primary photo URL. Populated whenever the provider has data for the entity.

  • priceintegerpuò richiedere

    2

    Numeric price tier.

  • review_countinteger

    2418

    Number of reviews.

  • statestring

    IL

    State or region code.

  • unrounded_avg_ratingnumberpuò richiedere

    4.47

    Unrounded average star rating.

  • urlstring

    https://www.yelp.com/biz/lous-deep-dish-kitchen-chicago

    Public Yelp business page URL.

  • zipstring

    60614

    Postal code.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Tu ricevi. Campi con nome e tipo nella stessa struttura, qualunque fonte risponda.

FAQ

Sull'API Yelp Ricerca

L'API Yelp Ricerca di AnyAPI restituisce dati Yelp come JSON normalizzato da una sola chiamata POST a /v1/run/yelp.search. Cerca su Yelp attività per parola chiave e località: fino a 20 inserzioni con valutazioni, categorie e informazioni essenziali sull'attività per richiesta. AnyAPI instrada ogni richiesta su 2 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 2,50 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Negli ultimi 30 giorni, il 100,0% delle chiamate Yelp Ricerca tramite AnyAPI è riuscito, con un tempo di risposta mediano di 15,7 secondi su 76 chiamate misurate.

Costa da 2,50 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Ricarichi un portafoglio in USD e ogni chiamata lo scala. Alcune richieste fallite finanziate dal portafoglio comportano costi di elaborazione che trasferiamo al costo, senza ricarico; la risposta di errore mostra l'importo addebitato.

Cerca su Yelp attività per parola chiave e località: fino a 20 inserzioni con valutazioni, categorie e informazioni essenziali sull'attività per richiesta. La risposta è JSON normalizzato con la stessa busta che restituisce ogni endpoint AnyAPI, quindi analizzare un secondo endpoint significa cambiare l'URL e nient'altro.

Negli ultimi 30 giorni, il 100,0% delle chiamate Yelp Ricerca tramite AnyAPI è riuscito, con un tempo di risposta mediano di 15,7 secondi su 76 chiamate misurate. Sono misurazioni di AnyAPI sul traffico che passa dal gateway, ricalcolate di continuo, non un obiettivo di livello di servizio pubblicato.

Sì. Un nuovo account AnyAPI parte con 0,10 USD di saldo gratuito e senza bisogno di carta, che copre 40 chiamate Yelp Ricerca a 0,0025 USD ciascuna.

AnyAPI interroga la successiva delle sue 2 fonti nella stessa richiesta, partendo dalla più economica, quindi una fonte che cade non fa fallire la tua chiamata.

Invia una richiesta POST a https://api.getanyapi.com/v1/run/yelp.search con la tua chiave AnyAPI in un header "Authorization: Bearer" e l'input come corpo JSON. La stessa chiave e lo stesso portafoglio funzionano su ogni endpoint AnyAPI.

No. Aggiungi dollari statunitensi a un unico saldo prepagato AnyAPI e ogni richiesta lo scala. Non c'è un piano mensile né un minimo, e lo stesso saldo paga ogni endpoint AnyAPI.

Sì. Installa @getanyapi/sdk da npm per TypeScript o getanyapi da pip per Python. Entrambi chiamano ogni endpoint AnyAPI con la stessa chiave, e funziona anche qualsiasi client HTTP.

Sì. Un agente può collegarsi al server MCP di AnyAPI su https://api.getanyapi.com/mcp, oppure creare da solo la propria chiave di prova gratuita con un POST non autenticato a https://api.getanyapi.com/agent/signup e chiamare questo endpoint via HTTP.