DataForSEO Keywords Data API icon

DataForSEO Keywords Data API

DataForSEO Keywords Data API

DataForSEO Trends → Get Live DataForSEO Trends Demography

AI-generated

Summary

Fetches demographic breakdown data (age and gender) for keyword popularity from DataForSEO Trends.

Inputs

  • keywords (required) — A list of up to 5 keywords to analyze. Each keyword is a string.
  • location_name — Full name of the search engine location (e.g., London,England,United Kingdom).
  • type — Data source type: Web, News, or Ecommerce. Defaults to 'web'.
  • date_from — Starting date of the time range (Web: 2004-01-01; Others: 2008-01-01).
  • date_to — Ending date of the time range. Defaults to today if not specified.
  • time_range — Preset time range (e.g., past_7_days, past_30_days).

Output shape

DataForSEO Trends API response containing keyword popularity metrics and demographic breakdowns.

The response is structured as a task list. The node executes requests synchronously (live endpoint).

Examples

Example 1: Get age and gender distribution for 'shoes' in London over the last 7 days.

Keywords: shoes, Location: London,England,United Kingdom, Type: Web, Time Range: 3 - Past 7 Days

Example 2: Analyze 'coffee' trends in New York for the news category over the past 12 months.

Keywords: coffee, Location: New York,United States, Type: News, Time Range: 6 - Past 12 Months

Links

Discussion