List sites
List your websites with each engine's attached primary property, sync freshness and search appearance breakdown.
https://api.rankparse.com/v1/rank-tracking/sitesFreeAPI keyLists every website in your workspace (archived websites are left out), with the primary property attached for each search engine enabled for your account and how fresh its stored data is. Use it to find the site_id that every other rank-tracking route takes.
This route takes no parameters.
Response
sitesarrayYour websites, oldest first. Empty when no engine is enabled for your account.
Show propertiesHide properties
site_idstringPass this as site_id to every other rank-tracking route.
canonical_hoststringThe website's host, for example example.com.
display_namestringThe website's display name.
providersobjectKeyed by google, bing and yandex. Only engines with an active primary property attached appear. A website with no attached property still appears, with providers: {}. A missing key means that engine is not connected or not attached, never a zero rank. See Engines and availability.
providers.*.enginestringgoogle, bing or yandex.
providers.*.property_idstringID of the attached primary property.
providers.*.property_urlstringThe property as the provider names it, for example https://example.com/ or sc-domain:example.com.
providers.*.is_activebooleanWhether the property is active. Only active properties are listed, so this is true.
providers.*.last_synced_atinteger | nullUnix time in milliseconds of the last sync, or null before the first one.
providers.*.data_as_ofstring | nullYYYY-MM-DD: the latest day the stored data covers, across the property's keywords.
providers.*.latest_sync_statusstring | nullStatus of the most recent sync run: queued, running, succeeded, partial or failed. null when no run exists.
providers.*.latest_sync_error_codestring | nullStable error code of the most recent run. Raw provider errors are never exposed.
providers.*.search_appearanceobject | nullThe property's most recent stored search appearance day: as_of_date and entries, each with appearance, clicks, impressions, ctr and position, ordered by impressions. null when it has never been synced (it comes from Google Search Console properties).
providers.*.connectionobject | nullThe connected account the property is read through: label (the account name or email) and status. null when the property is not bound to a connection, and always null for a client role.
Behavior and limits
- Credits: 0.
- Engines: only engines enabled for your account are considered. Bing and Yandex are opt-in.
- No pagination: every non-archived website is returned in one response.
Errors
| HTTP | Code | When |
|---|---|---|
| 401 | invalid_api_key | Missing, invalid or revoked API key. |
| 429 | rate_limited | More than 60 requests per minute for this key. |
Related
MCP tool: list_rank_tracking_sites (no arguments).