Interests

GEThttps://api.acme.com/api/ads/facebook/interests

Available on Premium, Business, Enterprise plans.

Search for available Facebook ad targeting interests by keyword. Required for the Boost Post endpoint.

This endpoint helps you discover interest-based targeting options for your Facebook ads, along with audience size estimates.

Interest IDs can be used in the interests array when boosting posts.
Results are cached for 10 minutes.
Use specific, relevant search terms for best results.
Facebook may return different results based on your ad account's industry and region.
The audienceSizeLowerBound and audienceSizeUpperBound fields in the JSON response provide an estimated range of audience size for the interest and it is useful for targeting.

Header Parameters

Authorizationstringrequired

API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY

Profile-Keystring

Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

Query Parameters

searchstringrequired

The search query to retrieve Facebook ad interests.

Don't forget to escape the search query, for example Rhythm%20and%20blues%20music.

limitnumberdefault: 100

Limit the number of ad interests returned.

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.acme.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music

{
    "status": "success",
    "interests": [
        {
            "id": "6003195554098",
            "name": "Rhythm and blues music",
            "topic": "News and entertainment",
            "audienceSizeLowerBound": 669180255,
            "audienceSizeUpperBound": 786955980
        },
        {
            "id": "6003470511564",
            "name": "Do it yourself (DIY)",
            "topic": "Hobbies and activities",
            "audienceSizeLowerBound": 418387661,  // Lower bound of audience size
            "audienceSizeUpperBound": 492023890  // Upper bound of audience size
        },
        {
            "id": "6002926036121",
            "name": "Italy",
            "topic": "Travel, places and events",
            "audienceSizeLowerBound": 279313350,  // Lower bound of audience size
            "audienceSizeUpperBound": 328472500  // Upper bound of audience size
        }
    ],
    "count": 3,
    "lastUpdated": "2025-03-27T01:01:38.547Z",
    "nextUpdate": "2025-03-27T01:12:38.547Z"
}