Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Yelp

Yelp: places, reviews, and search.

Get a place by ID

get

Returns a Yelp place by its Yelp business ID.

Price: $0.001 per item

Minimum charge: $0.001 per request (1 item)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstring · min: 1 · max: 200RequiredExample: JQNDglh1GHuvHriHAcJ1yg
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/yelp/place/{id}
GET /yelp/place/{id} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "JQNDglh1GHuvHriHAcJ1yg",
      "alias": "starbucks-seattle-121",
      "title": "Starbucks",
      "website": "https://www.starbucks.com/",
      "phoneNumber": "+12065551212",
      "avgRating": 3.5,
      "unroundedAvgRating": 3.4,
      "reviewCount": 105,
      "priceRange": "$$",
      "isBusinessClosed": false,
      "primaryPhoto": "https://s3-media0.fl.yelpcdn.com/bphoto/abc123/o.jpg",
      "mediaCount": 42,
      "address": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "coordinates": {
        "latitude": 47.6062,
        "longitude": -122.3321
      },
      "categories": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "operationHours": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "amenities": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "about": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.001000",
    "billableItems": 1
  }
}

Get reviews for a place

get

Returns reviews for a Yelp place. Use page (1-indexed) to paginate or maxItems for a one-shot bulk pull (mutually exclusive).

Price: $0.0002 per item

Minimum charge: $0.002 per request (10 items)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstring · min: 1 · max: 200RequiredExample: JQNDglh1GHuvHriHAcJ1yg
Query parameters
sortBystring · min: 1 · max: 50Optional
maxItemsinteger · min: 1 · max: 200Optional
pageinteger · min: 1 · max: 100Optional
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/yelp/place/{id}/reviews
GET /yelp/place/{id}/reviews HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "_pAYrXvfEr5MPj4eBAfjmA",
      "url": "https://www.yelp.com/biz/starbucks-seattle-121?hrid=_pAYrXvfEr5MPj4eBAfjmA",
      "rating": 5,
      "text": "Great coffee and service!",
      "language": "en",
      "date": "2026-04-30T10:00:00.000Z",
      "images": [
        "text"
      ],
      "feedback": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "reviewer": {
        "id": "text",
        "name": "Jane D.",
        "profileUrl": "text",
        "image": "text",
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.002000",
    "billableItems": 10
  }
}

Get a place by handle

get

Returns a Yelp place by its handle / slug.

Price: $0.001 per item

Minimum charge: $0.001 per request (1 item)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
handlestring · min: 1 · max: 200RequiredExample: starbucks-seattle-121
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/yelp/place/handle/{handle}
GET /yelp/place/handle/{handle} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "JQNDglh1GHuvHriHAcJ1yg",
      "alias": "starbucks-seattle-121",
      "title": "Starbucks",
      "website": "https://www.starbucks.com/",
      "phoneNumber": "+12065551212",
      "avgRating": 3.5,
      "unroundedAvgRating": 3.4,
      "reviewCount": 105,
      "priceRange": "$$",
      "isBusinessClosed": false,
      "primaryPhoto": "https://s3-media0.fl.yelpcdn.com/bphoto/abc123/o.jpg",
      "mediaCount": 42,
      "address": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "coordinates": {
        "latitude": 47.6062,
        "longitude": -122.3321
      },
      "categories": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "operationHours": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "amenities": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "about": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.001000",
    "billableItems": 1
  }
}

Search Yelp places

get

Search Yelp places by query and location. Use page (1-indexed) to paginate or maxItems for a one-shot bulk pull (mutually exclusive).

Price: $0.0002 per item

Minimum charge: $0.002 per request (10 items)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
querystring · min: 1 · max: 200RequiredExample: coffee
locationstring · min: 1 · max: 200RequiredExample: Seattle, WA
sortBystring · min: 1 · max: 50Optional
maxItemsinteger · min: 1 · max: 200Optional
pageinteger · min: 1 · max: 100Optional
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/yelp/search
GET /yelp/search?query=text&location=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "JQNDglh1GHuvHriHAcJ1yg",
      "alias": "starbucks-seattle-121",
      "name": "Starbucks",
      "rating": 3.5,
      "reviewCount": 105,
      "priceRange": "$$",
      "phone": "+12065551212",
      "website": "https://www.starbucks.com/",
      "coordinates": {
        "latitude": 47.6062,
        "longitude": -122.3321
      },
      "categories": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "images": [
        "text"
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.002000",
    "billableItems": 10
  }
}
PreviousTwitter
NextYoutube

Last updated