{"uid":"cap_Qq4kypDbmz8hL1aP6hB_9","slug":"true402-ranked-keywords-lookup-d3492bdc","name":"true402 Ranked Keywords Lookup","description":"The machine-native marketplace. Wallet = identity. Pay per call with HTTP 402.","url":"https://true402.dev/api/v1/ranked-keywords","method":"POST","headers":{},"bodySchema":{"type":"object","required":["target"],"properties":{"limit":{"type":"integer","description":"Rows to return, 1-200, default 50"},"target":{"type":"string","description":"Domain, or any URL on it"},"language":{"type":"string"},"location":{"type":"integer"}}},"responseSchema":{"type":"object","properties":{"limits":{"type":"array"},"target":{"type":"string"},"keywords":{"type":"array","description":"[{ keyword, searchVolume, cpc, competition, position, url, title }]"},"language":{"type":"string"},"location":{"type":"number"},"observed":{"type":"boolean","description":"false when the index holds no ranked keywords for this domain"},"returned":{"type":"number"},"totalRanked":{"type":"number","description":"Total keywords the index has for this domain, when reported"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Qf_daclBx_1GtzgaVnVRm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the organic search keywords a domain ranks for, with search volume, CPC, competition, position, and landing URL data.","exampleAgentPrompt":"Can you pull the top 100 organic keywords that ahrefs.com ranks for, including their search volumes and CPC — ideally for English in the US market?","exampleUseCases":[{"title":"Competitor SEO keyword gap analysis","prompt":"I want to see what keywords shopify.com ranks for organically — give me up to 150 keywords with their search volume, CPC, and ranking position so I can find gaps for my own store."},{"title":"Content strategy discovery for a niche site","prompt":"Pull the top 50 ranked keywords for backlinko.com in English and show me which pages are ranking and at what positions — I want to plan content around their gaps."},{"title":"PPC keyword research from organic data","prompt":"What keywords does moz.com rank for that have the highest CPC? Give me up to 200 results so I can identify which ones are worth bidding on in paid search."}],"resultDescription":"Returns a JSON object containing: the target domain, language, location code, total number of ranked keywords in the index, number of results returned, an observed flag (false if the domain has no indexed keyword data), and a keywords array where each item includes the keyword string, monthly search volume, cost-per-click, competition score, current SERP position, the ranking URL, and its page title. Also includes limits metadata.","failureModes":["Domain not observed in index — observed=false returned with empty keywords array","Invalid or malformed URL/domain input — request rejected","limit out of range (must be 1-200) — validation error","Payment failure via x402 protocol — 402 response, no data returned","Unknown location/language codes — may return empty or default results"],"whenToPreferThis":"Choose this endpoint when you need structured organic keyword ranking data for any domain — especially for competitive SEO research, content gap analysis, or PPC keyword discovery. It returns rich per-keyword data (volume, CPC, competition, position, URL) in a single call. Prefer over generic web scraping when you need pre-indexed, structured SEO data paid per-query without a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:35:48.189Z","isFirstParty":false}