Piloterr

Yellowpages Business

Extract a full Yellow Pages business profile from a listing URL, including phone, website, categories, and ratings via browser rendering.

Credit cost: 2 credits per call

GET
/v2/yellowpages/business

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Full Yellow Pages business listing URL.

Example:

https://www.yellowpages.com/los-angeles-ca/mip/anawalt-lumber-13945594?lid=1002108313121

Notes:

  • Only /mip/ business profile URLs on yellowpages.com are accepted.
  • Query parameters such as ?lid= are supported.
  • Business profile pages are JavaScript SPAs; this endpoint uses website rendering to extract phone, website, categories, and ratings.
  • Copy the listing URL from search results or from yellowpages.com.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/yellowpages/business?query=string"
{
  "name": "Ritz Plumbing Heating, Air & Electrical",
  "phone": "323 452-4915",
  "rating": "five",
  "address": "1355 S La Brea Ave, Los Angeles, CA 90019",
  "website": "http://www.ritzplumbinginc.org",
  "categories": [
    "Plumbers",
    "Air Conditioning Contractors & Systems",
    "Air Conditioning Service & Repair",
    "Plumbers",
    "Air Conditioning Contractors & Systems",
    "Air Conditioning Service & Repair",
    "Building Contractors",
    "Building Contractors-Commercial & Industrial",
    "Electricians",
    "Furnace Repair & Cleaning",
    "Furnaces-Heating",
    "Heating Contractors & Specialties",
    "Heating Equipment & Systems",
    "Plumbing Contractors-Commercial & Industrial",
    "Plumbing-Drain & Sewer Cleaning",
    "Sewer Contractors",
    "Water Heaters"
  ],
  "rating_count": 3
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}