CitySquares
CitySquares organizes businesses by location and category, and a listing there can be claimed and managed on its own profile page rather than edited from outside the site.
CitySquares gates a listing behind its own claim process and expects any update through that same profile page, separately from every other directory the business appears on. Listings API routes CitySquares through the same createLocation and updateLocation calls used for the rest of the plan, without requiring that claim step.
With a few API calls, you can publish a business to CitySquares using details like business name, category, address, phone, website, and hours. Listings API lets you:
- Create a location and publish it to CitySquares 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 CitySquares goes live.
What the API does on CitySquares
Listing sync
Name, address, phone, hours, description, categories, website, and photos publish to CitySquares 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 CitySquares 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 CitySquares 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 CitySquares
CitySquares is available on the Growth and Enterprise plans.
CitySquares + Listings API
How do I add a business to CitySquares with the API?
createLocation, called once with the business name, category, address, phone, website, and hours, is what publishes the location to CitySquares. It arrives there alongside every other citation on your plan, bypassing CitySquares' own listing form and claim process entirely, with no extra setup required.
How do I update a listing already live on CitySquares?
The location ID and the changed field, address, phone, or hours, go to updateLocation once, and CitySquares receives that same update alongside the rest of the plan's citations, with no manual edit on CitySquares' own profile page required at any point.
How long does publishing to CitySquares take, and how do I confirm it?
There is no instant turnaround: a CitySquares listing generally clears in a few hours to a few days once publishing starts. Calling GET /api/v4/locations/{id}/listings/premium is the way to check progress, and the per site status plus the live CitySquares URL come back in that same response.
Do I need to claim a business on CitySquares separately?
No. CitySquares runs its own claim process for listings managed directly on its site, but that step is not required through Listings API. You authenticate with one Listings API key, and Listings API is an independent service that is not affiliated with CitySquares.
Which plan includes CitySquares, and what is not supported?
CitySquares is included starting on the Growth plan, up through Enterprise, as part of the citation set covered at those tiers. Coverage there is listing sync only, since posts, review replies, and analytics remain specific to Google, Bing, and Facebook, not to this directory.
