Yellow Pages Reviews

1 credit

Get the reviews and star-only ratings of one business.

POST/api/v1/tools/yellowpages/reviews

Parameters

countrystring

Which Yellow Pages to read: "us" (yellowpages.com), "uk" (yell.com), or "ca" (yellowpages.ca). Links, IDs, and locations must match the country. Defaults to "us".

businessstringrequired

A listing link or listing ID for the chosen country. A US link can use /mip/, /bpp/, or /bp/, can be an m.yp.com link, and can lack "https://". Keep "?lid=" in a link of a paid business, because it picks the category listing. A UK ID looks like "uk_901780159" or "901780159". A CA ID looks like "ca_156059" or "156059".

maxItemsnumber

Maximum reviews to return. From 1 through 500, and not above your plan limit. Defaults to 20.

Response Schema

dataobject

Yellow Pages reviews result

ypidstring

Business ID

reviewsobject[]

Reviews in the order that Yellow Pages serves. It is mostly newest first.

countnumber

Reviews returned

totalReviewsnumber

Reviews that Yellow Pages serves for the business. It can be less than the rating count, because some ratings exist only as counts.

metaobject

Request metadata

toolstring

Tool name (yellowpages-reviews)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/yellowpages/reviews \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "business": "https://www.yellowpages.com/austin-tx/mip/iii-forks-467675667",
  "maxItems": 20
}'

Response Example

{
  "data": {
    "ypid": "467675667",
    "reviews": [
      {
        "id": "9001",
        "body": "Great steak and service.",
        "subject": "Great dinner",
        "rating": 5,
        "createdAt": "2026-09-30T18:00:00.000Z",
        "authorName": "Sam R.",
        "reviewSource": "YP.com",
        "imageCount": 0
      }
    ],
    "count": 1,
    "totalReviews": 1
  },
  "meta": {
    "tool": "yellowpages-reviews",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}

curl -X POST https://scraper.run/api/v1/tools/yellowpages/reviews \

-H "Authorization: Bearer sc_live_..." \

-H "Content-Type: application/json" \

-d '{

"business": "https://www.yellowpages.com/austin-tx/mip/iii-forks-467675667",

"maxItems": 20

{

"data": {

"ypid": "467675667",

"reviews": [

{

"id": "9001",

"body": "Great steak and service.",

"subject": "Great dinner",

"rating": 5,

"createdAt": "2026-09-30T18:00:00.000Z",

"authorName": "Sam R.",

"reviewSource": "YP.com",

"imageCount": 0

}

"count": 1,

"totalReviews": 1

"meta": {

"tool": "yellowpages-reviews",

"creditsUsed": 1,

"requestId": "req_abc123"

}