YpListing
YpListing gathers local business listings from states including Texas, Illinois, and Georgia into browsable categories like legal services, dentists, and hair salons, each entry showing address, phone, hours, and website.
Each YpListing entry sorts into a yellow-pages style category page, and getting one right by hand means logging into the site to fix the name, address, or hours after every change, then hoping the edit sticks. Listings API takes that manual work off your hands, creating, updating, and syncing the YpListing listing through one unified API.
With just a few API calls, you can publish a business to YpListing using details like business name, category, address, phone, website, and hours. Listings API lets you:
- Create a location and publish it to YpListing 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 YpListing goes live.
What the API does on YpListing
Listing sync
Name, address, phone, hours, description, categories, website, and photos publish to YpListing 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 YpListing 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 YpListing 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 YpListing
YpListing is available on every plan, starting with Launch.
YpListing + Listings API
How do I add a business to YpListing with the API?
createLocation accepts the business name, category, address, phone, website, and hours, and that single call publishes the record to YpListing together with every other citation on the plan, leaving no separate yellow-pages form to submit anywhere on the site at all.
How long does publishing to YpListing take, and how do I confirm it?
Give YpListing a few hours to a few days to pick up a new or updated listing. Instead of checking the page directly, call GET /api/v4/locations/{id}/listings/premium, which reports the publish status and returns the live listing URL once it clears.
Do I need a YpListing account to publish a listing?
YpListing doesn't require its own signup. What authenticates the request is a single Listings API key, and the listing draws directly from your Listings API data instead of anything typed into a form on the yellow pages site. Listings API is an independent service and is not affiliated with YpListing.
How do I update a business's hours or address on YpListing?
Whichever fields changed, hours, address, or otherwise, go into one updateLocation call, and that request rewrites the YpListing entry plus every other citation on the plan, so the directory listing doesn't lag behind the source record for more than a sync cycle.
Can I publish posts or manage review replies on YpListing?
YpListing's integration covers the sync fields only, name, category, address, phone, website, and hours. Posts get published and reviews get answered only through Google and Facebook connections, while analytics pulls only from that pair plus Bing; YpListing sits outside all three of those capabilities.
Which plan includes YpListing?
YpListing is included starting on the Launch plan, so every tier covers it. A created location publishes there automatically as part of the standard citation set the plan provides, without any separate request for this directory or additional setup at any point.
