---
title: "/2026-01/marketing-solutions/audience-segments/estimate-size"
method: POST
path: "/2026-01/marketing-solutions/audience-segments/estimate-size"
tags: ["Audience"]
---

# /2026-01/marketing-solutions/audience-segments/estimate-size

`POST /2026-01/marketing-solutions/audience-segments/estimate-size`

Gets the size estimation of a non existent segment. An error is returned when size calculation is not supported.

## Request body

- AudienceSegmentEstimateSizeInputV1 — Input to estimate the size of an audience segment..
  - `data` AudienceSegmentSizeEstimationEntityV1Resource — A top-level object that encapsulates a Criteo API response for a single value
    - `attributes` AudienceSegmentSizeEstimationEntityV1 — Set of rules that defines specific people to target.
      - `advertiserId` string, required — Advertiser associated to the segment
      - `inMarket` InMarketSizeEstimationV1 — Settings to target users based on high shopping intents and demographics.
        - `brandIds` string[]
        - `buyingPower` string[]
        - `country` string, required
        - `gender` 'Male' | 'Female'
        - `interestIds` string[]
        - `priceRange` string[]
      - `location` LocationSizeEstimationV1 — Settings to define your audience based on their location.
        - `pointsOfInterest` PointOfInterestV1[], required
          - `latitude` number, double, nullable — ISO-6709 latitude (rounded at 5 decimals)
          - `longitude` number, double, nullable — ISO-6709 longitude (rounded at 5 decimals)
          - `name` string, nullable — Name of the point of interest
        - `radiusInKm` integer, required
    - `type` string

## Response `200`

Success

- AudienceSegmentSizeEstimationV1Response — A top-level object that encapsulates a Criteo API response for a single value
  - `data` AudienceSegmentSizeEstimationV1Resource, nullable — A top-level object that encapsulates a Criteo API response for a single value
    - `attributes` AudienceSegmentSizeEstimationV1, nullable — Segment size estimation
      - `size` integer, nullable
    - `type` string, nullable
  - `errors` CommonProblem[], nullable
    - `code` string, nullable — A machine-readable error code, expressed as a string value.
    - `detail` string, nullable — A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable — A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable — A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable — A short human-readable description of the problem type
    - `traceId` string, nullable — The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable — The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.
  - `warnings` CommonProblem[], nullable
    - `code` string, nullable — A machine-readable error code, expressed as a string value.
    - `detail` string, nullable — A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable — A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable — A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable — A short human-readable description of the problem type
    - `traceId` string, nullable — The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable — The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.

---

[API](https://skmtc.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/revisions/c1721589426a/schema)