Skip to main content
POST
/
seo
/
serp
Live SERP lookup
curl --request POST \
  --url https://api.smartlyq.com/v1/seo/serp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keyword": "<string>",
  "location": "United States",
  "language": "en",
  "device": "desktop",
  "depth": 10
}
'
{
  "success": true,
  "data": {
    "results": [
      {
        "position": 1,
        "title": "Best SEO Tools (2026)",
        "url": "https://example.com/seo-tools",
        "description": "Compare the top SEO tools for 2026.",
        "domain": "example.com"
      }
    ],
    "keyword": "seo tools",
    "location": "United States",
    "serp_features": [
      "featured_snippet",
      "people_also_ask"
    ],
    "people_also_ask": [
      "What is the best SEO tool?",
      "Are SEO tools worth it?"
    ]
  },
  "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
keyword
string
required

Keyword to look up.

location
string
default:United States

Market location name.

language
string
default:en

Language code.

device
enum<string>
default:desktop

Device.

Available options:
desktop,
mobile
depth
integer
default:10

Number of results to fetch.

Required range: 1 <= x <= 100

Response

Organic SERP results plus SERP features

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