The Search API from LiveIntent — 2 operation(s) for search.
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-search-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 Search 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: Search
paths:
/search/audiences:
description: 'Search for audiences matching the provided criteria, with optional account scoping.
'
post:
description: Search for audiences matching the provided criteria, with optional account scoping.
parameters:
- name: accountId
in: query
description: 'the account id
'
schema:
type: integer
format: int64
allowReserved: false
style: form
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AudienceSearchRequest'
description: ''
required: true
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.
'
tags:
- Search
summary: Create search audiences
x-summary-source: derived
operationId: postSearchAudiences
x-operation-id-source: derived
/search/audiences/v2:
description: 'Search for audiences matching the provided criteria, with optional account scoping.
'
post:
description: Search for audiences matching the provided criteria, with optional account scoping.
parameters:
- name: accountId
in: query
description: 'the account id
'
schema:
type: integer
format: int64
allowReserved: false
style: form
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AudienceSearchRequestV2'
description: ''
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CursorPage'
'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:
- Search
summary: Create search audiences
x-summary-source: derived
operationId: postSearchAudiencesV2
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
CursorPage:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/AudienceData'
next:
type:
- string
- 'null'
required:
- items
accountIdMatches:
type: object
properties:
value:
$ref: '#/components/schemas/LongFilter'
required:
- value
or:
type: object
properties:
values:
type: array
items:
$ref: '#/components/schemas/AudienceFilter'
required:
- values
StringFilter:
oneOf:
- type: object
properties:
eq:
$ref: '#/components/schemas/eq'
additionalProperties: false
required:
- eq
and:
type: object
properties:
values:
type: array
items:
$ref: '#/components/schemas/AudienceFilter'
required:
- values
Value:
type: string
enum:
- Active
- Archived
- Deleted
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
status:
type: object
properties:
value:
$ref: '#/components/schemas/Value'
required:
- value
AudienceSearchRequest:
type: object
properties:
page:
type: integer
format: int32
description: If not set, this field defaults to the value of the default annotation.
default: 1
pageSize:
type: integer
format: int32
description: If not set, this field defaults to the value of the default annotation.
default: 30
matches:
anyOf:
- type: 'null'
- $ref: '#/components/schemas/AudienceFilter'
description: If not set, this field defaults to the value of the default annotation.
includeInternal:
type: boolean
description: If not set, this field defaults to the value of the default annotation.
default: false
AudienceFilter:
oneOf:
- type: object
properties:
and:
$ref: '#/components/schemas/and'
additionalProperties: false
required:
- and
- type: object
properties:
or:
$ref: '#/components/schemas/or'
additionalProperties: false
required:
- or
- type: object
properties:
not:
$ref: '#/components/schemas/not'
additionalProperties: false
required:
- not
- type: object
properties:
dataProviderIdMatches:
$ref: '#/components/schemas/dataProviderIdMatches'
additionalProperties: false
required:
- dataProviderIdMatches
- type: object
properties:
hasMetadata:
$ref: '#/components/schemas/hasMetadata'
additionalProperties: false
required:
- hasMetadata
- type: object
properties:
accountIdMatches:
$ref: '#/components/schemas/accountIdMatches'
additionalProperties: false
required:
- accountIdMatches
- type: object
properties:
nameMatches:
$ref: '#/components/schemas/nameMatches'
additionalProperties: false
required:
- nameMatches
- type: object
properties:
ruleIdMatches:
$ref: '#/components/schemas/ruleIdMatches'
additionalProperties: false
required:
- ruleIdMatches
- type: object
properties:
status:
$ref: '#/components/schemas/status'
additionalProperties: false
required:
- status
Obj:
type: object
properties:
fields:
type: array
items:
allOf:
- type: string
- $ref: '#/components/schemas/Json'
required:
- fields
eq:
type: object
properties:
value:
type: integer
format: int64
required:
- value
ApplicationError:
type: object
properties:
httpStatus:
type: integer
format: int32
message:
type: string
errorCode:
type: string
required:
- httpStatus
- message
- errorCode
IntFilter:
oneOf:
- type: object
properties:
eq:
$ref: '#/components/schemas/eq'
additionalProperties: false
required:
- eq
hasMetadata:
type: object
properties:
value:
$ref: '#/components/schemas/MetadataFilter'
required:
- value
Str:
type: object
properties:
value:
type: string
required:
- value
dataProviderIdMatches:
type: object
properties:
value:
$ref: '#/components/schemas/IntFilter'
required:
- value
AudienceMetadataDTO:
type: object
properties:
data:
$ref: '#/components/schemas/Json'
updatedAt:
type: string
format: date-time
required:
- data
- updatedAt
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
LongFilter:
oneOf:
- type: object
properties:
eq:
$ref: '#/components/schemas/eq'
additionalProperties: false
required:
- eq
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
nameMatches:
type: object
properties:
value:
$ref: '#/components/schemas/StringFilter'
required:
- value
'Null':
type: object
properties: {}
ruleIdMatches:
type: object
properties:
value:
$ref: '#/components/schemas/LongFilter'
required:
- value
MetadataFilter:
oneOf:
- type: object
properties:
nameMatches:
$ref: '#/components/schemas/nameMatches'
additionalProperties: false
required:
- nameMatches
not:
type: object
properties:
value:
$ref: '#/components/schemas/AudienceFilter'
required:
- value
AudienceSearchRequestV2:
type: object
properties:
next:
type:
- string
- 'null'
description: If not set, this field defaults to the value of the default annotation.
pageSize:
type: integer
format: int32
description: If not set, this field defaults to the value of the default annotation.
default: 30
matches:
anyOf:
- type: 'null'
- $ref: '#/components/schemas/AudienceFilter'
description: If not set, this field defaults to the value of the default annotation.
includeInternal:
type: boolean
description: If not set, this field defaults to the value of the default annotation.
default: false
Arr:
type: object
properties:
elements:
type: array
items:
$ref: '#/components/schemas/Json'
required:
- elements
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