Get Lookalike Audiences

Get a list of available Lookalike Audiences for the specified account - e.g. in order to implement Lookalike Audience Targeting.

Example:

GET /backstage/api/1.0/demo-account/dictionary/lookalike_audiences/
{
   "results": [
      {
         "rule_id": 190356,
         "audience_name": "test 1",
         "similarity_level_to_size": {
            "5": 0,
            "10": 7663100,
            "15": 10480600,
            "20": 13048900,
            "25": 15432400
         }
      },
      {
         "rule_id": 190358,
         "audience_name": "test 2",
         "similarity_level_to_size": {
            "5": 3589500
         }
      },
      //...
   ],
   "metadata": {
      //...
   }
}

πŸ“˜

Pixel Lookalike Audiences support a single similarity level of 5.
CRM Lookalike Audiences support a wider range of similarity levels - see: Lookalike Audience Object.

🚧

As of 2020-11-18, audience size reflects the estimated number of users with visible activity in the Taboola network, over the past 30 days. (Previously, it reflected an average, daily amount.)

πŸ“˜

Uses the dictionary endpoint - and returns a more complex object than the resources endpoint.

🚧

Invalid account_id

If you pass an invalid account_id, the endpoint returns a successful response with an empty collection in the results property (unlike other endpoints that return 400 Bad Request).

{
    "results": [],
    "metadata": {
        "total": null,
        "count": null,
        "static_fields": [],
        "static_total_fields": []
    }
}
Language