Synup
Create a key
v1Resources/SEO/getGet competitor rank trends over time

Get competitor rank trends over time

Returns each competitor's average rank per month across this location's tracked ranking history (up to the last 12 measured months), for the rank-trend chart. Includes your own business (isYou).

get/api/v1/seo/competitors/trends
seo:read
Query parameters
locationIdstringrequired
The location to look up.
clientIdstringoptional
The location's client.
Response
dataobjectoptional
monthsarray of stringoptional
Months covered, oldest first (YYYY-MM).
competitorsarray of objectoptional
One series per competitor (plus your own business), aligned to months.
placeIdstringoptional
An identifier for this business (its place ID, or a derived key).
namestringoptional
Business name.
isYoubooleanoptional
Whether this series is your own business.
monthlyarray of numberoptional
Average rank for each month in months; null where this business wasn't observed that month.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/seo/competitors/trends
Your API key
locationId *
clientId
{
  "data": {
    "months": [
      "2026-01",
      "2026-02"
    ],
    "competitors": [
      {
        "placeId": "ChIJtXC2rwgF9YgRNh1YJHlA4vQ",
        "name": "Acme Dental — Downtown",
        "isYou": true,
        "monthly": [
          5.1,
          4.2
        ]
      }
    ]
  }
}

Guides that use this resource