Skip to main content
POST
Get related searches for a keyword
Returns related searches for a keyword.

Request

query is required.

Response

If successful, the response body contains the standard envelope. data.results[] contains the related searches, each with a score. The following example is a real response, truncated: each list shows one item and long strings are cut.
For every field, see the response schema on this page.

Optional parameters

Billing

Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.

Pagination

This method is not paginated. A single request returns the complete result.
  • Google Trends interest over time: Accepts queries from results as queries. Returns Google Trends search interest over time, newest first, with one value per query.
  • Google Trends by region: Accepts queries from results as queries. Returns Google Trends search interest by region.
  • Google Search: Accepts a related search as query. Searches Google and returns results, the AI Overview, the knowledge panel and related questions.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string
required
Required string length: 1 - 100
country
string

ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted.

Pattern: ^[A-Za-z]{2}$
time
enum<string>
default:past12Months

Google Trends' own time range.

Available options:
pastHour,
past4Hours,
pastDay,
past7Days,
past30Days,
past90Days,
past12Months,
past5Years,
since2004
searchType
enum<string>
default:web

Google Trends' own search type: web, images, news, shopping or youtube.

Available options:
web,
images,
news,
shopping,
youtube
category
enum<string>

Google Trends' own top-level category.

Available options:
artsEntertainment,
autosVehicles,
beautyFitness,
booksLiterature,
businessIndustrial,
computersElectronics,
finance,
foodDrink,
games,
health,
hobbiesLeisure,
homeGarden,
internetTelecom,
jobsEducation,
lawGovernment,
news,
onlineCommunities,
peopleSociety,
petsAnimals,
realEstate,
reference,
science,
shopping,
sports,
travel

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required