# Contextual Segments CPM estimates

Get CPM estimates for contextual segments

Endpoint: POST /contextual_segments/cpm_estimate
Version: 3.0.1807
Security: Auth0

## Query parameters:

  - `extended` (boolean)
    Get extended properties in response

## Request fields (application/json):

  - `currency_code` (string, required)
    Example: "USD"

  - `include` (array)

  - `include.code` (string)

  - `include.operator` (string)
    Enum: "AND", "OR"

  - `include.segments` (array)

  - `include.segments.targeting_segment_id` (integer)
    Example: 67

  - `include.segments.user_cpm` (number)
    if provided value will be used instead of segment cpm (value in USD).

  - `exclude` (object)

  - `exclude.code` (string)

  - `exclude.operator` (string)
    Enum: same as `include.operator` (2 values)

  - `exclude.segments` (array)

  - `exclude.segments.targeting_segment_id` (integer)
    Example: 76

  - `exclude.segments.user_cpm` (number)
    if provided value will be used instead of segment cpm

## Response 200 fields (application/json):

  - `data` (object)

  - `data.cpm` (object)

  - `data.cpm.currency_code` (string)

  - `data.cpm.value` (number, required)

  - `data.cpm.includes_taxed_segments` (boolean)

  - `data.cpm.contextual_cpm_min` (number, required)

  - `data.cpm.contextual_cpm_max` (number, required)

  - `data.segments` (array)
    available only when extended

  - `data.segments.id` (integer)
    Example: 3

  - `data.segments.name` (string)

  - `data.segments.full_path` (string)

  - `data.segments.cpm` (number)

  - `data.segments.user_cpm` (number,null)

  - `data.segments.segment_objective_name` (string)

  - `data.segments.uniques` (integer,null)
    Example: 12345

  - `meta` (object)

  - `meta.status` (string)
    Example: "success"

## Response 400 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string)

  - `errors.field` (string)
    Optional when it is a schema error

  - `errors.message` (string)

  - `meta` (object, required)

  - `meta.status` (string, required)


