Adspirer icon

Adspirer

Manage ad campaigns across Google, Meta, LinkedIn & TikTok Ads via the Adspirer REST API

Actions119

Search Audiences

AI-generated

Summary

Search for advertising audiences on a specified platform, currently supporting Google Ads with query-based audience discovery.

Inputs

  • Platform — Select the advertising platform to use; options include Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, and Utility. Defaults to Google Ads.
  • Customer Id — Required only for the Google Ads platform: the Google Ads customer ID to identify the account context for the search.
  • Query (required) — Enter a search string to find relevant audiences within the selected advertising platform. Currently, this is applicable and required for Google Ads.

Output shape

a list of audiences matching the search query within the chosen platform, returned as structured data.

Only Google Ads platform has documented required inputs for this operation as of version 0.3.0; other platforms do not show specific parameters in the current operation scope. The output consists of audience data corresponding to the search query. The operation does not indicate pagination or error handling behaviors.

Examples

Example 1: Search audiences on Google Ads

Set Platform to 'Google Ads', provide a valid Customer Id and a Query string describing the desired audience characteristics.

Links

Discussion