The Audiences API from LiveIntent — 5 operation(s) for audiences.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/liveintent-audiences-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Audiences API
description: The Audience API helps LiveIntent partners to programmatically exchange data for creating and managing audiences. The API enables a high level of automation, which helps LiveIntent partners increase efficiency, reduce labor requirements, and improve audience delivery time. As a LiveIntent partner, you can leverage the Audience API to create and manage Custom Audience. This API supports the HTTP GET, POST, and PATCH methods. The following sections describe how to call the endpoints.
version: 1.0.0
servers:
- url: https://audiences-staging.bln.liveintent.com
description: 'staging
'
- url: https://audiences.liveintent.com
description: 'production
'
security:
- Bearer: []
tags:
- name: Audiences
paths:
/audiences:
description: 'Create a new audience.
List audiences for the specified account, or all audiences if no accountId is provided.
'
get:
description: List audiences for the specified account, or all audiences if no accountId is provided.
parameters:
- name: page
in: query
description: 'the page number
'
schema:
type: integer
format: int32
allowReserved: false
style: form
- name: pageSize
in: query
description: 'the page size
'
schema:
type: integer
format: int32
allowReserved: false
style: form
- name: updatedAfter
in: query
description: 'filter for audiences updated after the provided timestamp (in milliseconds since epoch)
'
schema:
type: integer
format: int64
allowReserved: false
style: form
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/OffsetPaginatedAudiences'
'400':
description: 'Invalid request parameters.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Invalid request parameters.
'
'401':
description: 'Authentication credentials were missing or incorrect.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Authentication credentials were missing or incorrect.
'
'500':
description: 'Failed to list audiences.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Failed to list audiences.
'
tags:
- Audiences
summary: Get audiences
x-summary-source: derived
operationId: getAudiences
x-operation-id-source: derived
post:
description: Create a new audience.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAudienceRequest'
required: true
responses:
'201':
description: 'The audience has been created successfully
'
content:
application/json:
schema:
$ref: '#/components/schemas/AudienceData'
'400':
description: 'Invalid request parameters.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Invalid request parameters.
'
'401':
description: 'Authentication credentials were missing or incorrect.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Authentication credentials were missing or incorrect.
'
'500':
description: 'Failed to create audience.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Failed to create audience.
'
tags:
- Audiences
summary: Create audiences
x-summary-source: derived
operationId: postAudiences
x-operation-id-source: derived
/audiences/{audienceId}:
description: 'Update the specified audience.
Get the specified audience.
'
get:
description: Get the specified audience.
parameters:
- name: audienceId
in: path
required: true
schema:
type: integer
format: int64
style: simple
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/AudienceData'
'400':
description: 'Invalid request parameters.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Invalid request parameters.
'
'401':
description: 'Authentication credentials were missing or incorrect.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Authentication credentials were missing or incorrect.
'
'404':
description: 'Audience not found.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Audience not found.
'
'500':
description: 'Failed to retrieve audience.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Failed to retrieve audience.
'
tags:
- Audiences
summary: Get audiences by audience id
x-summary-source: derived
operationId: getAudiencesByAudienceId
x-operation-id-source: derived
patch:
description: Update the specified audience.
parameters:
- name: audienceId
in: path
required: true
schema:
type: integer
format: int64
style: simple
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateAudienceRequest'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/AudienceData'
'400':
description: 'Invalid request parameters.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Invalid request parameters.
'
'401':
description: 'Authentication credentials were missing or incorrect.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Authentication credentials were missing or incorrect.
'
'404':
description: 'Audience not found.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Audience not found.
'
'500':
description: 'Failed to update audience.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Failed to update audience.
'
tags:
- Audiences
summary: Update audiences by audience id
x-summary-source: derived
operationId: patchAudiencesByAudienceId
x-operation-id-source: derived
/audiences/{audienceId}/counts:
description: 'Get counts for the specified audience.
'
get:
description: Get counts for the specified audience.
parameters:
- name: audienceId
in: path
required: true
schema:
type: integer
format: int64
style: simple
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/AudienceCounts'
'400':
description: 'Invalid request parameters.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Invalid request parameters.
'
'401':
description: 'Authentication credentials were missing or incorrect.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Authentication credentials were missing or incorrect.
'
'404':
description: 'Audience not found.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Audience not found.
'
'500':
description: 'Failed to retrieve audience counts.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Failed to retrieve audience counts.
'
tags:
- Audiences
summary: Get audiences by audience id counts
x-summary-source: derived
operationId: getAudiencesByAudienceIdCounts
x-operation-id-source: derived
/audiences/{audienceId}/signed-urls:
description: 'Create signed URLs for uploading audience data to the specified audience.
'
post:
description: Create signed URLs for uploading audience data to the specified audience.
parameters:
- name: audienceId
in: path
required: true
schema:
type: integer
format: int64
style: simple
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateSignedUrlRequest'
required: true
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/SignedUploadUrlResponse'
'400':
description: 'Invalid request parameters.
'
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/ApplicationError'
description: 'Invalid request parameters.
'
- $ref: '#/components/schemas/ApplicationError'
description: 'Invalid upload query params: identifierType / action
'
description: ''
'401':
description: 'Authentication credentials were missing or incorrect.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Authentication credentials were missing or incorrect.
'
'500':
description: 'Failed to generate signed URLs.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Failed to generate signed URLs.
'
tags:
- Audiences
summary: Create audiences by audience id signed urls
x-summary-source: derived
operationId: postAudiencesByAudienceIdSignedUrls
x-operation-id-source: derived
/audiences/{audienceId}/uploads:
description: 'List uploads for the specified audience.
'
get:
description: List uploads for the specified audience.
parameters:
- name: page
in: query
description: 'the page number
'
schema:
type: integer
format: int32
allowReserved: false
style: form
- name: pageSize
in: query
description: 'the page size
'
schema:
type: integer
format: int32
allowReserved: false
style: form
- name: audienceId
in: path
required: true
schema:
type: integer
format: int64
style: simple
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/OffsetPaginatedAudienceUploads'
'400':
description: 'Invalid request parameters.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Invalid request parameters.
'
'401':
description: 'Authentication credentials were missing or incorrect.
'
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationError'
description: 'Authentication credentials were missing or incorrect.
'
tags:
- Audiences
summary: Get audiences by audience id uploads
x-summary-source: derived
operationId: getAudiencesByAudienceIdUploads
x-operation-id-source: derived
components:
schemas:
SimpleAudienceStatus:
type: string
enum:
- Active
- Archived
- Deleted
Num:
type: object
properties:
value:
type: number
format: double
required:
- value
AudienceCount:
type: object
properties:
date:
type: string
format: date
totalCount:
type: integer
format: int64
matchCount:
type: integer
format: int64
required:
- date
- totalCount
- matchCount
AudienceCounts:
type: object
properties:
entries:
type: array
items:
$ref: '#/components/schemas/AudienceCount'
required:
- entries
UploadStatus:
type: string
enum:
- Pending
- Running
- Finished
- Error
OffsetPaginatedAudiences:
type: object
properties:
pageSize:
type: integer
format: int32
page:
type: integer
format: int32
pages:
type: integer
format: int32
entries:
type: array
items:
$ref: '#/components/schemas/AudienceData'
totalCount:
type: integer
format: int32
required:
- entries
- page
- pages
- pageSize
- totalCount
CreateAudienceRequest:
type: object
properties:
dataProviderId:
type: integer
format: int32
name:
type: string
accountId:
type: integer
format: int64
metadata:
type: object
properties: {}
additionalProperties:
$ref: '#/components/schemas/UpsertMetadataRequestDTO'
description: If not set, this field defaults to the value of the default annotation.
default: {}
required:
- dataProviderId
- name
- accountId
Obj:
type: object
properties:
fields:
type: array
items:
allOf:
- type: string
- $ref: '#/components/schemas/Json'
required:
- fields
UpdateAudienceRequest:
type: object
properties:
name:
type:
- string
- 'null'
status:
anyOf:
- type: 'null'
- $ref: '#/components/schemas/StatusUpdateDTO'
ApplicationError:
type: object
properties:
httpStatus:
type: integer
format: int32
message:
type: string
errorCode:
type: string
required:
- httpStatus
- message
- errorCode
UpsertMetadataRequestDTO:
type: object
properties:
data:
$ref: '#/components/schemas/Json'
required:
- data
Str:
type: object
properties:
value:
type: string
required:
- value
AudienceUpload:
type: object
properties:
uploadedHashesCount:
type: integer
format: int64
lastUpdate:
type: string
format: date-time
invalidHashesCount:
type: integer
format: int64
notificationEmail:
type:
- string
- 'null'
estimatedDuplicateCount:
type: integer
format: int64
status:
$ref: '#/components/schemas/UploadStatus'
uploadType:
type: string
action:
type: string
scheduleAt:
type: string
format: date-time
required:
- status
- action
- uploadType
- lastUpdate
- scheduleAt
- estimatedDuplicateCount
- uploadedHashesCount
- invalidHashesCount
AudienceMetadataDTO:
type: object
properties:
data:
$ref: '#/components/schemas/Json'
updatedAt:
type: string
format: date-time
required:
- data
- updatedAt
CreateSignedUrlRequest:
type: object
properties:
uploadName:
type:
- string
- 'null'
notificationEmail:
type:
- string
- 'null'
identifierType:
type: string
action:
type: string
required:
- identifierType
- action
AudienceData:
type: object
properties:
accountId:
type: integer
format: int64
dataProviderId:
type: integer
format: int32
id:
type: integer
format: int64
status:
$ref: '#/components/schemas/SimpleAudienceStatus'
createdAt:
type: string
format: date-time
metadata:
type: object
properties: {}
additionalProperties:
$ref: '#/components/schemas/AudienceMetadataDTO'
name:
type: string
updatedAt:
type: string
format: date-time
required:
- id
- name
- accountId
- dataProviderId
- createdAt
- updatedAt
- status
- metadata
Bool:
type: object
properties:
value:
type: boolean
required:
- value
Json:
oneOf:
- type: object
properties:
Arr:
$ref: '#/components/schemas/Arr'
additionalProperties: false
required:
- Arr
- type: object
properties:
'Null':
$ref: '#/components/schemas/Null'
additionalProperties: false
required:
- 'Null'
- type: object
properties:
Bool:
$ref: '#/components/schemas/Bool'
additionalProperties: false
required:
- Bool
- type: object
properties:
Num:
$ref: '#/components/schemas/Num'
additionalProperties: false
required:
- Num
- type: object
properties:
Str:
$ref: '#/components/schemas/Str'
additionalProperties: false
required:
- Str
- type: object
properties:
Obj:
$ref: '#/components/schemas/Obj'
additionalProperties: false
required:
- Obj
'Null':
type: object
properties: {}
Arr:
type: object
properties:
elements:
type: array
items:
$ref: '#/components/schemas/Json'
required:
- elements
OffsetPaginatedAudienceUploads:
type: object
properties:
pageSize:
type: integer
format: int32
page:
type: integer
format: int32
pages:
type: integer
format: int32
entries:
type: array
items:
$ref: '#/components/schemas/AudienceUpload'
totalCount:
type: integer
format: int32
required:
- entries
- page
- pages
- pageSize
- totalCount
StatusUpdateDTO:
type: string
enum:
- Activate
- Archive
SignedUploadUrlResponse:
type: object
properties:
signedUrl:
type: string
required:
- signedUrl
securitySchemes:
Bearer:
type: apiKey
description: 'For accessing internal endpoints an access token is required. It needs to be sent as a Bearer token in the _Authorization_ header.
'
name: Authorization
in: header