docs / seo-toolkit

SEO Toolkit

Keyword ideas, rank tracking and SERP analysis.

base /seo-toolkit/v14 endpoints

post/seo-toolkit/v1/keyword_suggestions1 credit

Keyword ideas from Google/Bing autocomplete; depth=deep does alphabet-soup + question-prefix expansion (100s of ideas from one seed). 'url' derives the seed from a page's topic (keywords-by-URL); 'questions=true' returns PAA-style question keywords

Parameter		Allowed / range	Description
seed	optional	—	Seed keyword to expand into ideas. Provide seed OR url (url derives the seed from a page's topic).
url	optional	—	Page URL to derive the seed keyword from (keywords-by-URL). Used only when seed is absent.
source = google	optional	google · bing	Autocomplete provider. Any value other than 'bing' uses Google.
depth = standard	optional	shallow · standard · deep	Expansion breadth. An unrecognized value behaves like standard.
questions	optional	—	When true, also expand question prefixes and keep only question-style keywords (PAA-style). Accepts 1/true/yes.
hl = en	optional	—	UI/results language as an ISO-639 code (e.g. en, es, de).
gl = us	optional	—	Country as a 2-letter ISO-3166 code (e.g. us, gb, de).
limit = 300	optional	1–	Max number of de-duplicated suggestions to return.

Try in playground →

post/seo-toolkit/v1/rank_tracking2 credits

A domain's organic SERP position for a keyword (scans up to 100 results; retries on fresh IP)

Parameter		Allowed / range	Description
domain	required	—	Domain to find in the SERP (with or without www; subdomains match).
keyword	required	—	The search keyword to rank/analyze.
geo = us	optional	—	Country bias as a 2-letter ISO-3166 code (e.g. us, gb, de).
hl = en	optional	—	UI/results language as an ISO-639 code (e.g. en, es, de).
depth = 50	optional	10–100	How many SERP results to scan for the domain (10-100; clamped).

Try in playground →

post/seo-toolkit/v1/serp_competitors2 credits

Top domains ranking for a keyword (best position + appearances)

Parameter		Allowed / range	Description
keyword	required	—	The search keyword to rank/analyze.
geo = us	optional	—	Country bias as a 2-letter ISO-3166 code (e.g. us, gb, de).
hl = en	optional	—	UI/results language as an ISO-639 code (e.g. en, es, de).
num = 20	optional	10–100	How many SERP results to aggregate competitors from (10-100; clamped).

Try in playground →

post/seo-toolkit/v1/keyword_volume1 credit

Relative popularity ESTIMATE (0-100) from Trends interest + autocomplete signals + trend direction — confidence LOW; NOT absolute monthly volume

Parameter		Allowed / range	Description
keyword	required	—	The search keyword to rank/analyze.
geo = us	optional	—	Country bias as a 2-letter ISO-3166 code (e.g. us, gb, de).
hl = en	optional	—	UI/results language as an ISO-639 code (e.g. en, es, de).

Try in playground →

Example request · keyword_suggestions

curl -X POST https://api.reefapi.com/seo-toolkit/v1/keyword_suggestions \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"seed":"running shoes","depth":"shallow"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}