Business Listings
Business Listings API provides endpoints to list business listings for a location across connected directories and retrieve aggregated listing statistics. Note: endpoint paths use citations, the API term for directory listings.
List business listings
GET https://api.seranking.com/v1/local-marketing/locations/{location_id}/citations
Returns a list of business listings for a location across connected directories, including sync state and NAP (name, address, phone) consistency status. Note: the endpoint path uses citations, the API term for directory listings. Sorting is currently not applied by the upstream service for this endpoint (pending fix).
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| location_id | Integer | Yes | Location ID (path parameter). |
| limit | Integer | No | Maximum number of items to return (1–1000). Default is 100. |
| offset | Integer | No | Number of items to skip. Default is 0. |
| sort | String | No | Field to sort by. |
| sort_order | String | No | Sorting order: asc or desc. Default is desc. |
Request example
GET https://api.seranking.com/v1/local-marketing/locations/15/citations?limit=100&offset=0Response parameters
If successful, the server returns the 200 HTTP status code, an array of citations in items, and a pagination object. Returns HTTP 404 if the location is not found.
| Parameter | Type | Description |
|---|---|---|
| items | Array | List of citations. |
| id | Integer | Citation ID. |
| location_id | Integer | Location ID. |
| directory_code | String | Directory code. |
| directory_name | String | Directory name. |
| status | String | Listing status in the directory. |
| url | String | Listing URL (can be null). |
| is_synced | Boolean | Whether the listing is synchronized (can be null). |
| updated_at | String | Last update timestamp (can be null). |
| last_synced_at | String | Last synchronization timestamp (can be null). |
| sync_error | String | Synchronization error message (can be null). |
| nap_match_status | String | Overall NAP consistency status for the directory listing (can be null). |
| field_statuses | Object | Per-field match statuses: name, address, phone, website (each can be null). |
| pagination | Object | Pagination info: total, limit, offset. |
Response example
{
"items": [
{
"id": 301,
"location_id": 15,
"directory_code": "yelp",
"directory_name": "Yelp",
"status": "active",
"url": "https://yelp.com/biz/folk-osteria",
"is_synced": true,
"updated_at": "2026-08-01 10:00:00",
"last_synced_at": "2026-08-01 10:00:00",
"sync_error": null,
"nap_match_status": "matched",
"field_statuses": {
"name": "matched",
"address": "matched",
"phone": "matched",
"website": "matched"
}
},
{
"id": 302,
"location_id": 15,
"directory_code": "foursquare",
"directory_name": "Foursquare",
"status": "mismatched",
"url": "https://foursquare.com/v/folk-osteria",
"is_synced": false,
"updated_at": "2026-07-28 14:30:00",
"last_synced_at": "2026-07-20 09:00:00",
"sync_error": null,
"nap_match_status": "mismatched",
"field_statuses": {
"name": "matched",
"address": "mismatched",
"phone": "matched",
"website": null
}
}
],
"pagination": {
"total": 66,
"limit": 100,
"offset": 0
}
}Get business listings overview
GET https://api.seranking.com/v1/local-marketing/locations/{location_id}/citations/overview
Returns aggregated business listing statistics for a location: total, active, and synchronized directory counts. Counters reflect the current synchronization state. Note: the endpoint path uses citations, the API term for directory listings.
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| location_id | Integer | Yes | Location ID (path parameter). |
Request example
GET https://api.seranking.com/v1/local-marketing/locations/15/citations/overviewResponse parameters
If successful, the server returns the 200 HTTP status code and aggregated citation statistics. Returns HTTP 404 if the location is not found.
| Parameter | Type | Description |
|---|---|---|
| location_id | Integer | Location ID. |
| total_directories | Integer | Total number of directories. |
| active_directories | Integer | Number of active directories. |
| synced_directories | Integer | Number of synchronized directories. |
Response example
{
"location_id": 15,
"total_directories": 66,
"active_directories": 57,
"synced_directories": 49
}
