Skip to main content
POST
/
seo
/
rank-history
Historical rank overview
curl --request POST \
  --url https://api.smartlyq.com/v1/seo/rank-history \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target": "<string>",
  "location": "United States",
  "language": "en"
}
'
{
  "success": true,
  "data": {
    "target": "example.com",
    "history": [
      {
        "year": 2026,
        "month": 5,
        "organic_keywords": 11800,
        "organic_etv": 44210.3
      },
      {
        "year": 2026,
        "month": 6,
        "organic_keywords": 12500,
        "organic_etv": 48230.7
      }
    ]
  },
  "meta": {
    "request_id": "req_1a2b3c4d",
    "timestamp": "2026-07-01T12:00:00Z"
  }
}

Authorizations

Authorization
string
header
required

API key from Developer dashboard (Bearer token).

Body

application/json
target
string
required

Domain to inspect, e.g. example.com.

location
string
default:United States

Market location name.

language
string
default:en

Language code.

Response

Historical rank overview

success
enum<boolean>
Available options:
true
data
object
meta
object