DataForSEO Keywords Data APIInstall

Summary

Retrieves historical Bing search volume data for up to 1000 keywords, optionally filtered by location, language, device types, aggregation period, and date range.

Inputs

• input_mode (required) — Whether keywords are provided manually or as a JSON array. The maximum number of keywords you can specify is 1000. The keywords are converted to lowercase format.
• keywords (required) — List of keywords (max 1000, each max 100 characters). Keywords are converted to lowercase format.
• keywords_json (required) — JSON array of keywords (max 1000, each max 100 characters). Keywords are converted to lowercase format.
• location_name_sv (required) — Full name of the search engine location (e.g., London,England,United Kingdom).
• language_name_sv (required) — Full name of the search engine language (e.g., English).
• location_coordinate — GPS coordinates of a location (optional). Example: 53.476225,-2.243572
• device_sv — Device types to filter by (mobile, desktop, tablet, non_smartphones).
• period — Aggregates the returned data to a certain time period: empty (no aggregation), monthly (past 24 months), weekly (past 15 weeks), daily (past 45 days).
• date_from_sv — Starting date of the time range. Minimal value: two years back from today’s date. Maximum value: one day from today’s date.
• date_to_sv — Ending date of the time range. Minimum value: two years back from today’s date. Maximum value: one day from today’s date.

Output shape

object

The raw response from the DataForSEO Bing Search Volume History API, containing task information and historical search volume data for each keyword.

Examples

Example 1: Get monthly Bing search volume history for the keywords 'burger' and 'pizza' in London, England, United Kingdom, English language, for the last 24 months.

Input Mode: Manual; Keywords: burger, pizza; Location: London,England,United Kingdom; Language: English; Period: monthly; Date From: (optional); Date To: (optional)

Links

• n8n community nodes installation guide