Skip to main content
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"
}

Documentation Index

Fetch the complete documentation index at: https://ayrshare.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Available on Premium, Business, Enterprise plans.
Search for available Facebook ad targeting interests by keyword. Use this endpoint to look up interest IDs 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"
}