JoomLocal
JoomLocal is an online business directory where people search for local businesses, showing each one with its name, address, phone, hours, and category.
Keeping a directory listing accurate usually means editing each location's data manually in JoomLocal's own interface, one business at a time, and repeating that work every time a detail changes. Listings API automates that, letting users create, manage, and sync JoomLocal listings through one unified API.
With just a few API calls, you can publish a business to JoomLocal using details like business name, category, address, phone, website, and hours. Listings API lets you:
- Create a location and publish it to JoomLocal 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 JoomLocal listing URL once it clears.
What the API does on JoomLocal
Listing sync
Name, address, phone, hours, description, categories, website, and photos publish to JoomLocal 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 JoomLocal 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 JoomLocal 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 JoomLocal
JoomLocal is available on every plan, starting with Launch.
JoomLocal + Listings API
How do I publish a business to JoomLocal through the API?
Send a createLocation call with the business name, address, phone, hours, and category. That single request publishes the location to JoomLocal along with the other citations your plan covers, so you never submit to the directory on its own. Use updateLocation afterward to change any of those fields.
How long does it take for a listing to appear on JoomLocal?
Publishing runs asynchronously. Once you submit, it can take anywhere from a few hours to a few days for the listing to go live on JoomLocal. Poll GET /api/v4/locations/{id}/listings/premium to watch the status move instead of refreshing the directory.
How do I confirm the listing actually went live?
Call GET /api/v4/locations/{id}/listings/premium. The response returns the per site publish status and, once JoomLocal accepts the update, the live listing URL, so you verify from the API response rather than searching the site manually.
Do I need a JoomLocal account or login to publish?
No. You do not register with JoomLocal or hold any credential there. One Listings API key authenticates every call, and Listings API is an independent service that is not affiliated with JoomLocal.
Can I update hours or category after the listing is published?
Yes. Pass the changed fields to updateLocation and Listings API pushes the revision out to JoomLocal. The same premium listings endpoint reports when the update clears and returns the current live URL.
Can I post updates or reply to reviews on JoomLocal through the API?
No. JoomLocal supports listing sync only. Posts and review replies are available on Google and Facebook, and analytics on Google, Bing, and Facebook; on JoomLocal the API keeps the core citation data accurate.
Which plan includes JoomLocal?
JoomLocal is included on every plan, starting with Launch. The same createLocation call that publishes to JoomLocal also publishes to the rest of the citations your plan covers.
