DataForSEO Keywords Data API icon

DataForSEO Keywords Data API

DataForSEO Keywords Data API

DataForSEO Trends → Get Live DataForSEO Trends Merged Data

AI-generated

Summary

Returns keyword popularity data, location-specific interest metrics, and demographic breakdowns for specified keywords from DataForSEO Trends.

Inputs

  • keywords (required) — Up to 5 keywords to analyze. The maximum number of keywords you can specify is 5.
  • location_name — Full name of the search engine location (e.g., 'London,England,United Kingdom').
  • type — Data type to fetch (Web, News, or Ecommerce). Default is 'web'.
  • date_from — Starting date of the time range. Minimal value for 'web' type: 2004-01-01. Minimal value for other types: 2008-01-01.
  • date_to — Ending date of the time range. If not specified, today's date is used by default.
  • time_range — Preset time range (e.g., 'past_7_days', 'past_12_months').

Output shape

A single item containing merged DataForSEO Trends data (keyword popularity, subregion interests, and demographics).

The operation returns a live API response. The exact structure of the returned JSON depends on the DataForSEO Trends API response.

Examples

Example 1: Analyze search interest for 'coffee' and 'tea' over the past 30 days in London.

Keywords: coffee, tea; Location: London,England,United Kingdom; Time Range: Past 30 Days

Example 2: Get news popularity data for 'technology' in the US.

Keywords: technology; Type: News; Location: United States

Links

Discussion