{"uid":"cap_IFNqhX0Kdd--bzRp-X4UI","slug":"keyword-ideas-d835e99c","name":"Keyword Ideas","description":"Up to 25 keyword suggestions containing the words of one seed phrase, with search volume, CPC and competition (DataForSEO Labs Keyword Suggestions). Use it to find new phrases around one seed; use keyword_metrics for exact volumes of keywords you already have and keyword_difficulty for ranking difficulty.","url":"https://agent.chiemgaufilms.com/api/v1/keyword-ideas?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string","maxLength":80,"minLength":1},"maxItems":1,"minItems":1},"language_code":{"type":"string"},"location_code":{"type":"integer","default":2840,"maximum":99999999,"minimum":1000}}},"responseSchema":{"type":"json","example":{"ideas":[{"cpc":1.1,"keyword":"trail running shoes","competition":0.87,"main_intent":"commercial","search_volume":74000,"competition_level":"HIGH","keyword_difficulty":62,"low_top_of_page_bid":0.45,"high_top_of_page_bid":2.2}],"language_code":"en","location_code":2840,"seed_keywords":["running shoes"],"total_available":52000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PCHRMx6BnplGO9xWTcfA0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","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 keyword suggestions containing the words of a seed phrase, with search volume, CPC, competition, and difficulty metrics.","exampleAgentPrompt":"Give me up to 25 keyword ideas that contain the phrase 'running shoes' for the US market in English, along with their search volumes, CPC, competition levels, and keyword difficulty scores.","exampleUseCases":[{"title":"PPC campaign keyword expansion","prompt":"I'm building a Google Ads campaign for a trail running gear brand — can you find me keyword ideas that contain 'trail running' for the US market in English, with their CPCs and competition levels?"},{"title":"SEO content cluster planning","prompt":"I want to create a content cluster around 'project management software' — find me keyword suggestions that include that phrase for the UK market in English, with search volumes and keyword difficulty scores."},{"title":"German market keyword research","prompt":"I'm expanding into Germany and need keyword ideas containing 'laufschuhe' for the German market — can you pull up to 25 suggestions with search volume, CPC, and competition data in German?"}],"resultDescription":"A JSON object containing: the seed keyword, location and language codes, total number of available keyword ideas, and an array of up to 25 keyword suggestions each with the keyword text, monthly search volume, CPC, numeric competition score (0-1), competition level label (LOW/MEDIUM/HIGH), keyword difficulty (0-100), main search intent, and low/high top-of-page bid estimates.","failureModes":["Unsupported country/language pair — request is refused before payment is charged","Seed phrase exceeds 80 characters or 10 words — validation error","Empty or missing keywords array — schema validation failure","No keyword ideas found for an extremely niche seed phrase — empty ideas array returned","Invalid location_code — error response with unrecognized location","Invalid language_code format — pattern validation rejection"],"whenToPreferThis":"Choose this endpoint when you need keyword expansion ideas that all contain a specific seed phrase, combined with rich metrics (volume, CPC, competition, difficulty, intent) in a single call. Prefer it over a generic keyword metrics lookup when you want to discover new keyword variations rather than check known keywords, and over a site-based keyword endpoint when you are starting from a phrase rather than a domain. Best for SEO content planning and PPC keyword research at the seed phrase level.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:40:37.244Z","isFirstParty":false,"canonicalSlug":"keyword-ideas-d835e99c"}