Rank check
Where a domain or business ranks for a keyword: its organic position and its local-pack position, each null when not found.
GET /api/v1/rankCost: 1 per page actually checkedExample request
curl -G "https://goddsapi.com/api/v1/rank" \ -H "Authorization: Bearer YOUR_API_KEY" \ --data-urlencode "keyword=plumber chicago" \ --data-urlencode "domain=example-plumbing.com" \ --data-urlencode "business=Example Plumbing" \ --data-urlencode "location=Chicago, Illinois, United States"
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
keywordrequired | string | — | The search to check. |
domain | string | — | Domain to find in organic results (subdomains count). Required unless business is set. |
business | string | — | Business name to find in the local pack (whole-word match). Required unless domain is set. |
location | string | — | Where the search comes from. |
gl | string | — | Country code. |
hl | string | — | Language code. |
device | desktop | mobile | desktop | Device to emulate. |
pages | integer 1–3 | 1 | How deep to look (10 results per page). Stops early once found; you pay only for pages checked. |
api_key | string | — | Your key, if you can't send the Authorization: Bearer header. Never logged. |
no_cache | boolean | false | true forces a fresh search (charged). Otherwise identical queries within your plan's cache window are served free. |
Example response
Shortened to one item per list.
{
"search_metadata": {
"id": "srch_3f9c0d7b2a41e6c8d5b19a70",
"status": "success",
"api_version": "v1",
"endpoint": "rank",
"provider": "serpapi",
"cached": false,
"credits_charged": 1,
"time_taken_ms": 1840,
"created_at": "2026-11-20T15:04:05.000Z"
},
"search_parameters": {
"endpoint": "rank",
"keyword": "plumber chicago",
"domain": "example-plumbing.com",
"business": "Example Plumbing",
"device": "desktop",
"pages": 1
},
"rank": {
"organic": {
"position": 4,
"link": "https://www.example-plumbing.com/",
"title": "Example Plumbing — 24/7 Chicago Plumbers"
},
"local_pack": {
"position": 1,
"name": "Example Plumbing",
"place_id": "10140420633749198317"
},
"checked_results": 10,
"pages_checked": 1
}
}