search Audience Segments
POST {{baseUrl}}/2024-07/marketing-solutions/audience-segments/search?limit=50&offset=0
Returns a list of segments that match the provided filters. If present, the filters are AND'ed together when applied.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
limit | number | The number of elements to be returned. The default is 50 and the maximum is 100. | |
offset | number | The (zero-based) offset into the collection. The default is 0. |
Request Body
{"data"=>{"type"=>"<string>", "attributes"=>{"audienceSegmentIds"=>["<string>", "<string>"], "advertiserIds"=>["<string>", "<string>"], "audienceSegmentTypes"=>["Lookalike", "Retargeting"]}}}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"meta":{"totalItems":"\u003cinteger\u003e","limit":"\u003cinteger\u003e","offset":"\u003cinteger\u003e"},"data":[{"attributes":{"name":"\u003cstring\u003e","description":"\u003cstring\u003e","type":"Prospecting","createdAt":"\u003cdateTime\u003e","updatedAt":"\u003cdateTime\u003e","advertiserId":"\u003cstring\u003e","inMarket":{"country":"\u003cstring\u003e","buyingPower":["Low","High"],"gender":"Unknown","interestIds":["\u003cstring\u003e","\u003cstring\u003e"],"brandIds":["\u003cstring\u003e","\u003cstring\u003e"],"priceRange":["Low","Low"]},"prospecting":{"daysSinceLastVisitMin":"\u003cinteger\u003e","daysSinceLastVisitMax":"\u003cinteger\u003e","usersType":"ProspectsOrNonBuyers"},"contactList":{"isReadOnly":"\u003cboolean\u003e"},"location":{"pointsOfInterest":[{"name":"\u003cstring\u003e","latitude":"\u003cdouble\u003e","longitude":"\u003cdouble\u003e"},{"name":"\u003cstring\u003e","latitude":"\u003cdouble\u003e","longitude":"\u003cdouble\u003e"}],"radiusInKm":"\u003cinteger\u003e","registryType":"PointOfInterest"},"behavioral":{"category":"BuyingPatterns","country":"\u003cstring\u003e","startDate":"\u003cdateTime\u003e","endDate":"\u003cdateTime\u003e"},"retargeting":{"visitorsType":"All","daysSinceLastVisitMin":"\u003cinteger\u003e","daysSinceLastVisitMax":"\u003cinteger\u003e"},"lookalike":{"seedSegmentId":"\u003cstring\u003e","targetSize":"\u003clong\u003e"}},"id":"\u003cstring\u003e","type":"\u003cstring\u003e"},{"attributes":{"name":"\u003cstring\u003e","description":"\u003cstring\u003e","type":"Unknown","createdAt":"\u003cdateTime\u003e","updatedAt":"\u003cdateTime\u003e","advertiserId":"\u003cstring\u003e","inMarket":{"country":"\u003cstring\u003e","buyingPower":["Medium","VeryHigh"],"gender":"Male","interestIds":["\u003cstring\u003e","\u003cstring\u003e"],"brandIds":["\u003cstring\u003e","\u003cstring\u003e"],"priceRange":["Medium","Medium"]},"prospecting":{"daysSinceLastVisitMin":"\u003cinteger\u003e","daysSinceLastVisitMax":"\u003cinteger\u003e","usersType":"Unknown"},"contactList":{"isReadOnly":"\u003cboolean\u003e"},"location":{"pointsOfInterest":[{"name":"\u003cstring\u003e","latitude":"\u003cdouble\u003e","longitude":"\u003cdouble\u003e"},{"name":"\u003cstring\u003e","latitude":"\u003cdouble\u003e","longitude":"\u003cdouble\u003e"}],"radiusInKm":"\u003cinteger\u003e","registryType":"Unknown"},"behavioral":{"category":"Seasonal","country":"\u003cstring\u003e","startDate":"\u003cdateTime\u003e","endDate":"\u003cdateTime\u003e"},"retargeting":{"visitorsType":"Unknown","daysSinceLastVisitMin":"\u003cinteger\u003e","daysSinceLastVisitMax":"\u003cinteger\u003e"},"lookalike":{"seedSegmentId":"\u003cstring\u003e","targetSize":"\u003clong\u003e"}},"id":"\u003cstring\u003e","type":"\u003cstring\u003e"}],"warnings":[{"traceId":"\u003cstring\u003e","traceIdentifier":"\u003cstring\u003e","type":"authorization","code":"\u003cstring\u003e","instance":"\u003cstring\u003e","title":"\u003cstring\u003e","detail":"\u003cstring\u003e","source":{"idf":"\u003cstring\u003e","voluptate4":"\u003cstring\u003e","officia_a":"\u003cstring\u003e"},"stackTrace":"\u003cstring\u003e"},{"traceId":"\u003cstring\u003e","traceIdentifier":"\u003cstring\u003e","type":"authentication","code":"\u003cstring\u003e","instance":"\u003cstring\u003e","title":"\u003cstring\u003e","detail":"\u003cstring\u003e","source":{"sit_0df":"\u003cstring\u003e","Lorem6e":"\u003cstring\u003e"},"stackTrace":"\u003cstring\u003e"}],"errors":[{"traceId":"\u003cstring\u003e","traceIdentifier":"\u003cstring\u003e","type":"quota","code":"\u003cstring\u003e","instance":"\u003cstring\u003e","title":"\u003cstring\u003e","detail":"\u003cstring\u003e","source":{"exercitation_00":"\u003cstring\u003e","ut_7":"\u003cstring\u003e","aliqua4bc":"\u003cstring\u003e","pariatura":"\u003cstring\u003e"},"stackTrace":"\u003cstring\u003e"},{"traceId":"\u003cstring\u003e","traceIdentifier":"\u003cstring\u003e","type":"authorization","code":"\u003cstring\u003e","instance":"\u003cstring\u003e","title":"\u003cstring\u003e","detail":"\u003cstring\u003e","source":{"velit_af":"\u003cstring\u003e","ut580":"\u003cstring\u003e"},"stackTrace":"\u003cstring\u003e"}]}