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
Authentification
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Paramètres de requête
query*string
Full Yellow Pages search URL.
Example 1 (category + city):
https://www.yellowpages.com/los-angeles-ca/plumbersExample 2 (page 2):
https://www.yellowpages.com/los-angeles-ca/plumbers?page=2Notes:
- Only
yellowpages.comsearch 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
urlto the Yellowpages Business endpoint for full profile data.
Corps de la réponse
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.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"}