{"uid":"cap__vbyal_uFM3V0elyPo5RT","slug":"ranked-keywords-a0245826","name":"Ranked Keywords","description":"Up to 25 Google keywords a domain ranks for, with position, ranking page, search volume, CPC and difficulty (DataForSEO Labs Ranked Keywords).","url":"https://agent.chiemgaufilms.com/api/v1/ranked-keywords?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"domain":{"type":"string","maxLength":300},"language_code":{"type":"string"},"location_code":{"type":"integer","default":2840,"maximum":99999999,"minimum":1000}}},"responseSchema":{"type":"json","example":{"target":"example.com","keywords":[{"cpc":0.8,"url":"https://www.example.com/","keyword":"example domain","position":1,"search_volume":5400,"absolute_position":2,"competition_level":"LOW","estimated_traffic":1800.5,"keyword_difficulty":12}],"language_code":"en","location_code":2840,"total_available":8806}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lpDANBVsKl_eE2AoE9cxn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns up to 25 Google keywords a domain ranks for, including position, ranking URL, search volume, CPC, and keyword difficulty via DataForSEO Labs.","exampleAgentPrompt":"What Google keywords does ahrefs.com rank for in the United States? Show me their positions, search volumes, and keyword difficulty scores.","exampleUseCases":[{"title":"Competitor keyword gap analysis","prompt":"What keywords is semrush.com ranking for on Google in the UK? I want to see their positions and search volumes so I can find gaps in my own SEO strategy."},{"title":"Niche blog SEO audit","prompt":"Can you pull up the top Google keywords that backlinko.com ranks for in the US, including how hard those keywords are to rank for and how much traffic they're estimated to bring in?"},{"title":"E-commerce site keyword discovery","prompt":"Show me what Google keywords shopify.com ranks for in Germany — I need the keyword positions, CPC values, and search volumes, using German language results."}],"resultDescription":"Returns a JSON object with the target domain, location and language codes, total number of rankable keywords available, and an array of up to 25 keyword objects each containing: keyword text, ranking position, absolute position, ranking page URL, monthly search volume, CPC, competition level (LOW/MEDIUM/HIGH), keyword difficulty score (0-100), and estimated monthly traffic.","failureModes":["Unsupported country/language pair rejected before payment is charged","Invalid domain format (IP addresses or ports) rejected with error","Domain not found in DataForSEO index returns empty keywords array","Invalid location_code returns an error response","Malformed language_code pattern rejected with validation error","Domain has no ranking data for the specified location/language combination"],"whenToPreferThis":"Choose this endpoint when you need to quickly discover which Google keywords a specific domain is ranking for, along with actionable SEO metrics like position, search volume, CPC, and difficulty. It is ideal for competitive keyword research, SEO audits, and traffic source analysis. Prefer this over the 'Keywords for Site' endpoint when you want actual current ranking data (real positions) rather than keyword suggestions, and over 'Domain Overview' when you need keyword-level granularity rather than aggregate metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:20:46.812Z","isFirstParty":false,"canonicalSlug":"ranked-keywords-a0245826"}