API para Yelp

API para Yelp: Buscar

Busque empresas no Yelp por palavra-chave e localização: até 20 estabelecimentos por requisição, com avaliações, categorias e informações principais de cada um.

Comece grátisBaixar amostraou JSON

US$ 2,50/mil req., pague por requisição, sem assinatura.

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

Best pizza Near Chicago, IL

1.

Lou's Deep Dish Kitchen

2,418

$$ · Pizza, American (Traditional)

Lincoln Park

2.
3.
Lou's Deep Dish Kitchen
Yelp
O que a API retornouitems[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 campos a mais
}
Disponibilidade
93,85%
30d · 65 chamadas
Requisições
80
30d · semanal, últimas 12 sem.
Resposta
18,6s
mediana · 30d

Preços e provedores

Preços do endpoint Buscar da API para Yelp: uma API, 2 provedores intercambiáveis

O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.

Provedor
1BadgerAtende primeiro100,00% de disponibilidade1660ms p506,6% das chamadasUS$ 2,50/mil req.flat2OctopusReserva 1100,00% de disponibilidade4738ms p5044,3% das chamadasUS$ 1,38/mil resultadosaté US$ 0,0275 / requisiçãoIbexFora de serviço30,00% de disponibilidade19190ms p5049,2% das chamadasUS$ 2,00/mil req.flat

Um provedor marcado como Fora de serviço parou de responder de forma confiável e foi retirado do rodízio, então suas chamadas vão para os outros. Ele volta sozinho assim que responder de forma confiável de novo.

Você paga
US$ 25,00
US$ 2,50/mil req., só pelo que você usar. Sem plano mensal.
Suas primeiras 40 requisições são grátis com o saldo inicial de US$ 0,10.

Teste

Obtenha Buscar do Yelp em uma só requisição

requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `is_closed` ou `price`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um local que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.

Este exemplo mostra 29 de 30 campos. Ver todos os campos

{
  "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"
      }
    ]
  }
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Uma requisição, um formato de resposta.

Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.

Última verificação em 2026-11-14 · disponibilidade e latência medidas em 30d

Corpo da requisição

JSON, enviado via POST para este endpoint.

  • locationstring

    Chicago, IL

    Cidade e estado que definem a área de busca (ex.: San Francisco, CA).

  • querystring

    pizza

    Termo ou categoria a buscar (ex.: sushi).

  • limitinteger

    3

    Número máximo de resultados a retornar (1 a 20, padrão 20).

  • requireFieldsarray

    Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `is_closed` ou `price`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um local que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.

Você envia. Um corpo JSON pequeno. Os valores mostrados são exemplos para você trocar pelos seus.

Resposta

JSON, um valor de exemplo por 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.

  • address2stringpode ser exigido

    Secondary address line.

  • address3stringpode ser exigido

    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_phonestringpode ser exigido

    +13125550142

    Dialable phone number.

  • idstring

    abc123XyzChicagoDeepDish

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

  • is_closedbooleanpode ser exigido

    false

    Whether the business is permanently closed.

  • latitudenumber

    41.9214

    Latitude of the business.

  • localized_phonestringpode ser exigido

    (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[]pode ser exigido

    Neighborhood labels for the location.

  • phonestring

    +13125550142

    Raw phone number.

  • photo_countintegerpode ser exigido

    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.

  • priceintegerpode ser exigido

    2

    Numeric price tier.

  • review_countinteger

    2418

    Number of reviews.

  • statestring

    IL

    State or region code.

  • unrounded_avg_ratingnumberpode ser exigido

    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.

Você recebe. Campos nomeados e tipados, no mesmo formato, seja qual for a fonte que responder.

Dúvidas frequentes

Sobre o endpoint Buscar da API para Yelp

O endpoint Buscar da AnyAPI para Yelp retorna dados de Yelp em JSON normalizado com uma chamada POST para /v1/run/yelp.search. Busque empresas no Yelp por palavra-chave e localização: até 20 estabelecimentos por requisição, com avaliações, categorias e informações principais de cada um. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 2,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 93,8% das chamadas ao endpoint Buscar da API para Yelp feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 18,6 segundos, em 65 chamadas medidas.

Custa a partir de US$ 2,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque empresas no Yelp por palavra-chave e localização: até 20 estabelecimentos por requisição, com avaliações, categorias e informações principais de cada um. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 93,8% das chamadas ao endpoint Buscar da API para Yelp feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 18,6 segundos, em 65 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.

Sim. Uma conta nova da AnyAPI começa com US$ 0,10 de saldo grátis, sem cartão, o que cobre 40 chamadas de Buscar do Yelp a US$ 0,0025 cada.

A AnyAPI consulta a próxima das suas 2 fontes na mesma requisição, começando pela mais barata, então a queda de uma fonte não derruba sua chamada.

Envie uma requisição POST para https://api.getanyapi.com/v1/run/yelp.search com sua chave da AnyAPI em um cabeçalho "Authorization: Bearer" e a entrada como corpo JSON. A mesma chave e a mesma carteira funcionam em todos os endpoints da AnyAPI.

Não. Você adiciona dólares a um único saldo pré-pago da AnyAPI e cada requisição desconta dele. Não há plano mensal nem mínimo, e o mesmo saldo paga todos os endpoints da AnyAPI.

Sim. Instale @getanyapi/sdk pelo npm para TypeScript ou getanyapi pelo pip para Python. Os dois chamam todos os endpoints da AnyAPI com a mesma chave, e qualquer cliente HTTP também funciona.

Sim. Um agente pode se conectar ao servidor MCP da AnyAPI em https://api.getanyapi.com/mcp, ou criar a própria chave de teste grátis com um único POST sem autenticação para https://api.getanyapi.com/agent/signup e chamar este endpoint por HTTP.