Local Citations API
**Local Citations Submission API - Submit Your Business To 50+ Listings Sites** - REST APIs for Local Search Citations, Reviews, Analytics and Posts. Manage and sync accurate business listings across Google, Apple Maps Bing, Facebook, and dozens of directories from one REST API. Automate local citations, keep NAP data consistent everywhere, and power local SEO at scale.
Local Citations API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Locations | ||
| GET |
List Of Supported Countries /api/v4/countries |
Returns every country Listings API supports along with its states/provinces and the ISO codes used when creating or updating locations. |
| GET |
List Of Business Categories /api/v4/sub-categories |
Returns the full catalog of subcategories used to classify locations when creating or updating them. |
| POST |
Add New Business Location /api/v4/locations |
Creates a new business location in your account and queues it for listing submission. |
| POST |
Location Information Update /api/v4/locations/update |
Updates writable fields on an existing location. Only the fields you send are changed. |
| GET |
Search For An Existing Locations /api/v4/locations/search |
Returns a cursor-paginated list of locations matching a keyword, searchable by name, address, or store ID. |
| GET |
Search Locations By StoreCodes /api/v4/locations-by-store-codes |
Returns full location details for one or more locations identified by their store codes. |
| GET |
Search Location By ID /api/v4/locations-by-ids |
Returns full location information for a specified set of location IDs in one request. |
| GET |
Search All Locations /api/v4/locations |
Returns a cursor-paginated list of locations in your account. |
| POST |
Upload Images to A Business Location /api/v4/locations/photos |
Attaches media to a location, either by public image URL or by referencing files already in your media library. |
| POST |
Star An Image of A Location /api/v4/locations/photos/star |
Marks one or more of a location's additional photos as favourites for priority placement on supported publishers. |
| GET |
All Images Of A Location /api/v4/locations/{locationId}/photos |
Returns all media files attached to a single location, including starred and unstarred photos. |
| GET |
Image Upload Request Status /api/v4/locations/photos/requests/{requestId} |
Returns the current processing status for a bulk photo upload request. |
| POST |
Remove Image From A Location /api/v4/locations/photos/remove |
Detaches one or more media files from a location by their media IDs. |
| POST |
Archive Locations. /api/v4/locations/archive |
Schedules one or more locations for archival at the end of the current billing cycle. Locations cannot be archived within the first 90 days of its creation. |
| POST |
Cancel Archival Of Locations. /api/v4/locations/cancel_archive |
Cancels a pending archival for locations in ARCHIVE_SCHEDULED status, restoring them to active. |
| Listings | ||
| GET |
Fetch Citations/Listings Of A Location /api/v4/locations/{locationId}/listings/premium |
Returns the sync status of every publisher directory in a location's plan. |
| GET |
Voice Assistants Citation Status Of A Location /api/v4/locations/{locationId}/voice-assistants |
Returns the voice assistant listing sync status for a location across Google Assistant, Alexa, Siri, Cortana, and Bixby. |
| GET |
Duplicate Listings For A Location /api/v4/locations/{locationId}/listings/duplicates |
Returns duplicate listing entries detected for a single location, grouped by publisher site. |
| POST |
Flag Duplicate Listings /api/v4/locations/listings/mark-as-duplicate |
Flags one or more detected listing items as confirmed duplicates so Listings API can suppress them. |
| POST |
Mark Non Duplicate Listings /api/v4/locations/listings/mark-as-not-duplicate |
Dismisses one or more potential duplicates as false positives so they stop appearing in the duplicates list. |
| Connected Accounts | ||
| POST |
Connect GMB Account /api/v4/connected-accounts/connect-google |
Returns an OAuth URL to link a Google Business Profile account to your Listings API account. Update the success and error URLs as per your requirement. |
| POST |
Connect Facebook Account /api/v4/connected-accounts/connect-facebook |
Returns an OAuth URL to link a Facebook Pages account to your Listings API account. |
| GET |
Connected Account Details /api/v4/connected-accounts/{connectedAccountId}/details |
Returns the details of a single connected Google or Facebook account by its ID. |
| GET |
Connected Accounts Status /api/v4/connected-accounts |
Returns the Google and Facebook accounts connected to your Listings API account, with connection health and linked-location counts. |
| POST |
Create New Google Business Profile /api/v4/locations/create/gmb-listing |
Creates a new Google Business Profile listing for an existing Listings API location and links it to a connected Google account. |
| GET |
Connected Accounts Suggested Matches /api/v4/connected-accounts/{connectedAccountId}/connection-suggestions |
Returns suggested matches between Listings API locations and Google Business Profile or Facebook listings for a connected account. |
| POST |
Confirm Suggested Matches /api/v4/connected-accounts/confirm-matches |
Confirms suggested location-to-listing matches returned by the connection suggestions endpoint. |
| POST |
Connected Accounts Trigger Matches /api/v4/connected-accounts/trigger-matches |
Fetches the Google and Facebook profiles for connected accounts and matches them against your Listings API locations. |
| POST |
Listings On A Connected Account /api/v4/connected-accounts/connected-account-listings |
Returns the Google Business Profile or Facebook listings accessible to a connected account, with optional filtering and pagination. |
| POST |
Connect Specific Listing /api/v4/connected-accounts/connect-listing |
Links a specific Google Business Profile or Facebook listing to a Listings API location. |
| GET |
Folders Under Google Business Account /api/v4/connected-accounts/{connectedAccountId}/folders |
Returns the Google Business Profile folders (groups) accessible to a connected Google account. |
| POST |
Import Location From Connected Account. /api/v4/connected-accounts/create-location-from-listing |
Creates a new location from an existing Google Business Profile or Facebook listing in a connected account. |
| POST |
Disconnect Connected Location /api/v4/connected-accounts/disconnect-listing |
Unlinks the connected Google or Facebook listing from one or more Listings API locations. |
| POST |
Disconnect Google Business Account /api/v4/connected-accounts/disconnect-google |
Disconnects a connected Google Business Profile account (or specific locations under it) from your Listings API account. |
| POST |
Facebook Account Disconnect /api/v4/connected-accounts/disconnect-facebook |
Disconnects a previously connected Facebook Pages account from your Listings API account. |
| Reviews | ||
| GET |
Review Records By Id /api/v4/reviewDetails |
Returns full Review objects for a specific set of interaction IDs. |
| GET |
List Of Reviews For A Location /api/v4/locations/{locationId}/reviews |
Returns a cursor-paginated list of reviews and social interactions for a single location, with filters. |
| GET |
Rollup Reviews /api/v4/rollup_interactions |
Returns a cursor-paginated list of interactions across many locations in the account, with filtering and sorting. |
| POST |
Respond To A Review /api/v4/locations/reviews/respond |
Posts a public response to a review or interaction on its source platform. **Common errors** - SY50121 — Google Reviews accept only a single owner reply per review; a second… |
| POST |
Edit Review Response /api/v4/locations/reviews/respond/edit |
Edits a previously posted response on a review or interaction. |
| POST |
Archive A Review Response /api/v4/locations/reviews/respond/archive |
Archives an existing owner response, removing it from the active responses tracked for an interaction. |
| Posts | ||
| POST |
Create Announcement Posts /api/v4/posts |
Creates an ANNOUNCEMENT post and publishes it to the chosen sites ["GOOGLE", "FACEBOOK"] for Business location. |
| POST |
Create Bulk Post /api/v4/bulk-posts |
Creates one social post and publishes it across many locations in a single request. |
| GET |
List Of Posts For A Locations /api/v4/locations/{locationId}/posts |
Returns a page of post campaigns (announcements, events, offers) that target a single location. |
| GET |
List Of Bulk Posts By Location IDs /api/v4/locations/{locationId}/bulk-posts |
Returns a page of bulk post campaigns that include a single location. |
| GET |
Search By Post ID /api/v4/posts/{postId} |
Returns a single social post campaign with its content, per-site publish status, and engagement analytics. |
| GET |
Search Multi Channel Post By ID /api/v4/bulk-posts/{postId} |
Returns a single bulk (multi-location) post campaign with its content, per-location publish status, and engagement analytics. |
| DELETE |
Delete A Post /api/v4/posts/{postId} |
Permanently deletes a social post campaign and removes it from every site it was published to. |
| Analytics | ||
| GET |
GoogleMyBusiness Analytics /api/v4/locations/{locationId}/google-analytics |
Returns daily Google Business Profile interaction metrics for a location over a date range. |
| GET |
Facebook Analytics /api/v4/locations/{locationId}/facebook-analytics |
Returns daily Facebook Page interaction metrics for a location over a date range. |
Local Citations API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| PRO | $119 / month | 10 / minute |
|
| ULTRA | $599 / month | 50 / minute |
|