Yellow Pages Business Search

Yellow Pages Business Search looks for a company in Yellow Pages directory data. The Yellow Pages Workflow Builder block exposes the yellow_pages service for business entities.

Requirements

Application field	Requirement	Notes
Business legal name	Required	Used as the company search term.
Business address city	Optional	Recommended to improve matching.
Business address state	Optional	Recommended to improve matching; use a state code.

Run Yellow Pages Business Search

Call Enrich Business Credit Application with provider set to yellow_pages, then poll Get Commercial Data with services[]=yellow_pages.

{
  "provider": "yellow_pages"
}

The asynchronous result appears at commercial_data.yellow_pages, the lifecycle message appears at statuses.yellow_pages, and the stored request appears at request_data.yellow_pages.

Yellow Pages Business Search is not included in the current Data Orchestration service catalog.

What the service returns

Response area	Meaning
Response array	Candidate Yellow Pages listings.
Listing identity and contact fields	Name, directory URL, address, telephone, and website.
Listing metadata	Hours, ratings, review count, categories, social networks, description, and payment information.

Representative response

[
  {
    "id": "564553485",
    "name": "Example Travel",
    "url": "https://www.yellowpages.com/example",
    "address": "3050 N Main St",
    "city": "Boise",
    "state": "ID",
    "zip": "83703",
    "phone": "2085550100",
    "website": "https://example.com",
    "open24": false,
    "rating": 4,
    "reviews": 12,
    "score": 78.4,
    "hoursText": "Mon - Fri 9:00 am - 5:00 pm",
    "features": {
      "socialNetworks": [
        "https://www.facebook.com/example"
      ]
    },
    "description": "Business description.",
    "сategories": [
      "Travel Agencies"
    ],
    "paymentMethod": null
  }
]

The current provider fixture spells сategories with a Cyrillic с, not a Latin c. Read the exact returned key and do not silently assume categories.

Response attributes

Attribute	Type	Meaning	Possible values or units	When returned
`[]`	Array	Candidate Yellow Pages listings.	Zero or more listing objects.	On a successful lookup.
`[].id`	String	Yellow Pages listing identifier.	Provider identifier.	For each listing when available.
`[].name`	String	Listing name.	Provider text.	For each listing.
`[].url`	String or null	Yellow Pages listing URL.	URL text.	When available.
`[].address`, `[].city`, `[].state`, `[].zip`	Strings or null	Directory address components.	Provider text.	When available.
`[].phone`	String or null	Listing telephone.	The fixture uses digits-only text; formatting is not guaranteed.	When available.
`[].website`	String or null	Business website.	URL text.	When available.
`[].open24`	Boolean or null	Whether the listing indicates 24-hour operation.	`true` or `false`.	When available.
`[].rating`	Number or null	Directory rating.	Displayed on a five-star control; exact bounds are not validated.	When available.
`[].reviews`	Number or null	Review count.	Non-negative count.	When available.
`[].score`	Number or null	Upstream match or relevance score.	Formula, range, and unit are not defined.	When available.
`[].hoursText`	String or null	Provider-formatted operating hours.	Text.	When available.
`[].features.socialNetworks`	Array of strings or null	Social profile URLs.	Zero or more URLs.	When available.
`[].description`	String or null	Directory description.	Provider text that can contain HTML; render safely.	When available.
`[].сategories`	Array of strings	Directory category labels.	Note the Cyrillic first character in the observed key.	When available.
`[].paymentMethod`	String or null	Provider-supplied payment information.	Provider text.	When available.
`error`	String	Failure or no-result message.	Service-generated text.	When the lookup fails.

Errors and statuses

statuses.yellow_pages describes the Lendflow request lifecycle. Success means a response was stored; it does not guarantee that every listing field was found. A response containing error marks the request as failed.

FAQ

Why does the response schema vary?

Lendflow stores the upstream Yellow Pages result without a fixed field-level normalization contract.

Can this service run in Data Orchestration?

It is not included in the current Data Orchestration service catalog.