Listings Management
Add listings management to your product. Publish a business once, distribute it to every directory in its plan, and read a verified sync status per citation.
curl https://listingsapi.com/api/v4/locations/8412/listings/premium -H "Authorization: API $LISTINGSAPI_KEY"
{
"data": { "listingsForLocation": [
{ "site": { "name": "Google", "url": "maps.google.com", "syScore": "98" },
"syncStatus": "SYNCED",
"displayStatus": "Synced",
"actionRequired": false,
"listingUrl": "https://maps.google.com/place/8412" },
{ "site": { "name": "Apple Maps", "url": "business.apple.com", "syScore": "84" },
"syncStatus": "IN_PROGRESS",
"displayStatus": "Submitting your details",
"actionRequired": false }
] }
} What you can build
Agency dashboards
Give each client one publish button that fans their business details out to all citations. Show a live status grid per citation so account managers can see what is live, what is submitting, and what needs a hand.
Local SEO inside your product
Add listing sync as a feature your own users configure without leaving your app. You store the location id, call update on any field change, and let the API re-sync every citation behind the scenes.
Verify Sync Status
Every directory reports its own syncStatus and a displayStatus, so you always know exactly where a listing stands.
A verified status per citation
| Citation | syncStatus | displayStatus | |
|---|---|---|---|
| Google Business Profile | SYNCED | Synced | listingUrl ↗ |
| REQUIRING_ACTION | Connect your account to sync | actionRequired | |
| Hotfrog | IN_PROGRESS | Submitted, awaiting response | |
| YellowPages | SYNCED | Synced | listingUrl ↗ |
From API key to live in four steps
Create the location
Post the business details once. The API creates the location and queues it for submission across your plan's citation network.
POST /api/v4/locationsEdit once, re-sync everywhere
Send only the fields that changed. A single update re-syncs every citation, so you never touch listings one directory at a time.
POST /api/v4/locations/updateRead per-citation status
Pull one record per citation with its site, sync state, and a human-readable label your UI can show directly.
syncStatus: SYNCED Resolve duplicates
List detected duplicates for a location, then mark each one as a duplicate or not a duplicate to keep the record clean.
GET /api/v4/locations/{id}/listings/duplicatesFAQs
How many citations does a single publish reach?
One create call queues the location for submission across your plan's full network of citations. The business data is submitted to all publisher sites that are included in your plan. Refer to https://www.listingsapi.com/network.
How do I check whether a listing is live on each citation?
Call GET /api/v4/locations/{id}/listings/premium, which returns one record per citation with a syncStatus enum. When a record reads SYNCED it is live, and its listingUrl gives you the public link to that citation.
How do I diagnose a citation that fails to sync?
Read the syncIssue field on the failing record for the reason, alongside syncStatus for the accurate state of that citation. A REQUIRING_ACTION status means the citation is waiting on a manual step, most often a disconnected account or an unverified profile. Inspect the action required and update the business data accordingly.
Can you import existing locations, or only create new ones?
Both. Connect a Google or Facebook account, then call POST /api/v4/connected-accounts/connected-account-listings to page through the listings that account already owns. Call POST /api/v4/connected-accounts/create-location-from-listing to import an existing location from the connected accounts, or POST /api/v4/connected-accounts/connect-listing to attach it to a location you already have.
Can I export all my data?
Yes. Every object is readable through the same REST API you write with. Page through GET /api/v4/locations or searchLocations using pageInfo.endCursor until hasNextPage is false to pull every location, then listingsForLocationPremium for the per citation record, plus the reviews, posts, and analytics endpoints for the rest.
Publish once, watch every citation report back
Create a location with one call, edit it with one more, and read a verified per-citation sync status for all citations.