Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each Yelp action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Search Yelp for local businesses in a city or ZIP code, up to 50 per call, with rating, review count, price tier, categories, contact details, hours and claim status. | $1.39 per 1,000 requests | Normal |
Detailsprofile | Open a Yelp business page from its /biz/ link and get rating, price tier, categories, contact details, address, hours, amenities, highlights and photos. | $1.39 per 1,000 requests | Normal |
Reviewsreviews | Read Yelp reviews of one business, 10 per page, with text, rating, date, author, photo count and useful, funny and cool votes. | $1.39 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each Yelp action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search Yelp for local businesses in a city or ZIP code, up to 50 per call, with rating, review count, price tier, categories, contact details, hours and claim status. Always set | keyword | location | Sync delivery | Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · name · url · rating · rating_scale · review_count · price_range · phone · website · categories · cuisine · description · address · city · region · postal_code · country · is_claimed · is_verified · health_score · established_year · image_url · platform · images · amenities · highlights · hours |
profileDetails Open a Yelp business page from its /biz/ link and get rating, price tier, categories, contact details, address, hours, amenities, highlights and photos. An unclaimed page, shown by | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · name · url · rating · rating_scale · review_count · price_range · phone · website · categories · cuisine · description · address · city · region · postal_code · country · is_claimed · is_verified · health_score · established_year · image_url · platform · images · amenities · highlights · hours |
reviewsReviews Read Yelp reviews of one business, 10 per page, with text, rating, date, author, photo count and useful, funny and cool votes. Pass | url | page_token | Sync delivery | Catalog values: defaultLimit=10, maxLimit=10. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. A larger limit is accepted and capped at 10. For the next page, pass next_page_token back as page_token with the other parameters unchanged; each page is one call. | $1.39 per 1,000 requests | id · text · rating · rating_scale · posted_at · author_name · useful_count · funny_count · cool_count · photo_count · business_name · business_url · platform |
What do the Yelp search parameters mean?
Search Yelp for local businesses in a city or ZIP code, up to 50 per call, with rating, review count, price tier, categories, contact details, hours and claim status. Always set location, because the search otherwise defaults to New York; health_score appears for restaurants only.
keywordRequired- Defines local business or service search terms (e.g., coffee) for the Yelp search action. To avoid defaulting to New York, pair this parameter with an explicit location.
locationOptional- Sets the city, neighborhood, or postal code for the business search, such as Austin, TX or 78701. It describes the business location, not the review author's location.
What do the Yelp profile parameters mean?
Open a Yelp business page from its /biz/ link and get rating, price tier, categories, contact details, address, hours, amenities, highlights and photos. An unclaimed page, shown by is_claimed, may hold outdated details, and nothing here proves ownership or licensing.
urlRequired- Accepts a Yelp business URL featuring a /biz/ slug for the profile and reviews actions to fetch business metadata or user reviews. User profile links are not supported.
What do the Yelp reviews parameters mean?
Read Yelp reviews of one business, 10 per page, with text, rating, date, author, photo count and useful, funny and cool votes. Pass next_page_token back as page_token for the next page; tokens last 24 hours.
urlRequired- Accepts a Yelp business URL featuring a /biz/ slug for the profile and reviews actions to fetch business metadata or user reviews. User profile links are not supported.Yelp: Relationship Between Unrecommended Reviews and Overall Ratings — Yelp states that currently unrecommended reviews are not calculated into a business's overall star rating or review count; therefore, any scraped sample's item count and average score cannot be directly represented as official site aggregate metrics. · Checked
page_tokenOptional- Pagination token: pass back next_page_token from the previous response to get the next page; omit it for the first page. Keep every other parameter unchanged. Tokens last 24 hours and each page is one call.
How to use the Yelp API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"yelp","action":"search","params":{"keyword":"<keyword>"}}'
Yelp API questions
What can I retrieve with the Yelp API?
Set platform to yelp. The current catalog lists search, details, and reviews. These action names identify different Yelp objects or views; they are not interchangeable search modes.
Which input starts a Yelp `search` request?
Defines local business or service search terms (e.g., coffee) for the Yelp search action. To avoid defaulting to New York, pair this parameter with an explicit location. Send it as keyword inside params.
Which fields can Yelp `search` return?
Its declared schema includes name, rating, rating_scale, and review_count. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every Yelp action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.