API de Yelp

API de Yelp: Buscar

Busca negocios en Yelp por palabra clave y ubicación: hasta 20 resultados con calificaciones, categorías y datos básicos del negocio por solicitud.

US$2.50/1k solic., pagas por solicitud, sin suscripción.

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
Lo que devolvió la 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 campos más
}
Disponibilidad
93.85%
30d · 65 llamadas
Solicitudes
80
30d · semanal, últimas 12 sem.
Respuesta
18.6s
mediana · 30d

Precios y proveedores

Precios del endpoint Buscar de la API de Yelp: una API, 2 proveedores intercambiables

El proveedor más barato responde primero. Si falla, el siguiente toma el relevo en la misma llamada.

Un proveedor marcado como Fuera de servicio dejó de responder de forma confiable y se sacó de la rotación, así que tus llamadas van a los demás. Vuelve a entrar por sí solo cuando responde de forma confiable otra vez.

Pagas
US$25.00
US$2.50/1k solic., solo por lo que usas. Sin plan mensual.
Tus primeras 40 solicitudes son gratis con el saldo inicial de US$0.10.

Pruébalo

Obtén Buscar de Yelp en una sola solicitud

requireFieldsarray
Opcional; si lo omites, el enrutamiento no cambia y atiende la fuente más barata. Indica los campos de salida que esta solicitud debe poder devolver, por ejemplo `is_closed` o `price`, y solo la atenderá una fuente que los devuelva todos. Los campos que no indiques se siguen devolviendo siempre que la fuente que atiende los tenga. Esto puede subir tu precio: cuando la fuente más barata no puede devolver un campo indicado, atiende una fuente más cara, y se te cotiza y cobra su precio. Un campo indicado puede faltar igualmente en un lugar que realmente no lo tenga. Indicar una combinación que ninguna fuente devuelve junta se rechaza como entrada no válida, sin cargo.
Abrir en
Respuesta de ejemplo
Las ejecuciones gratis devuelven solo los primeros 3 resultados. Agrega fondos a una clave para obtener la respuesta completa.

Este ejemplo muestra 29 de 30 campos. Ver todos los 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"
      }
    ]
  }
}

Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.

Referencia

Una solicitud, un formato de respuesta.

Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.

Verificado por última vez el 2026-11-14 · disponibilidad y latencia medidas en 30d

Cuerpo de la solicitud

JSON, enviado por POST a este endpoint.

  • locationstring

    Chicago, IL

    Ciudad y estado que definen el área de búsqueda (p. ej., San Francisco, CA).

  • querystring

    pizza

    Término o categoría a buscar (p. ej., sushi).

  • limitinteger

    3

    Número máximo de resultados a devolver (de 1 a 20, por defecto 20).

  • requireFieldsarray

    Opcional; si lo omites, el enrutamiento no cambia y atiende la fuente más barata. Indica los campos de salida que esta solicitud debe poder devolver, por ejemplo `is_closed` o `price`, y solo la atenderá una fuente que los devuelva todos. Los campos que no indiques se siguen devolviendo siempre que la fuente que atiende los tenga. Esto puede subir tu precio: cuando la fuente más barata no puede devolver un campo indicado, atiende una fuente más cara, y se te cotiza y cobra su precio. Un campo indicado puede faltar igualmente en un lugar que realmente no lo tenga. Indicar una combinación que ninguna fuente devuelve junta se rechaza como entrada no válida, sin cargo.

Envías. Un cuerpo JSON pequeño. Los valores que se muestran son ejemplos para reemplazar por los tuyos.

Respuesta

JSON, un valor de ejemplo 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.

  • address2stringse puede exigir

    Secondary address line.

  • address3stringse puede exigir

    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_phonestringse puede exigir

    +13125550142

    Dialable phone number.

  • idstring

    abc123XyzChicagoDeepDish

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

  • is_closedbooleanse puede exigir

    false

    Whether the business is permanently closed.

  • latitudenumber

    41.9214

    Latitude of the business.

  • localized_phonestringse puede exigir

    (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[]se puede exigir

    Neighborhood labels for the location.

  • phonestring

    +13125550142

    Raw phone number.

  • photo_countintegerse puede exigir

    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.

  • priceintegerse puede exigir

    2

    Numeric price tier.

  • review_countinteger

    2418

    Number of reviews.

  • statestring

    IL

    State or region code.

  • unrounded_avg_ratingnumberse puede exigir

    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.

Recibes. Campos con nombre y tipo, con el mismo formato sin importar qué fuente responda.

Preguntas frecuentes

Acerca del endpoint Buscar de la API de Yelp

El endpoint Buscar de AnyAPI para Yelp devuelve datos de Yelp como JSON normalizado con una sola llamada POST a /v1/run/yelp.search. Busca negocios en Yelp por palabra clave y ubicación: hasta 20 resultados con calificaciones, categorías y datos básicos del negocio por solicitud. AnyAPI enruta cada solicitud entre 2 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$2.50 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 93.8% de las llamadas al endpoint Buscar de la API de Yelp a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 18.6 segundos en 65 llamadas medidas.

Cuesta desde US$2.50 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. Agregas fondos a una billetera en dólares y cada llamada descuenta de ella. Algunas solicitudes fallidas pagadas con la billetera generan cargos de procesamiento que trasladamos al costo, sin margen; la respuesta de error muestra el monto cobrado.

Busca negocios en Yelp por palabra clave y ubicación: hasta 20 resultados con calificaciones, categorías y datos básicos del negocio por solicitud. La respuesta es JSON normalizado con el mismo envoltorio que devuelve cada endpoint de AnyAPI, así que procesar un segundo endpoint es solo cambiar la URL.

En los últimos 30 días, el 93.8% de las llamadas al endpoint Buscar de la API de Yelp a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 18.6 segundos en 65 llamadas medidas. Estas son mediciones propias de AnyAPI sobre el tráfico que pasa por el gateway, recalculadas continuamente, no un objetivo de nivel de servicio publicado.

Sí. Una cuenta nueva de AnyAPI empieza con US$0.10 de saldo gratis, sin tarjeta, que alcanza para 40 llamadas a Buscar de Yelp a US$0.0025 cada una.

AnyAPI consulta la siguiente de sus 2 fuentes en la misma solicitud, empezando por la más barata, así que la caída de una fuente no hace fallar tu llamada.

Envía una solicitud POST a https://api.getanyapi.com/v1/run/yelp.search con tu clave de AnyAPI en un encabezado "Authorization: Bearer" y la entrada como cuerpo JSON. La misma clave y la misma billetera sirven para todos los endpoints de AnyAPI.

No. Agregas dólares a un solo saldo prepagado de AnyAPI y cada solicitud descuenta de él. No hay plan mensual ni mínimo, y el mismo saldo paga todos los endpoints de AnyAPI.

Sí. Instala @getanyapi/sdk desde npm para TypeScript o getanyapi desde pip para Python. Ambos llaman a todos los endpoints de AnyAPI con la misma clave, y también sirve cualquier cliente HTTP.

Sí. Un agente puede conectarse al servidor MCP de AnyAPI en https://api.getanyapi.com/mcp, o crear su propia clave de prueba gratis con un solo POST sin autenticar a https://api.getanyapi.com/agent/signup y llamar a este endpoint por HTTP.