Local Marketing Audit
Local Marketing Audit API provides endpoints to retrieve the latest audit report and the audit report history for a location.
Get latest audit report
GET https://api.seranking.com/v1/local-marketing/locations/{location_id}/audit/reports/latest
Returns the latest Local Marketing audit report for a location. The response mirrors the report structure that drives the Local Marketing audit page: summary counters, per-check entries, previous issue counts, and optional directories/reviews payloads for checks with detailed drill-downs.
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| location_id | Integer | Yes | Location ID (path parameter). |
| date | String | No | Report date (in YYYY-MM-DD). If omitted, the latest finished report is returned. |
Request example
GET https://api.seranking.com/v1/local-marketing/locations/15/audit/reports/latest?date=2026-05-30Response parameters
If successful, the server returns the 200 HTTP status code and the audit report. Returns HTTP 404 if the location is not found.
| Parameter | Type | Description |
|---|---|---|
| status | String | Report generation status (e.g. finished). |
| date | String | Report date (in YYYY-MM-DD). |
| summary | Object | Summary counters. |
| summary.score | Integer | Overall audit score, 0–100 — the same value exposed as audit_score_percent/score_percent in the location endpoints (can be null). |
| summary.total_errors | Integer | Total number of errors. |
| summary.total_warnings | Integer | Total number of warnings. |
| summary.total_notices | Integer | Total number of notices. |
| entries | Array | Per-check entries. |
| check_code | String | Stable audit check code used by frontend translations and navigation. |
| category | String | Audit category used on the audit page (e.g. profile). |
| severity | String | Severity bucket: error, warning, or notice. |
| is_passed | Boolean | Deprecated compatibility field from the current frontend API. |
| result_status | String | Actual result status: passed, failed, or undefined. |
| issues_count | Integer | Number of issues found by the check (can be null). |
| issues_count_prev | Integer | Number of issues in the previous report (can be null). |
| weight | Float | Check weight in the overall score. |
| directories | Object | Directory drill-down for directory checks: failed, not_checked, new, fixed (arrays of directory codes). |
| reviews | Object | Review drill-down for review checks: failed, new, fixed (arrays). |
Response example
{
"status": "finished",
"date": "2026-05-30",
"summary": {
"score": 85,
"total_errors": 2,
"total_warnings": 5,
"total_notices": 3
},
"entries": [
{
"check_code": "nap_consistency",
"category": "listings",
"severity": "error",
"is_passed": false,
"result_status": "failed",
"issues_count": 3,
"issues_count_prev": 5,
"weight": 2.5,
"directories": {
"failed": ["foursquare", "hotfrog"],
"not_checked": [],
"new": [],
"fixed": ["yelp"]
}
},
{
"check_code": "unanswered_reviews",
"category": "reviews",
"severity": "warning",
"is_passed": false,
"result_status": "failed",
"issues_count": 8,
"issues_count_prev": 12,
"weight": 1.0,
"reviews": {
"failed": ["501", "502"],
"new": ["503"],
"fixed": []
}
}
]
}Get audit report history
GET https://api.seranking.com/v1/local-marketing/locations/{location_id}/audit/reports
Returns the audit report history for a location as date and summary pairs, sorted by date.
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| location_id | Integer | Yes | Location ID (path parameter). |
| start_date | String | No | History start date (in YYYY-MM-DD). |
| limit | Integer | No | Maximum number of items to return (1–1000). Default is 10. |
Request example
GET https://api.seranking.com/v1/local-marketing/locations/15/audit/reports?start_date=2026-05-01&limit=10Response parameters
If successful, the server returns the 200 HTTP status code and a top-level JSON array (not an object) of history items. Each item is itself a two-element array: the report date (in YYYY-MM-DD) followed by a summary object with the fields below. Returns HTTP 404 if the location is not found.
| Parameter | Type | Description |
|---|---|---|
| status | String | Report generation status. |
| score | Integer | Overall audit score, 0–100 — the same value as summary.score in the latest report (can be null). |
| total_errors | Integer | Total number of errors. |
| total_warnings | Integer | Total number of warnings. |
| total_notices | Integer | Total number of notices. |
Response example
[
[
"2026-05-30",
{
"status": "finished",
"score": 85,
"total_errors": 2,
"total_warnings": 5,
"total_notices": 3
}
],
[
"2026-05-23",
{
"status": "finished",
"score": 82,
"total_errors": 3,
"total_warnings": 6,
"total_notices": 3
}
]
]
