{"uid":"cap_7S25s3vGmjTn_ZswT1X2M","slug":"google-trends-related-queries-by-keyword-ae9dfae2","name":"Google Trends Related Queries by Keyword","description":"Google Trends related queries for one keyword: the top related searches (0-100) and the rising ones (% growth), for a country or worldwide, past 7 days to 5 years, in one $0.03 GET. Use when you need query expansion, content ideas or emerging searches around a keyword. A live call takes up to about 30 s. Bad input is free; upstream errors are not charged.","url":"https://keywords.duoleads.com/v1/related-queries?utm_source=zero.xyz","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"],"properties":{"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"ISO 3166-1 alpha-2 country code (us, gb, de, ...; uk = gb). Omit for worldwide."},"keyword":{"type":"string","maxLength":100,"minLength":2,"description":"One keyword or phrase (2-100 characters, no commas)."},"timeframe":{"enum":["past_7_days","past_30_days","past_90_days","past_12_months","past_5_years"],"type":"string","default":"past_12_months","description":"Time window. Default past_12_months."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"top":[{"term":"analytics seo api","value":100},{"term":"moz api","value":64}],"units":"top value: 0-100 relative popularity among related queries (100 = most searched); rising value: % increase in searches vs the preceding period","market":{"country":"US","locationCode":2840,"locationName":"United States"},"rising":[],"source":"Google Trends (via DataForSEO)","country":"US","keyword":"seo api","dataAsOf":"2022-04-21T18:40:17Z","see_also":{"params":["keyword","country","timeframe"],"reason":"Need the interest-over-time series for this keyword? Call trend with the same parameters.","endpoint":"https://keywords.duoleads.com/v1/trend"},"timeframe":"past_12_months","queried_at":"2022-04-21T18:40:17Z","request_id":"01KEXAMPLE0000000000000000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kjs6QY3DTvj05E0kxx9cg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top and rising related search queries for a given keyword using Google Trends data, with relative popularity scores and growth percentages.","exampleAgentPrompt":"What are the top and rising related Google searches around 'electric vehicles' in the US over the past 12 months? I want to find emerging queries I could target for content.","exampleUseCases":[{"title":"Content ideation from trending queries","prompt":"Show me the top and rising related searches for 'intermittent fasting' in the UK over the past 90 days — I want to find emerging angles for new blog posts."},{"title":"SEO query expansion for a campaign","prompt":"I'm planning an SEO campaign around 'project management software' — can you pull the top related Google searches worldwide for the past 12 months so I can expand my keyword list?"},{"title":"Spotting fast-growing search trends","prompt":"What are the fastest rising related searches around 'AI writing tools' in the US over the past 30 days? I want to see which queries are spiking so I can jump on them early."}],"resultDescription":"Returns two lists of related Google Trends queries for the keyword: 'top' (up to ~25 queries with 0-100 relative popularity scores) and 'rising' (queries with % growth vs the prior period). Also includes market metadata (country name, location code), the timeframe queried, the data timestamp, and a pointer to a sibling endpoint for interest-over-time series data.","failureModes":["Keyword too short (<2 chars) or too long (>100 chars) — returns validation error, not charged","Invalid country code format — returns validation error, not charged","No related queries found for obscure keywords — returns empty top/rising arrays","Upstream DataForSEO/Google Trends outage — upstream error, charged may not apply","Response latency up to ~30 seconds on live calls — agent timeout if not configured appropriately","Worldwide results returned when country omitted — may be unexpected if regional data was intended"],"whenToPreferThis":"Use this endpoint when you need to discover what users also search for around a specific keyword — ideal for query expansion, content ideation, or spotting emerging trends. Prefer this over generic keyword volume endpoints when you want related query discovery with trend signals (top vs rising), not just search volume. Choose the sibling trend endpoint if you need the interest-over-time series for the same keyword instead of related queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:31:27.813Z","isFirstParty":false,"canonicalSlug":"google-trends-related-queries-by-keyword-ae9dfae2"}