Your Town VIP
Your Town VIP is an online directory where local shoppers browse and discover businesses in their town, listing each one with its name, address, phone, hours, and category.
Keeping a business current on a local directory like Your Town VIP usually means editing each location's citation fields manually, one profile at a time, and redoing that work every time a phone number or a set of hours changes. Listings API automates that: users create, manage, and sync Your Town VIP listings through one unified API.
With just a few API calls, you can publish a business to Your Town VIP using details like business name, category, address, phone, website, and hours. Listings API lets you:
- Create a location and publish it to Your Town VIP 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 pull the live listing URL once it goes live.
What the API does on Your Town VIP
Listing sync
Name, address, phone, hours, description, categories, website, and photos publish to Your Town VIP 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 Your Town VIP 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 Your Town VIP 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 Your Town VIP
Your Town VIP is available on the Growth and Enterprise plans.
Your Town VIP + Listings API
How do I publish a business to Your Town VIP through the API?
Call createLocation with the business name, address, phone, hours, and category, and Listings API adds Your Town VIP to the citations it publishes for that location. To change anything afterward, send updateLocation with the fields you want revised. Both calls are REST, so a single request reaches Your Town VIP and every other site on your plan at once.
How long does a listing take to go live, and how do I confirm it?
Publishing is asynchronous. A new listing or an edit usually appears within a few hours, though some updates take up to a few days depending on the directory. Call GET /api/v4/locations/{id}/listings/premium to read the per site status and grab the live Your Town VIP URL once it clears.
Do I need a Your Town VIP account or login to publish?
No. You authenticate with one Listings API key and never register or sign in on Your Town VIP yourself. Listings API is an independent service and is not affiliated with Your Town VIP; it handles the submission on your behalf.
Which plan includes Your Town VIP?
Your Town VIP is included on the Growth and Enterprise plans. Once your plan covers it, any location you publish is submitted there automatically, together with the other citations in the plan.
Can I post updates or reply to reviews on Your Town VIP through the API?
No. Your Town VIP supports listing sync only. Posts and review replies are available through Listings API on Google and Facebook, and analytics are available on Google, Bing, and Facebook.
How do I keep a business's hours and phone number accurate on Your Town VIP?
Send updateLocation with the new values and Listings API pushes the change to Your Town VIP the same way it published the original citation, so you never edit the directory profile directly. Then check GET /api/v4/locations/{id}/listings/premium to confirm the update reached the site.
What fields does a Your Town VIP listing use?
Your Town VIP carries the standard citation fields: business name, address, phone, hours, and category. Supply these in your createLocation call and they map to the directory listing. If any of them change later, one updateLocation request keeps the profile in sync.
