WhereTo
WhereTo is a local search service where people look up businesses and places, surfacing each one with its name, address, phone, and hours.
Keeping a WhereTo listing accurate usually means editing each location's data manually and repeating that same work every time a number, an address, or a set of hours changes. Listings API automates that, letting users create, manage, and sync WhereTo listings through one unified API.
With just a few API calls, you can publish a business to WhereTo using details like business name, category, address, phone, website, and hours. Listings API lets you:
- Create a location and publish it to WhereTo along with every other citation on your plan.
- Update the business name, category, address, phone, website, or hours with a single call.
- Track publishing status and get the live listing URL once your update clears.
What the API does on WhereTo
Listing sync
Name, address, phone, hours, description, categories, website, and photos publish to WhereTo 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 WhereTo 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 WhereTo 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 WhereTo
WhereTo is available on every plan, starting with Launch.
WhereTo + Listings API
How do I publish a business to WhereTo through the API?
Call createLocation with the business name, category, address, phone, website, and hours. That one call publishes the location to WhereTo and to every other citation site your plan covers, so you do not submit to WhereTo separately.
Can I update a WhereTo listing after it is live?
Yes. Call updateLocation with the fields you want to change, such as a new phone number or revised hours, and Listings API syncs the update out to WhereTo. You edit the location once instead of touching the listing directly.
How long does it take for a listing to show up on WhereTo?
Publishing is asynchronous. A new or updated listing typically clears within a few hours, though it can take up to a few days depending on the site. Your API call returns right away, and the listing goes live once WhereTo processes it.
How do I verify that my listing is live on WhereTo?
Call GET /api/v4/locations/{id}/listings/premium. It returns the per site publish status for the location and the live WhereTo listing URL once the update clears, so you confirm from the response rather than searching for the listing yourself.
Do I need a WhereTo account or API credentials?
No. You authenticate every call with a single Listings API key and never register with WhereTo or hold WhereTo credentials. Listings API is an independent service and is not affiliated with WhereTo.
Which plan includes WhereTo?
WhereTo is included on every plan, starting with Launch. Any location you publish is sent to WhereTo as part of the citation set your plan covers.
Can I publish posts or reply to reviews on WhereTo through the API?
No. WhereTo supports listing sync only. Posts and review replies are available only on Google and Facebook, and analytics are available only on Google, Bing, and Facebook.
