{"uid":"cap_6nNCIac7A-4-tJ5qTffip","slug":"citable-run-rank-check-87a41497","name":"citable.run Rank Check","description":"Google organic position of a domain for a keyword, via a licensed SERP feed.","url":"https://citable.run/v1/rank-check","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["keyword","domain"],"properties":{"gl":{"type":"string","description":"country code, default us"},"hl":{"type":"string","description":"language code, default en"},"num":{"type":"string","description":"results window to check, 10–50 (default 20)"},"domain":{"type":"string","description":"hostname to find, e.g. example.com (subdomains match)"},"keyword":{"type":"string","description":"search query (1–120 chars)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2j-zpAqgvFdjNCX9z8a3L","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the Google organic search position of a specific domain for a given keyword, using a licensed SERP data feed.","exampleAgentPrompt":"What position does hubspot.com rank on Google for the keyword 'crm software' — check in the top 30 results for US English?","exampleUseCases":[{"title":"Competitor SEO position tracking","prompt":"Where does shopify.com rank on Google for 'ecommerce platform'? Check the top 30 US results."},{"title":"Own site ranking verification","prompt":"Can you check what position mybrand.com is at on Google for the keyword 'organic dog food' in the US?"},{"title":"Keyword opportunity gap check","prompt":"Does competitor.com rank in the top 20 Google results for 'project management software' in English?"}],"resultDescription":"Returns the Google organic search position (rank) of the specified domain for the given keyword, including position number within the checked results window. If the domain is not found in the results window, likely returns a null or not-found response.","failureModes":["Domain not found in specified results window — returns no rank or null position","Invalid keyword (too long or empty) — validation error","Invalid country or language code — may default or return error","Results window value outside 10–50 range — validation error","SERP feed unavailability — upstream error response","Payment failure — x402 payment required error"],"whenToPreferThis":"Choose this endpoint when you need a fast, single-query lookup of where a specific domain ranks organically on Google for one keyword. It is ideal for monitoring rank changes for a known domain-keyword pair, verifying competitor positions, or confirming whether a site has broken into the first page. It is more cost-efficient than pulling a full SERP page when only the rank position of one domain is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":9,"lastUsedAt":"2026-09-14T18:36:17.733Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T02:29:12.275Z","isFirstParty":false}