Piloterr

Yellowpages Search

Search Yellow Pages businesses from a full search URL and retrieve names, phones, addresses, ratings, opening hours, and pagination via browser rendering.

Credit cost: 2 credits per call

GET
/v2/yellowpages/search

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 search URL.

Example 1 (category + city):

https://www.yellowpages.com/los-angeles-ca/plumbers

Example 2 (page 2):

https://www.yellowpages.com/los-angeles-ca/plumbers?page=2

Notes:

  • Only yellowpages.com search listing URLs are accepted.
  • Copy the full URL from yellowpages.com, including city slug, category, and ?page= for pagination.
  • Yellow Pages search pages are JavaScript SPAs; this endpoint uses website rendering to scrape business cards.
  • Pass each result's url to the Yellowpages Business endpoint for full profile data.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/yellowpages/search?query=string"
{
  "results": [
    {
      "url": "https://www.yellowpages.com/los-angeles-ca/mip/anawalt-lumber-13945594?lid=1002108313121",
      "name": "Anawalt Lumber",
      "phone": "(844) 699-3144",
      "postal_code": "90064",
      "rating_value": 4.8,
      "review_count": 5,
      "opening_hours": [
        "Mo-Fr 06:00-20:00",
        "Sa 08:00-20:00",
        "Su 09:00-18:00"
      ],
      "address_region": "CA",
      "street_address": "11060 W Pico Blvd",
      "address_country": "US",
      "address_locality": "Los Angeles"
    },
    {
      "url": "https://www.yellowpages.com/los-angeles-ca/mip/emergency-rooter-542379108?lid=1002116238752",
      "name": "Emergency Rooter",
      "phone": "(424) 252-2969",
      "postal_code": "90019",
      "rating_value": 4.5,
      "review_count": 2,
      "opening_hours": [
        "Mo-Su"
      ],
      "address_region": "CA",
      "street_address": "1319 S La Brea Ave",
      "address_country": "US",
      "address_locality": "Los Angeles"
    },
    {
      "url": "https://www.yellowpages.com/los-angeles-ca/mip/rooter-star-546734508?lid=1002194168683",
      "name": "Rooter Star",
      "phone": "(888) 574-3053",
      "postal_code": "90019",
      "rating_value": 4.33,
      "review_count": 3,
      "address_region": "CA",
      "street_address": "1319 S La Brea Ave",
      "address_country": "US",
      "address_locality": "Los Angeles"
    }
  ],
  "pagination": {
    "next": 2,
    "current": 1,
    "next_url": "https://www.yellowpages.com/los-angeles-ca/plumbers?page=2",
    "per_page": 30,
    "other_pages": [
      2,
      3,
      4,
      5
    ],
    "total_count": 1401,
    "total_pages": 47,
    "has_next_page": true
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}