DataForSEO Keywords Data APIInstall

Summary

Submits an asynchronous Bing Ads audience estimation task to DataForSEO and returns the completed API response with the estimated audience size for the specified targeting criteria.

Inputs

• Location (required) — Full name of the search engine location, for example London,England,United Kingdom. Supported locations are listed in the DataForSEO documentation.
• GPS Coordinates of a Location — Optional GPS coordinate with radius in the format latitude,longitude,radius (in km), for example 53.476225,-2.243572,100.
• Age Ranges for Targeting — Optional age ranges to target. Values: zero_to_twelve, thirteen_to_seventeen, eighteen_to_twenty_four, twenty_five_to_thirty_four, thirty_five_to_forty_nine, fifty_to_sixty_four, sixty_five_and_above, unknown.
• Desired Bid Setting Value in USD — Optional desired bid setting value in USD, with up to 2 decimal places and a maximum of 1000.
• Daily Campaign Budget Value in USD — Optional daily campaign budget value in USD, with up to 2 decimal places and a maximum of 10000.
• Gender to Target — Optional gender or genders to target. Values: male, female, unknown.
• Industry of LinkedIn Profile Targeting (required) — Required in the node UI. One or more LinkedIn profile targeting industries, specified as strings. Supported industries are listed in the DataForSEO documentation.
• Job Function of LinkedIn Profile Targeting (required) — Required in the node UI. One or more LinkedIn profile targeting job functions, specified as strings. Supported job functions are listed in the DataForSEO documentation.

Output shape

The returned JSON is the response returned by the DataForSEO API after the task completes. Inspect the tasks array in the response to access the audience estimation result.

The output is one JSON item per input item. Each output item contains the raw DataForSEO API response object for the completed audience estimation task, including the task status and result data. The node does not reshape or extract fields from the response.

Examples

Example 1: A workflow author wants to estimate how many people match a target audience for a Bing Ads campaign before setting a budget. They specify a location, one or more age ranges, gender, a desired bid, a daily budget, and LinkedIn industry/job-function targeting criteria, then use the returned audience estimation data to decide whether to proceed.

To estimate the audience size for a Bing Ads campaign, choose the 'Bing Ads Data' resource and the 'Get Bing Ads Audience Estimation' operation. Enter the full location name (for example, London,England,United Kingdom), and optionally add a GPS coordinate with radius, age ranges, gender, bid amount, daily budget, LinkedIn industries, and job functions. The node submits the task to DataForSEO and waits for the completed result before returning the response.

Links

• n8n community nodes installation guide