GET
/
ads
/
facebook
/
interests
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.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"
}
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

​
Authorization
string
required
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
​
Profile-Key
string
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

​
Query Parameters

​
search
string
required
The search query to retrieve Facebook ad interests.Don’t forget to escape the search query, for example Rhythm%20and%20blues%20music.
​
limit
number
default:100
Limit the number of ad interests returned.
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.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"
}