Merchants Nearby
Merchants Nearby is an online business directory where people search for local businesses close to them, listing each company's name, address, phone, and hours so nearby customers can find it.
Keeping a business accurate on a directory like Merchants Nearby normally means editing each location's name, address, phone, and hours manually, then repeating that work for every other site where the business appears. Listings API automates that, letting users create, manage, and sync Merchants Nearby listings through one unified API.
With just a few API calls, you can publish a business to Merchants Nearby using details like business name, category, address, phone, website, and hours. Listings API lets you:
- Create a location and publish it to Merchants Nearby alongside every other citation on your plan.
- Update business name, category, address, phone, website, or hours with a single call.
- Track publishing status and get the live listing URL once the update goes through.
What the API does on Merchants Nearby
Listing sync
Name, address, phone, hours, description, categories, website, and photos publish to Merchants Nearby 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 Merchants Nearby 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 Merchants Nearby 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 Merchants Nearby
Merchants Nearby is available on every plan, starting with Launch.
Merchants Nearby + Listings API
How do I publish a business to Merchants Nearby through the API?
Call createLocation with the business name, address, phone, and hours, and Listings API publishes it to Merchants Nearby along with the other citations on your plan. When something changes, call updateLocation with only the fields you want to edit and the revised data flows out the same way.
How do I update a location's hours or address on Merchants Nearby?
Send an updateLocation call carrying just the fields that changed, such as address, phone, or hours. Listings API pushes the update to Merchants Nearby and the other sites that location publishes to, so you edit once rather than site by site.
How long does it take for a listing to go live on Merchants Nearby?
Publishing runs asynchronously. Changes usually appear within a few hours, though some can take up to a few days depending on how the site processes them. You can watch progress with GET /api/v4/locations/{id}/listings/premium.
How do I confirm a listing actually published?
Call GET /api/v4/locations/{id}/listings/premium. The response returns the per site publish status for Merchants Nearby and the live listing URL once the update clears, so you verify straight from the response instead of loading the directory yourself.
Do I need a Merchants Nearby account or login to publish?
No. You do not register with Merchants Nearby or hold any credential there. A single Listings API key authenticates every call, and Listings API operates independently and is not affiliated with Merchants Nearby.
Can I publish posts or reply to reviews on Merchants Nearby?
No. Merchants Nearby supports listing sync only. Posts and review replies are available on Google and Facebook, and analytics on Google, Bing, and Facebook. On Merchants Nearby you create, update, and keep the core citation data accurate.
Which plan includes Merchants Nearby?
Merchants Nearby is included on every plan, starting with Launch. Once a location publishes, it reaches Merchants Nearby together with the other citations your plan covers.
