Yellow Pages Business

2 credits

Get the full record of one business from its listing link or ID.

POST/api/v1/tools/yellowpages/business

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".

includeMediaboolean

Add every photo and video, with covers, logos, and thumbnails. Defaults to true.

includeReviewsboolean

Add the reviews and star-only ratings of the business in businessReviews. Defaults to false.

maxReviewsnumber

Maximum reviews when includeReviews is true. From 1 through 500, and not above your plan limit. Defaults to 20. Yell serves up to about 20 reviews per UK business.

Response Schema

dataobject

The business record

ypidstring

Business ID. A UK ID starts with "uk_" and a Canada ID with "ca_".

listingIdstring

Listing of the business in one category

namestring

Business name

yellowPagesUrlstring | null

Listing page on Yellow Pages

phoneNumberstring

Formatted phone, such as "(512) 823-0000". Canada records use telephone.

urlstring

Website of the business

addressstring | object

Street address. Canada records give an object with street, city, province, postal code, and country.

citystring

City

statestring

State

zipstring

ZIP code

latitudenumber

Latitude. Missing for businesses that hide their address.

longitudenumber

Longitude

headingTextstring

Main category

allHeadingsstring[]

All categories

averageRatingnumber

Shown average rating

ratingCountnumber

Number of ratings, with star-only ratings

reviewCountnumber

Number of written reviews

opHoursstring

Opening hours as text

openNowboolean

Open at the time of the request

isClaimedboolean

The owner claimed the listing

mediaobject

Photos and videos. Holds the full gallery when includeMedia is true.

searchListingobject | null

The search result of this business, with values such as distance. Null for a direct lookup.

businessReviewsobject[]

Reviews and star-only ratings. Present only when reviews were requested.

businessReviewsTotalnumber

Number of reviews that Yellow Pages serves for the business

scrapedAtstring

UTC time at which the business was read

metaobject

Request metadata

toolstring

Tool name (yellowpages-business)

creditsUsednumber

Credits consumed (2)

requestIdstring

Unique request ID

Request

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

Response Example

{
  "data": {
    "ypid": "467675667",
    "listingId": "467675667",
    "name": "III Forks",
    "yellowPagesUrl": "https://www.yellowpages.com/austin-tx/mip/iii-forks-467675667",
    "phoneNumber": "(512) 555-0101",
    "city": "Austin",
    "state": "TX",
    "headingText": "Steak Houses",
    "averageRating": 4,
    "ratingCount": 2,
    "searchListing": null,
    "businessReviews": [
      {
        "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
      }
    ],
    "businessReviewsTotal": 1,
    "scrapedAt": "2026-10-22T09:00:00.000Z"
  },
  "meta": {
    "tool": "yellowpages-business",
    "creditsUsed": 2,
    "requestId": "req_abc123"
  }
}

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

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

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

-d '{

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

"includeReviews": true,

"maxReviews": 20

{

"data": {

"ypid": "467675667",

"listingId": "467675667",

"name": "III Forks",

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

"phoneNumber": "(512) 555-0101",

"city": "Austin",

"state": "TX",

"headingText": "Steak Houses",

"averageRating": 4,

"ratingCount": 2,

"searchListing": null,

"businessReviews": [

{

"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

}

"businessReviewsTotal": 1,

"scrapedAt": "2026-10-22T09:00:00.000Z"

"meta": {

"tool": "yellowpages-business",

"creditsUsed": 2,

"requestId": "req_abc123"

}