Piloterr

Yelp Business

Fetch a Yelp business profile from a full business URL with phone, address, website, logo, hours, and claim status.

Credit cost: 2 credits per call

GET
/v2/yelp/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 Yelp business URL.

Example:

https://www.yelp.com/biz/novela-san-francisco-2

Use an organic /biz/ link from Yelp Search results.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/yelp/business?query=string"
{
  "url": "https://www.yelp.com/biz/novela-san-francisco-2?osq=bars+open&rr=4",
  "logo": "https://s3-media0.fl.yelpcdn.com/businessregularlogo/dkB_F32_r_PfLpQLAuNsFA/ms.jpg",
  "name": "Novela",
  "phone": "(415) 896-6500",
  "address": "662 Mission St San Francisco, CA 94105",
  "website": "novelasf.com",
  "open_hours": {
    "fri": "4:00 PM - 2:00 AM (Next day)",
    "mon": "4:00 PM - 12:00 AM (Next day)",
    "sat": "5:00 PM - 2:00 AM (Next day)",
    "sun": "Closed",
    "thu": "4:00 PM - 2:00 AM (Next day)",
    "tue": "4:00 PM - 1:00 AM (Next day)",
    "wed": "4:00 PM - 1:00 AM (Next day)"
  },
  "business_id": "cX5dOMkwZ5rqWbeIJpw_Ig",
  "claim_status": "claimed"
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}