Yelp
Yelp is a website and app where people search for local businesses by name or category, read customer reviews with star ratings, and find a business's address, phone number, and hours.
Claiming and maintaining a Yelp business page normally means logging into Yelp for Business, verifying ownership, and editing the name, address, hours, or photos by hand every time something changes. Listings API automates that, letting you create, manage, and sync a Yelp listing through one unified API.
With a few API calls, you can publish a business to Yelp using details like business name, category, address, phone, website, and hours. Listings API lets you:
- Create a location and publish it to Yelp alongside every other citation on your plan.
- Update the business name, category, address, phone, website, or hours in a single call.
- Track publishing status and read the live listing URL once the Yelp page goes live.
What the API does on Yelp
Listing sync
Name, address, phone, hours, description, categories, website, and photos publish to Yelp from one canonical record. The same write updates the rest of your plan's network.
Publish status you can query
Per site publish state and live listing links are readable back through the API, so you can verify the Yelp listing from response instead of checking it manually.
Typed SDKs + MCP
Node.js and Python SDKs with full types, plus a hosted MCP server so agents and LLM tools can drive the same API.
Publish and sync your Yelp listing
curl -X POST https://listingsapi.com/api/v4/locations \
-H "Authorization: API $LISTINGSAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"name":"Acme Dental","description":"Acme Dental is a family-owned dental practice in downtown New York offering preventive care, cosmetic dentistry, orthodontics, and emergency appointments. The team pairs modern equipment with a gentle, patient-first approach, and same-week visits are available.","subCategoryId":1432,"street":"123 Jump Street","city":"New York","stateIso":"NY","postalCode":"10013","countryIso":"US","phone":"6443859313"}}'curl -X POST https://listingsapi.com/api/v4/locations/update \
-H "Authorization: API $LISTINGSAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"id":"TG9jYXRpb246MTgwMDI4OQ==","phone":"8073326999","street":"19 Trinity Enclave Main Rd"}}'curl https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/listings/premium \
-H "Authorization: API $LISTINGSAPI_KEY"Which plans include Yelp
Yelp is available on the Enterprise plan.
Yelp + Listings API
Can I reply to Yelp reviews through the API?
No. Yelp is listing sync only through Listings API. Review reading and review replies are available on Google and Facebook, so responses to Yelp reviews still have to be posted inside Yelp for Business, not through Listings API.
How do I add a business to Yelp with the API?
Call createLocation with the business name, category, address, phone, website, and hours. Because a Yelp listing already carries its own reviews and star rating once claimed, that single call keeps the surrounding business details matched to the page instead of recreating it, and Yelp publishes alongside every other citation on your plan.
How do I update my business's Yelp hours, address, or phone number?
Send the changed fields to updateLocation. One call pushes the new hours, address, or phone number to Yelp and to every other citation on your plan, so the details behind an existing Yelp page stay correct without touching the reviews or rating already posted there.
How long does it take for a new listing to reach Yelp, and how do I confirm it?
Publishing to Yelp runs asynchronously and typically clears within a few hours to a few days, updating the page's name, address, phone, and hours without touching its existing reviews or star rating. Call GET /api/v4/locations/{id}/listings/premium to confirm; it returns the live Yelp listing URL once the change lands.
Do I need a Yelp for Business account to publish through the API?
No. You authenticate every call with one Listings API key. Listings API syncs a business's citation details to Yelp, including name, address, phone, and hours, but it does not create or claim the Yelp for Business page itself; claiming a listing on Yelp stays with the business owner. Listings API is an independent service and is not affiliated with Yelp.
Are Yelp posts, offers, or events supported through the API?
No. Yelp is a review destination first, so what Listings API keeps accurate there is the citation record a customer matches a business against: name, address, and phone. Posts, offers, and events are supported on Google and Facebook only, not Yelp, and still need to be added inside Yelp for Business.
Can I see Yelp performance data or manage Yelp Ads through the API?
No. Yelp's own review activity and ad spend are not something Listings API reads. Analytics reads through Listings API cover Google, Bing, and Facebook only, so Yelp page views and Yelp Ads, Guest Manager, or Yelp Host performance stay inside Yelp for Business.
Which plan includes Yelp?
Yelp is included on the Enterprise plan, the tier built for sites like Yelp where the citation record has to line up with an already claimed, reviewed page. A location created under Enterprise publishes to Yelp automatically, and updateLocation keeps that record aligned afterward; Launch and Growth do not reach Yelp.
