Yoys US
Yoys operates a network of business directories across more than fifty countries, and its United States edition at yoys.com lists companies for buyers who reach it through that network.
Every Yoys country edition uses the same setup flow: claim a business by hand or import it from an existing Google Business Profile inside the Yoys dashboard, then repeat the edit there whenever a detail changes. Listings API publishes and updates a business once, through the API, instead of inside a single country's Yoys dashboard.
A few API calls publish a business to Yoys with its name, category, address, phone, website, and hours. Listings API lets you:
- Create a location and publish it to the Yoys network alongside every other citation on your plan.
- Update the name, category, address, phone, website, or hours in a single call.
- Track the publish status and read back the live listing URL once it clears.
What the API does on Yoys US
Listing sync
Name, address, phone, hours, description, categories, website, and photos publish to Yoys US 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 Yoys US 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 Yoys 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 Yoys US
Yoys US is available on the Growth and Enterprise plans.
Yoys US + Listings API
How do I add a business to Yoys through the API?
Call createLocation with the business name, category, address, phone, website, and hours. That call publishes the location to Yoys along with the other citations on your plan, without a manual signup or a separate entry inside the Yoys dashboard itself.
How do I update a business already listed on Yoys?
Send the changed fields with updateLocation and the location ID returned when the location was created. One call updates Yoys along with the rest of your plan's citations, replacing what would otherwise be a manual edit inside the Yoys dashboard.
How long does publishing to Yoys take, and how do I confirm it?
Publishing is asynchronous and typically clears within a few hours to a few days, depending on how the directory processes new submissions. Call GET /api/v4/locations/{id}/listings/premium to get the per site status and the live listing URL once the update clears, alongside every other citation on your plan.
Do I need a Yoys account to publish through the API?
No. One Listings API key authenticates every call, and no account or password ever gets created on Yoys directly. Listings API is an independent service and is not affiliated with Yoys or its operator, so the directory never sees your Listings API credentials.
What is not supported on Yoys through the API?
Yoys supports listing sync only, included on the Growth and Enterprise plans alongside the rest of your citation network. Posts, review replies, and analytics are not available on Yoys; Listings API limits those features to Google and Facebook, plus Bing for analytics reads.
