CrawlForge
SEODataForSEO5 credits

serp_rank

Check where a domain ranks in Google's organic results for a keyword — the real SERP position, not Custom Search order. Returns the target's organic rank, the ranking URL, and every position it holds. Powered by DataForSEO.

Use Cases

Keyword Rank Tracking

Monitor where your pages rank for target keywords over time and catch ranking drops early

Competitor SERP Monitoring

Track how competitor domains rank for the keywords that matter to your business

SEO Position Audits

Audit organic positions across a keyword list to prioritize on-page and content work

Local & Device SEO Checks

Compare rankings by location and by desktop vs. mobile to spot geo or device gaps

Rank-Tracking Dashboards

Feed daily organic positions into your own dashboards and reporting pipelines

Endpoint

POST/api/v1/tools/serp_rank
Auth Required
2 req/s on Free plan
5 credits

Parameters

NameTypeRequiredDefaultDescription
keyword
stringRequired-
The search query to check ranking for
Example: managed wordpress hosting
target
stringRequired-
Domain or URL to locate in the results
Example: example.com
depth
numberOptional100
How many results to scan (10-200; 100 = 1 page of cost)
Example: 100
device
stringOptionaldesktop
Device to emulate: "desktop" or "mobile"
Example: mobile
location_name
stringOptionalUnited States
Location, e.g. 'United States' or 'London,England,United Kingdom'
Example: United States
location_code
numberOptional-
Numeric DataForSEO location code (overrides location_name)
Example: 2840
language_code
stringOptionalen
Language code (e.g. 'en')
Example: en
serp_rank measures true organic position, not Custom Search ordering. Depth controls how many results are scanned — 100 results equals one page of cost. Use location_name/location_code and device to check geo- and device-specific rankings.

Request Examples

terminalBash
curl -X POST https://crawlforge.dev/api/v1/tools/serp_rank \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "managed wordpress hosting",
    "target": "example.com",
    "depth": 100,
    "device": "desktop",
    "location_name": "United States",
    "language_code": "en"
  }'

Response Example

200 OK1,450ms
{
  "success": true,
  "data": {
    "keyword": "managed wordpress hosting",
    "target": "example.com",
    "location": "United States",
    "language": "en",
    "device": "desktop",
    "depth": 100,
    "found": true,
    "rank": 3,
    "url": "https://example.com/",
    "all_positions": [
      3,
      27
    ],
    "results_scanned": 100,
    "checked_at": "2026-07-01T14:30:00Z"
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 1450
}
Field Descriptions
data.rankBest organic position (null if the target is not found within depth)
data.urlThe ranking URL that holds the best position
data.all_positionsEvery organic position the target holds within the scanned depth
data.foundWhether the target appeared within the scanned depth
credits_usedFixed 5 credits per lookup (100 results = 1 page of cost)
processing_timeLookups typically complete in 1-2 seconds

Error Handling

Missing Keyword or Target (400 Bad Request)

Both keyword and target are required. Provide a search query and a domain or URL.

Invalid Depth (400 Bad Request)

Depth must be between 10 and 200. Larger depths scan more results.

Invalid Device (400 Bad Request)

Device must be "desktop" or "mobile".

Quota Exceeded (429 Too Many Requests)

The SERP provider enforces daily limits. Upgrade your plan for higher quotas.

Pro Tip: Pass a bare domain (example.com) as the target to match every ranking URL on that domain. Use location_code for precise geo-targeting when a location name is ambiguous.

Credit Cost

5 credits
5 credits per lookup
Fixed cost for scanning up to 100 results. Credits are charged only for successful lookups.

What's Included:

Real organic SERP position (not Custom Search order)

Ranking URL and every position the target holds

Location and language targeting

Desktop and mobile device emulation

Depth up to 200 results

Plan Recommendations:

Free Plan: 1,000 one-time trial credits = 200 lookups

Hobby Plan: 5,000 credits = 1,000 lookups ($19/mo)

Professional Plan: 50,000 credits = 10,000 lookups ($99/mo)

Related Tools

search_web
Search Google and get structured SERP results (5 credits)
track_changes
Monitor ranking pages for changes over time (3 credits)
analyze_content
Analyze ranking pages for topics and readability (3 credits)
deep_research
Multi-source research with AI analysis (10 credits)
Ready to try serp_rank? Sign up for free and get 1,000 credits to start tracking your rankings.