> ## Documentation Index > Fetch the complete documentation index at: https://developers.criteo.com/llms.txt > Use this file to discover all available pages before exploring further. # /2025-10/marketing-solutions/audience-segments/search > Returns a list of segments that match the provided filters. If present, the filters are AND'ed together when applied. ## OpenAPI ````yaml https://api.criteo.com/2025-10/marketingsolutions/open-api-specifications.json post /2025-10/marketing-solutions/audience-segments/search openapi: 3.0.1 info: title: Criteo API description: Criteo API - MarketingSolutions version: 2025-10 servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Advertiser - name: Analytics - name: Audience - name: Campaign - name: Creative - name: Gateway - name: Reco paths: /2025-10/marketing-solutions/audience-segments/search: post: tags: - Audience summary: /2025-10/marketing-solutions/audience-segments/search description: >- Returns a list of segments that match the provided filters. If present, the filters are AND'ed together when applied. operationId: SearchAudienceSegments parameters: - name: limit in: query description: >- The number of elements to be returned. The default is 50 and the maximum is 100. schema: maximum: 100 minimum: 0 type: integer format: int32 default: 50 - name: offset in: query description: The (zero-based) offset into the collection. The default is 0. schema: type: integer format: int32 default: 0 requestBody: description: Segment search filters. content: application/json: schema: $ref: '#/components/schemas/AudienceSegmentSearchInputV1' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: >- #/components/schemas/AudienceSegmentEntityV1AudienceSegmentSearchMetadataV1ListResponse security: - oauth: - MarketingSolutions_Audience_Read components: schemas: AudienceSegmentSearchInputV1: type: object properties: data: $ref: '#/components/schemas/AudienceSegmentSearchEntityV1Resource' description: Audience segment search parameter AudienceSegmentEntityV1AudienceSegmentSearchMetadataV1ListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/AudienceSegmentEntityV1Resource' nullable: true errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true meta: $ref: '#/components/schemas/AudienceSegmentSearchMetadataV1' warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: >- A top-level object that encapsulates a Criteo API response for several entities and metadata AudienceSegmentSearchEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/AudienceSegmentSearchEntityV1' type: type: string description: >- A top-level object that encapsulates a Criteo API response for a single value AudienceSegmentEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/AudienceSegmentEntityV1' id: type: string description: Id of the entity nullable: true type: type: string nullable: true description: A class that represents a domain entity exposed by an API CommonProblem: type: object properties: code: type: string description: A machine-readable error code, expressed as a string value. nullable: true detail: type: string description: >- A human-readable explanation specific to this occurrence of the problem nullable: true instance: type: string description: A URI that identifies the specific occurrence of the problem. nullable: true source: type: object additionalProperties: type: string description: >- A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: string nullable: true title: type: string description: A short human-readable description of the problem type nullable: true traceId: type: string description: The request correlation ID this problem comes from. nullable: true traceIdentifier: type: string description: >- The request correlation ID this problem comes from. (deprecated, use traceId instead) nullable: true type: enum: - unknown - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: The problem's category. nullable: true description: Common problem object. AudienceSegmentSearchMetadataV1: type: object properties: limit: type: integer description: Max item of the current page format: int32 nullable: true offset: type: integer description: Number of item to skip format: int32 nullable: true totalItems: type: integer description: Total number of items format: int32 nullable: true description: Metadata for the audience segment search response. nullable: true AudienceSegmentSearchEntityV1: type: object properties: advertiserIds: type: array items: type: string description: List of advertiser ids audienceSegmentIds: type: array items: type: string description: List of segment ids audienceSegmentTypes: type: array items: enum: - Unknown - InMarket - Prospecting - ContactList - Location - Behavioral - Retargeting - Lookalike type: string description: List of segment types description: >- Available filters to perform a search on audience segments. If present, the filters are AND'ed together when applied. AudienceSegmentEntityV1: type: object properties: advertiserId: type: string description: Advertiser associated to the segment nullable: true behavioral: $ref: '#/components/schemas/BehavioralV1' contactList: $ref: '#/components/schemas/ContactListV1' createdAt: type: string description: ISO-8601 timestamp in UTC of segment creation (read-only) format: date-time nullable: true description: type: string description: Description of the segment nullable: true inMarket: $ref: '#/components/schemas/InMarketV1' location: $ref: '#/components/schemas/LocationV1' lookalike: $ref: '#/components/schemas/LookalikeV1' name: type: string description: Name of the segment nullable: true prospecting: $ref: '#/components/schemas/ProspectingV1' retargeting: $ref: '#/components/schemas/RetargetingV1' type: enum: - Unknown - InMarket - Prospecting - ContactList - Location - Behavioral - Retargeting - Lookalike type: string description: Type of segment (read-only) nullable: true updatedAt: type: string description: ISO-8601 timestamp in UTC of segment update (read-only) format: date-time nullable: true description: Set of rules that defines specific people to target. nullable: true x-criteo-canonical: infoType: entity name: AudienceSegment version: v1 BehavioralV1: required: - category type: object properties: category: enum: - Unknown - Lifestyles - LifeEvents - Seasonal - BuyingPatterns type: string description: The type of behavioral country: type: string description: The users' country nullable: true endDate: type: string description: Desired date when the behavioral will end format: date-time nullable: true startDate: type: string description: Desired date when the behavioral will start format: date-time nullable: true description: Settings of a behavioral set of users provided by Criteo. nullable: true ContactListV1: type: object properties: isReadOnly: type: boolean description: Is the segment read-only nullable: true description: Settings to target users with your contact lists. nullable: true InMarketV1: type: object properties: brandIds: uniqueItems: true type: array items: type: string description: Choose the brands your segment might be interested in nullable: true buyingPower: uniqueItems: true type: array items: enum: - Unknown - Low - Medium - High - VeryHigh type: string description: >- Reach people who frequently purchase high price range items to lower price range items nullable: true country: type: string description: Reach people of a specific country nullable: true gender: enum: - Unknown - Male - Female type: string description: >- Reach people who’ve shown interest in products made for a specific gender nullable: true interestIds: uniqueItems: true type: array items: type: string description: Reach new people based on their interests nullable: true priceRange: uniqueItems: true type: array items: enum: - Unknown - Low - Medium - High type: string description: >- Reach people who’ve shown interest in products within a specific price range nullable: true description: >- Settings to target users based on high shopping intents and demographics. nullable: true LocationV1: type: object properties: pointsOfInterest: type: array items: $ref: '#/components/schemas/PointOfInterestV1' description: >- Reach users which have been historically located in the given coordinates nullable: true radiusInKm: type: integer description: >- The expected maximum distance in kilometers between a user and a point of interest format: int32 nullable: true registryType: enum: - Unknown - PointOfInterest type: string description: The kind of Location audience nullable: true description: Settings to target users based on their location. nullable: true LookalikeV1: type: object properties: seedSegmentId: type: string description: Segment from which the Lookalike segment will be generated nullable: true targetSize: type: integer description: Desired size of the generated Lookalike segment format: int64 nullable: true description: Settings to target users that behave like a given seed segment nullable: true ProspectingV1: type: object properties: daysSinceLastVisitMax: type: integer description: >- When non buyers are included, include users who visited your website after this number of days format: int32 nullable: true daysSinceLastVisitMin: type: integer description: >- When non buyers are included, include users who visited your website before this number of days format: int32 nullable: true usersType: enum: - Unknown - Prospects - ProspectsOrNonBuyers type: string description: Type of users to target nullable: true description: Settings to target prospecting users to website visitors. nullable: true RetargetingV1: type: object properties: daysSinceLastVisitMax: type: integer description: Maximum number of days since last visit to partner. format: int32 nullable: true daysSinceLastVisitMin: type: integer description: Minimum number of days since last visit to partner. format: int32 nullable: true visitorsType: enum: - Unknown - All - Buyers - NonBuyers type: string description: Types of visitors. nullable: true description: Settings to target users based on its type and days since last visit. nullable: true PointOfInterestV1: type: object properties: latitude: type: number description: ISO-6709 latitude (rounded at 5 decimals) format: double nullable: true longitude: type: number description: ISO-6709 longitude (rounded at 5 decimals) format: double nullable: true name: type: string description: Name of the point of interest nullable: true description: "Named coordinate defined by its latitude and longitude.\r\nLatitude and Longitude are rounded at 5 decimals." securitySchemes: oauth: type: oauth2 flows: clientCredentials: tokenUrl: https://api.criteo.com/oauth2/token scopes: {} authorizationCode: authorizationUrl: https://api.criteo.com/oauth2 tokenUrl: https://api.criteo.com/oauth2/token scopes: {} ````