---
updatedAt: 2026-09-24T11:53:05.000Z
agentTools:
projectIndex: https://developers.taboola.com/backstage-api/llms.txt
---
# Update Lookalike Audience Targeting
Update *Lookalike Audience* Targeting for the specified campaign.
VALID request examples:
```json Target ALL
{
"collection": []
}
```
```json Include Specified Audiences
{
"collection": [
{
"collection": [
{
"rule_id": 5253453,
"similarity_level": 15
},
{
"rule_id": 444487,
"similarity_level": 25
}
],
"type": "INCLUDE"
}
]
}
```
> 🚧
>
> To obtain a list of Lookalike Audience IDs, use the [Dictionary](https://developers.taboola.com/backstage-api/reference/get-lookalike-audiences) endpoint: `dictionary/lookalike_audiences`.
>
> To *create* Lookalike Audiences, use *Backstage UI*.
> 📘 *Pixel* Lookalike Audiences support a *single* similarity level of 5.\
> *CRM* Lookalike Audiences support a wider range of similarity levels - see: [Lookalike Audience Object](https://developers.taboola.com/backstage-api/docs/lookalike-audience-object).
> 🚧 Audience Targeting does *not* support a PATCH operation - the submitted values *overwrite* the old ones.
> 📘 For a successful request, the same object is returned in the *response*.
INVALID request example:
```json Exclude Specified Audiences
{
"collection": [
{
"collection": [
{
"rule_id": 190356,
"similarity_level": 15
},
{
"rule_id": 232287,
"similarity_level": 25
}
],
"type": "EXCLUDE"
}
]
}
```
```json 400 (Bad Request)
{
"http_status": 400,
"message": "Invalid input - Exclude for lookalike audiences is not supported.",
"offending_field": "lookalike_audience_targeting.collection[0].type"
}
```
> 🚧 *Lookalike Audience* Targeting does *not* support EXCLUDE.
## Rate limit
> 🚧 Rate limit
>
> **Tier 2.** Updating lookalike audience targeting has its own budget, stricter than the one for reading it and separate from every other targeting type.
>
> See [Rate limits](https://developers.taboola.com/backstage-api/reference/rate-limits) for the request allowance each tier carries.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "backstage-api",
"version": "1.0"
},
"servers": [
{
"url": "https://backstage.taboola.com"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "oauth2",
"flows": {
"clientCredentials": {
"tokenUrl": "https://backstage.taboola.com/backstage/oauth/token",
"scopes": {}
},
"password": {
"tokenUrl": "https://backstage.taboola.com/backstage/oauth/token",
"scopes": {}
}
}
}
}
},
"security": [
{
"sec0": []
}
],
"x-readme": {
"headers": [],
"explorer-enabled": false,
"proxy-enabled": false
},
"paths": {
"/backstage/api/1.0/{account_id}/campaigns/{campaign_id}/targeting/lookalike_audience": {
"post": {
"summary": "Update Lookalike Audience Targeting",
"description": "Update *Lookalike Audience* Targeting for the specified campaign.\n\n",
"operationId": "update-lookalike-audience-targeting",
"parameters": [
{
"name": "account_id",
"in": "path",
"description": "An *alphabetic* ID. See [Get Account Details](https://developers.taboola.com/backstage-api/reference/get-account-details).",
"schema": {
"type": "string"
},
"required": true
},
{
"name": "campaign_id",
"in": "path",
"description": "A *numeric* ID.",
"schema": {
"type": "string"
},
"required": true
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"RAW_BODY": {
"type": "string",
"description": "An [Audience Targeting Object](https://developers.taboola.com/backstage-api/reference/audience-targeting-object)",
"default": "{ \"collection\": [ { \"collection\": [ { \"rule_id\": 5253453, \"similarity_level\": 15 }, { \"rule_id\": 444487, \"similarity_level\": 25 } ], \"type\": \"INCLUDE\" } ] }",
"format": "json"
}
}
}
}
}
},
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"collection\": [\n {\n \"collection\": [\n {\n \"rule_id\": 5253453,\n \"similarity_level\": 15\n },\n {\n \"rule_id\": 444487,\n \"similarity_level\": 25\n }\n ],\n \"type\": \"INCLUDE\"\n }\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"collection": {
"type": "array",
"items": {
"type": "object",
"properties": {
"collection": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rule_id": {
"type": "integer",
"example": 5253453,
"default": 0
},
"similarity_level": {
"type": "integer",
"example": 15,
"default": 0
}
}
}
},
"type": {
"type": "string",
"example": "INCLUDE"
}
}
}
}
}
}
}
}
}
},
"deprecated": false
}
}
}
}
```