Meta Ads icon

Meta Ads

Access Meta Ads Marketing API

Actions20

Targeting → Search Interests

AI-generated

Summary

Search for interest targeting options available in the Meta Ads platform using a query string.

Inputs

  • Ad Account ID (required) — The numeric ID of the ad account (without the act_ prefix) to scope the search.
  • Query (required) — The search term to find relevant interest targeting options (e.g., "Golf", "New York").
  • Limit — Maximum number of interest results to return; defaults to 25 and can be set between 1 and 100.

Output shape

a JSON list of interest targeting options matching the search query, each with associated metadata as returned by the Meta Ads Marketing API

The operation performs a GET request to the Meta Ads API search endpoint with type set to 'adinterest' and query parameter q set to the provided query. Results are limited according to the specified limit parameter. The output includes all matching interests up to the limit; no pagination is indicated.

Examples

Example 1: Search for interests related to 'Golf' for a specific ad account.

Set 'Ad Account ID' to the numeric ad account ID, 'Query' to 'Golf', and optionally adjust 'Limit' to control maximum results.

Links

Discussion