Skip to content
Examples

Get Results

Retrieve scraped data from Yellow Pages Companies Search Export

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Yellow Pages Companies Search Export runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

pageintegerquery

Page number (default: 1)

Result Fields

item_idstring

Unique Yellow Pages identifier (ypid). Example: 560515561

namestring

Business name. Example: ABC Plumbing Co.

urlstring

Direct URL to the listing.

is_adboolean

Whether the business is sponsored.

categoriesstring

Comma-separated Yellow Pages categories. Example: Plumbers, Water Heater Repair

phonestring

Phone number. Example: (512) 555-0123

full_addressstring

Full formatted address.

street_addressstring

Street address.

citystring

City. Example: Austin

statestring

US state code. Example: TX

zip_codestring

ZIP code. Example: 78701

ratingfloat

Average customer rating. Example: 4.7

review_countinteger

Total customer reviews. Example: 89

years_in_businessinteger

Years operating.

opening_hoursstring

Opening hours rule.

websitestring

Business website. Example: https://abcplumbing.com

snippettext

Short snippet from the search page.

thumbnailstring

Thumbnail image URL.

Detail Fields

The following fields require results_details: true in settings.

latitudefloat

Latitude.

longitudefloat

Longitude.

emailstring

Email address on the business page.

descriptiontext

Full business description.

founding_datestring

Year founded.

photostext

Comma-separated list of business photo URLs.

facebookstring

Facebook page URL.

instagramstring

Instagram profile URL.

twitterstring

Twitter / X profile URL.

linkedinstring

LinkedIn page URL.

Response

200
{"total_results": 1, "data": [{"name": "ABC Plumbing Co.", "city": "Austin", "state": "TX", "phone": "(512) 555-0123", "rating": 4.7, "review_count": 89, "website": "https://abcplumbing.com"}]}