GoddsAPIFree API key
GoddsAPI Docs

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 checked

Example 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

NameTypeDefaultDescription
keywordrequiredstring—The search to check.
domainstring—Domain to find in organic results (subdomains count). Required unless business is set.
businessstring—Business name to find in the local pack (whole-word match). Required unless domain is set.
locationstring—Where the search comes from.
glstring—Country code.
hlstring—Language code.
devicedesktop | mobiledesktopDevice to emulate.
pagesinteger 1–31How deep to look (10 results per page). Stops early once found; you pay only for pages checked.
api_keystring—Your key, if you can't send the Authorization: Bearer header. Never logged.
no_cachebooleanfalsetrue 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
  }
}