US City
US City tracks trending local businesses city by city across states like Ohio, California, and Florida, pairing each listing with its address, phone number, hours, and directions.
US City surfaces trending local businesses on a city-by-city basis, and getting a listing right there means editing the profile directly in the directory, then redoing that work whenever the name, address, phone, or hours shift. Listings API takes over that manual work, creating, updating, and syncing the US City listing through one unified API.
With just a few API calls, you can publish a business to US City using details like business name, category, address, phone, website, and hours. Listings API lets you:
- Create a location and publish it to US City 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 US City goes live.
What the API does on US City
Listing sync
Name, address, phone, hours, description, categories, website, and photos publish to US City 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 US City 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 US City 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 US City
US City is available on every plan, starting with Launch.
US City + Listings API
How do I add a business to US City with the API?
One createLocation call carrying the business name, category, address, phone, website, and hours publishes the listing to US City together with every other citation on the plan, so there's no separate trending-directory form to complete on the site afterward, of any kind.
How long does publishing to US City take, and how do I confirm it?
US City typically reflects a new or changed listing within a few hours to a few days. To check without visiting the site, call GET /api/v4/locations/{id}/listings/premium and read the publish status and live listing URL directly from the response once it's ready.
Do I need a US City account to publish a listing?
No signup on US City is needed. Every call runs on one Listings API key, and the listing is generated from that data instead of a form on the site. Listings API is an independent service and is not affiliated with US City.
How do I update a business's hours or address on US City?
Send whichever fields changed, hours, address, or otherwise, to updateLocation, and that single request rewrites the US City entry along with every other citation on the plan, keeping the trending listing aligned with the source record instead of the directory's own cached copy.
Can I publish posts or manage review replies on US City?
US City stays limited to the sync fields inside Listings API: name, category, address, phone, website, and hours. The posting and review reply tools only work against Google and Facebook profiles, with analytics restricted to that same pair plus Bing, none of which touches a US City listing.
Which plan includes US City?
US City is part of the citation set on every plan, starting with Launch, so no upgrade is needed to reach it. A created location publishes there automatically alongside the rest of the directories that plan covers, without any extra request.
