DataForSEO icon

DataForSEO

DataForSEO

Actions28

Overview

The "Get Google Search Volume" operation of the Keywords Data resource in this node allows users to retrieve search volume data for a list of keywords from Google Ads. This is useful for SEO specialists, digital marketers, and content creators who want to analyze keyword popularity, competition, and trends over time to optimize their campaigns or content strategies.

Typical use cases include:

  • Estimating how often certain keywords are searched on Google.
  • Comparing search volumes across different locations and languages.
  • Filtering keywords by date ranges to observe seasonal trends.
  • Including or excluding search partner data and adult content keywords.
  • Sorting results by relevance, search volume, competition, or bid prices.

For example, a user might input a list of product-related keywords and specify a location (e.g., "London,England,United Kingdom") and language ("English") to get localized search volume data to tailor their advertising campaigns.

Properties

Name Meaning
Keywords A collection of up to 1000 keywords to query. Each keyword can be up to 80 characters and contain up to 10 words. Keywords will be converted to lowercase automatically.
Location The full name of the geographic location to target (e.g., "London,England,United Kingdom"). Determines the regional context for the search volume data. Supported locations are documented externally.
Language The full name of the language (e.g., "English") to filter the search volume data. Supported languages are documented externally.
Include Google Search Partners? Boolean flag indicating whether to include search volume data from Google's owned, operated, and syndicated partner sites in addition to Google search itself. Defaults to false (only Google search).
Include keywords associated with adult content? Boolean flag to include adult content keywords in the results if set to true. Defaults to false.
Date From Starting date of the time range for which to retrieve search volume data. Must be within the last 4 years. If not specified, defaults to 12 months ago.
Date To Ending date of the time range. Cannot be later than the previous month (Google Ads does not provide current month data). Defaults to yesterday if not specified.
Sort By Option to sort the returned keywords by one of: Relevance, Search Volume, Competition Index, Low Top Of Page Bid, High Top Of Page Bid, or leave empty for no sorting.

Output

The output is a JSON array where each element corresponds to a keyword's search volume data as returned by the external API. The structure typically includes:

  • Keyword text (lowercased).
  • Search volume metrics such as average monthly searches.
  • Competition index indicating how competitive the keyword is.
  • Bid price estimates for top of page ads (low and high).
  • Possibly segmented data by location, language, and date range.

If binary data were involved (not indicated here), it would represent files or media related to the keywords, but this operation focuses on JSON data only.

Dependencies

Troubleshooting

  • Error: "Something went wrong" — This generic error may indicate issues such as invalid parameters, network problems, or API limits. Verify that all required properties are correctly set, especially keywords, location, and language.
  • Invalid keyword format — Ensure keywords do not exceed 80 characters or 10 words.
  • Date range errors — The "Date From" cannot be older than 4 years; "Date To" cannot be in the current month. Adjust dates accordingly.
  • API authentication failures — Confirm that the API key credential is valid and has necessary permissions.
  • Empty or missing results — Check if the keywords exist in the specified location/language and that the date range is appropriate.

Links and References

Discussion