{"uid":"cap_oI1NPIcxkb5VfOZbtq6n0","slug":"true402-keyword-ideas-api-0a0fbd9e","name":"true402 Keyword Ideas API","description":"The machine-native marketplace. Wallet = identity. Pay per call with HTTP 402.","url":"https://true402.dev/api/v1/keyword-ideas","method":"POST","headers":{},"bodySchema":{"type":"object","required":["seed"],"properties":{"seed":{"type":"string","description":"Seed keyword, max 80 chars"},"limit":{"type":"integer","description":"Ideas to return, 1-200, default 50"},"language":{"type":"string"},"location":{"type":"integer"}}},"responseSchema":{"type":"object","properties":{"seed":{"type":"string"},"ideas":{"type":"array","items":{"type":"object","properties":{"cpc":{"type":"number"},"intent":{"type":"string"},"keyword":{"type":"string"},"competition":{"type":"number"},"searchVolume":{"type":"number","description":"null upstream = unmeasured, omitted here rather than 0"}}}},"language":{"type":"string"},"location":{"type":"number"},"observed":{"type":"boolean","description":"false when the index holds no suggestions for this seed"},"returned":{"type":"number"},"totalAvailable":{"type":"number","description":"Total ideas the index has, before the limit was applied"}}},"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_E3oJOft3hJyORVN8HXGzz","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 keyword ideas with search volume, CPC, competition score, and search intent for a given seed keyword","exampleAgentPrompt":"Can you give me up to 100 keyword ideas based on the seed keyword 'coffee subscription', in English, so I can see which terms have the most search volume and lowest competition?","exampleUseCases":[{"title":"SEO content gap discovery","prompt":"I'm writing blog content for my site about home brewing — can you pull up to 50 keyword ideas seeded from 'home brewing' in English so I can see which ones get real search traffic and have low competition?"},{"title":"Google Ads keyword expansion","prompt":"I need to expand my Google Ads campaign for 'project management software' — get me 200 keyword ideas from that seed so I can see CPC estimates and competition levels to decide what to bid on."},{"title":"Niche market keyword research","prompt":"I'm launching a product in the standing desk space — can you find keyword ideas starting from 'standing desk' and filter by intent so I can identify which terms are transactional and worth targeting?"}],"resultDescription":"A JSON object containing the original seed keyword, an array of keyword ideas each with keyword text, search volume (omitted if unmeasured upstream), CPC estimate, competition score (0-1), and search intent classification. Also includes language, location, the total number of ideas available in the index, the number returned, and an 'observed' flag indicating whether the index had any suggestions for this seed.","failureModes":["Seed keyword not found in index: 'observed' field returns false with an empty ideas array","Payment failure via HTTP 402: call rejected if wallet has insufficient USDC balance","Seed keyword exceeds 80 characters: request validation error","Limit parameter out of range (not 1-200): validation error returned","Upstream index returns null search volumes: affected keywords omitted from response rather than shown as 0"],"whenToPreferThis":"Choose this endpoint when you need keyword research data — search volume, CPC, competition, and intent — for a given seed keyword, especially in an automated agent workflow where pay-per-call pricing ($0.05 USDC) is preferable to a monthly SaaS subscription. It is well-suited for lightweight, on-demand SEO and PPC keyword expansion without requiring API key management, as wallet-based identity via x402 handles auth and billing in one step.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:00.170Z","isFirstParty":false}