openapi: 3.0.3
components:
  schemas:
    Error:
      type: object
      properties:
        error_code:
          type: string
        message:
          type: string
        request_id:
          type: string
    StreamingResponse:
      type: string
      title: Streaming Response
      description: >-
        Documentation available at
        https://apidocs.mediamath.com/docs/reporting-api-v2
      example: >-
        {"fields":[{"name":"agg_timestamp"},{"name":"campaign_id"},{"name":"impressions"}],"total_items_count":14}

        {"campaign_id":102461,"impressions":93283,"agg_timestamp":"2023-03-01T15:00:00Z"}

        {"campaign_id":1228153,"impressions":484,"agg_timestamp":"2023-03-01T15:00:00Z"}

        {"campaign_id":1245119,"impressions":0,"agg_timestamp":"2023-03-01T15:00:00Z"}
  responses:
    BadRequest:
      description: The request is not valid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: The requested resource could not be found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServerError:
      description: An error occurred
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    Auth0:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://auth.mediamath.com/authorize
          tokenUrl: https://auth.mediamath.com/oauth/token
          refreshUrl: https://auth.mediamath.com/authorize?scope=offline_access
          scopes:
            offline_access: for refresh tokens
info:
  title: Reporting API V2
  description: >
    OpenAPI 3.0 spec of the Reporting API.


    <!-- theme: warning -->

    > ### Documentation WIP

    >

    > We are actively working on improving these docs. Please reach out if you
    have any feedback or suggestions.

    > 


    <!-- theme: info -->

    > ### Beta datasets

    >

    > Datasets marked as **(beta)** are subject to change or removal without
    prior notice, and are offered as is with no support.
  contact:
    name: Support
    url: https://mediamathsupport.force.com/
    email: developers@mediamath.com
  version: 1.0.0
paths:
  /all-dimensions-and-metrics:
    post:
      tags:
        - Datasets
      summary: All Dimensions and Metrics Report
      description: "\nStandard performance metrics in campaign currency and broken out by our widest array of dimensions.\nAvailable in custom date ranges or intervals with the option to aggregate by day, week, or month.\n\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`agg_timestamp`|`current_day`, `last_X_days`, `month_to_date`, `yesterday`|`by_day`, `by_month`, `by_week`|\n|`ads_txt_type`<br>Ads.txt Type|Any|Any|\n|`ads_txt_verified`<br>Ads.txt Verified|Any|Any|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`app_id`<br>|Any|Any|\n|`app_name`<br>|Any|Any|\n|`attribution_group`<br>|Any|Any|\n|`auction_type`<br>|Any|Any|\n|`bid_price_impact`<br>|Any|Any|\n|`browser`<br>|Any|Any|\n|`browser_version`<br>|Any|Any|\n|`campaign_ads_txt_verified`<br>|Any|Any|\n|`campaign_agency_fee_pct`<br>|Any|Any|\n|`campaign_archived`<br>|Any|Any|\n|`campaign_bid_min_devices`<br>|Any|Any|\n|`campaign_brain_intraday_pacing`<br>|Any|Any|\n|`campaign_connected_id_type`<br>|Any|Any|\n|`campaign_conversion_type`<br>|Any|Any|\n|`campaign_conversion_variable_minutes`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_value`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_value`<br>|Any|Any|\n|`campaign_created_on`<br>Campaign Creation Time|Any|Any|\n|`campaign_currency_code`<br>Campaign Currency Code|Any|Any|\n|`campaign_custom_attribution_source`<br>|Any|Any|\n|`campaign_dcs_data_is_campaign_level`<br>|Any|Any|\n|`campaign_device_graph_only`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_applied`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_available`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_type`<br>|Any|Any|\n|`campaign_end_date`<br>(GMT) Campaign End Date|Any|Any|\n|`campaign_end_date_tz`<br>(CTZ) Campaign End Date|Any|Any|\n|`campaign_frequency_amount`<br>Campaign Frequency Amount|Any|Any|\n|`campaign_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`campaign_frequency_optimization`<br>Campaign Frequency Optimization|Any|Any|\n|`campaign_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`campaign_goal_alert`<br>|Any|Any|\n|`campaign_goal_category`<br>|Any|Any|\n|`campaign_goal_type`<br>|Any|Any|\n|`campaign_goal_value`<br>|Any|Any|\n|`campaign_has_custom_attribution`<br>|Any|Any|\n|`campaign_id`<br>|Any|Any|\n|`campaign_impression_cap_amount`<br>|Any|Any|\n|`campaign_impression_cap_automatic`<br>|Any|Any|\n|`campaign_impression_cap_type`<br>|Any|Any|\n|`campaign_in_flight`<br>In Flight|Any|Any|\n|`campaign_initial_start_date`<br>(GMT) Campaign Initial Start Date|Any|Any|\n|`campaign_initial_start_date_tz`<br>(CTZ) Campaign Initial Start Date|Any|Any|\n|`campaign_io_name`<br>|Any|Any|\n|`campaign_io_reference_num`<br>|Any|Any|\n|`campaign_is_programmatic_guaranteed`<br>Campaign Is Programmatic Guaranteed|Any|Any|\n|`campaign_merit_pixel_id`<br>|Any|Any|\n|`campaign_minimize_multi_ads`<br>Minimize Multi Ads|Any|Any|\n|`campaign_name`<br>|Any|Any|\n|`campaign_override_suspicious_traffic_filter`<br>|Any|Any|\n|`campaign_pacing_alert`<br>|Any|Any|\n|`campaign_pc_window_minutes`<br>|Any|Any|\n|`campaign_political`<br>|Any|Any|\n|`campaign_pv_pct`<br>|Any|Any|\n|`campaign_pv_window_minutes`<br>|Any|Any|\n|`campaign_restrict_targeting_to_deterministic_id`<br>|Any|Any|\n|`campaign_restrict_targeting_to_same_device_id`<br>|Any|Any|\n|`campaign_service_type`<br>Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag|Any|Any|\n|`campaign_source_campaign_id`<br>|Any|Any|\n|`campaign_spend_cap_amount`<br>|Any|Any|\n|`campaign_spend_cap_automatic`<br>|Any|Any|\n|`campaign_spend_cap_daily_cap`<br>|Any|Any|\n|`campaign_spend_cap_type`<br>|Any|Any|\n|`campaign_start_date`<br>(GMT) Campaign Start Date|Any|Any|\n|`campaign_start_date_tz`<br>(CTZ) Campaign Start Date|Any|Any|\n|`campaign_status`<br>Active Status|Any|Any|\n|`campaign_suspicious_traffic_filter_level`<br>|Any|Any|\n|`campaign_total_budget`<br>|Any|Any|\n|`campaign_total_impression_budget`<br>Campaign Impressions Budget|Any|Any|\n|`campaign_updated_on`<br>Campaign Update Time|Any|Any|\n|`campaign_version`<br>|Any|Any|\n|`campaign_zone_name`<br>Campaign Time Zone, a.k.a time_zone|Any|Any|\n|`channel_type`<br>|Any|Any|\n|`city_code`<br>|Any|Any|\n|`city_name`<br>|Any|Any|\n|`concept_id`<br>|Any|Any|\n|`concept_name`<br>|Any|Any|\n|`conn_speed`<br>Connection Speed|Any|Any|\n|`conn_speed_name`<br>|Any|Any|\n|`content_title`<br>|Any|Any|\n|`country`<br>|Any|Any|\n|`country_name`<br>|Any|Any|\n|`creative_file_type`<br>|Any|Any|\n|`creative_has_sound`<br>|Any|Any|\n|`creative_id`<br>|Any|Any|\n|`creative_is_native`<br>|Any|Any|\n|`creative_name`<br>|Any|Any|\n|`creative_rich_media`<br>|Any|Any|\n|`creative_size`<br>|Any|Any|\n|`creative_tpas_placement_id`<br>|Any|Any|\n|`creative_tpas_placement_name`<br>|Any|Any|\n|`currency_rate_date`<br>|Any|Any|\n|`currency_rate_rate`<br>|Any|Any|\n|`deal_exchange_id`<br>|Any|Any|\n|`deal_external_id`<br>|Any|Any|\n|`deal_group_id`<br>|Any|Any|\n|`deal_group_name`<br>|Any|Any|\n|`deal_id`<br>|Any|Any|\n|`deal_name`<br>|Any|Any|\n|`deal_organization_id`<br>|Any|Any|\n|`deal_price_type`<br>|Any|Any|\n|`deal_publisher_id`<br>Deal Publisher ID|Any|Any|\n|`device_make`<br>|Any|Any|\n|`device_model`<br>|Any|Any|\n|`exchange_id`<br>|Any|Any|\n|`exchange_name`<br>|Any|Any|\n|`flight_id`<br>|Any|Any|\n|`form_factor`<br>Device Type|Any|Any|\n|`inventory_browser_type`<br>|Any|Any|\n|`inventory_market_type`<br>|Any|Any|\n|`isp`<br>|Any|Any|\n|`isp_name`<br>|Any|Any|\n|`margin_date`<br>|Any|Any|\n|`margin_pct`<br>|Any|Any|\n|`metro_code`<br>|Any|Any|\n|`metro_name`<br>|Any|Any|\n|`mm_buying_modality`<br>Buying Modality|Any|Any|\n|`openrtb_device_type`<br>OpenRTB Device Type|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|`os_type`<br>OS Type|Any|Any|\n|`os_version`<br>OS Version|Any|Any|\n|`postal_code_name`<br>|Any|Any|\n|`prisma_campaign_id`<br>|Any|Any|\n|`prisma_client_product_estimate`<br>|Any|Any|\n|`prisma_io_number`<br>|Any|Any|\n|`publisher_description`<br>|Any|Any|\n|`publisher_id`<br>|Any|Any|\n|`region`<br>|Any|Any|\n|`region_name`<br>|Any|Any|\n|`site_domain`<br>|Any|Any|\n|`strategy_ads_txt_verified`<br>|Any|Any|\n|`strategy_archived`<br>|Any|Any|\n|`strategy_audience_segment_exclude_op`<br>|Any|Any|\n|`strategy_audience_segment_include_op`<br>|Any|Any|\n|`strategy_bid_aggressiveness`<br>|Any|Any|\n|`strategy_bid_min_devices`<br>|Any|Any|\n|`strategy_bid_price_is_media_only`<br>|Any|Any|\n|`strategy_budget`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_value`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_value`<br>|Any|Any|\n|`strategy_created_on`<br>|Any|Any|\n|`strategy_currency_code`<br>|Any|Any|\n|`strategy_description`<br>|Any|Any|\n|`strategy_device_graph_only`<br>|Any|Any|\n|`strategy_end_date_raw`<br>|Any|Any|\n|`strategy_exchange_type_for_run_on_all`<br>|Any|Any|\n|`strategy_feature_compatibility`<br>|Any|Any|\n|`strategy_frequency_amount`<br>|Any|Any|\n|`strategy_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`strategy_frequency_optimization`<br>|Any|Any|\n|`strategy_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`strategy_goal_type`<br>|Any|Any|\n|`strategy_goal_value`<br>|Any|Any|\n|`strategy_groups`<br>|Any|Any|\n|`strategy_id`<br>|Any|Any|\n|`strategy_impression_pacing_amount`<br>|Any|Any|\n|`strategy_impression_pacing_interval`<br>|Any|Any|\n|`strategy_impression_pacing_type`<br>|Any|Any|\n|`strategy_max_bid`<br>|Any|Any|\n|`strategy_max_bid_wm`<br>|Any|Any|\n|`strategy_media_type`<br>|Any|Any|\n|`strategy_min_bid`<br>|Any|Any|\n|`strategy_name`<br>|Any|Any|\n|`strategy_pacing_amount`<br>|Any|Any|\n|`strategy_pacing_interval`<br>|Any|Any|\n|`strategy_pacing_optimization_amount`<br>|Any|Any|\n|`strategy_pacing_optimization_type`<br>|Any|Any|\n|`strategy_pacing_type`<br>|Any|Any|\n|`strategy_roi_target`<br>|Any|Any|\n|`strategy_run_on_all_exchanges`<br>|Any|Any|\n|`strategy_run_on_all_pmp`<br>|Any|Any|\n|`strategy_run_on_display`<br>|Any|Any|\n|`strategy_run_on_mobile`<br>|Any|Any|\n|`strategy_run_on_only_fraud_filtered_exchanges`<br>|Any|Any|\n|`strategy_run_on_streaming`<br>|Any|Any|\n|`strategy_site_restriction_transparent_urls`<br>|Any|Any|\n|`strategy_site_selectiveness`<br>|Any|Any|\n|`strategy_source_only`<br>|Any|Any|\n|`strategy_start_date_raw`<br>|Any|Any|\n|`strategy_status`<br>Active Status|Any|Any|\n|`strategy_supply_type`<br>|Any|Any|\n|`strategy_targeting_segment_exclude_op`<br>|Any|Any|\n|`strategy_targeting_segment_include_op`<br>|Any|Any|\n|`strategy_type`<br>|Any|Any|\n|`strategy_updated_on`<br>|Any|Any|\n|`strategy_use_bid_shading`<br>|Any|Any|\n|`strategy_use_campaign_end`<br>|Any|Any|\n|`strategy_use_campaign_start`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing_after_date`<br>|Any|Any|\n|`strategy_use_mm_freq`<br>|Any|Any|\n|`strategy_use_optimization`<br>|Any|Any|\n|`strategy_version`<br>|Any|Any|\n|`strategy_zone_name`<br>|Any|Any|\n|`video_placement`<br>|Any|Any|\n|`video_skippability`<br>|Any|Any|\n|`zip`<br>|Any|Any|\n|**Metrics**|\n|`accept_invitation_count`<br>|Any|Any|\n|`calculated_impressions`<br>|Any|Any|\n|`clicks`<br>|Any|Any|\n|`ctc`<br>CTC|Any|Any|\n|`ctr`<br>CTR|Any|Any|\n|`general_invalid_clicks`<br>|Any|Any|\n|`impressions`<br>|Any|Any|\n|`in_view`<br>In View Impressions|Any|Any|\n|`in_view_100_percent`<br>100% In View Impressions|Any|Any|\n|`in_view_15_seconds`<br>In View - 15 Seconds|Any|Any|\n|`in_view_15_seconds_rate`<br>In View 15 Seconds Rate|Any|Any|\n|`in_view_5_seconds`<br>In View - 5 Seconds|Any|Any|\n|`in_view_5_seconds_rate`<br>In View 5 Seconds Rate|Any|Any|\n|`in_view_q1`<br>|Any|Any|\n|`in_view_q2`<br>|Any|Any|\n|`in_view_q3`<br>|Any|Any|\n|`in_view_q4`<br>|Any|Any|\n|`measurability_rate`<br>Measurability Rate|Any|Any|\n|`measurable`<br>Measurable Impressions|Any|Any|\n|`media_cost`<br>|Any|Any|\n|`media_cost_usd`<br>(USD) Media Cost|Any|Any|\n|`non_watermark_impressions`<br>Non-Watermark Impressions|Any|Any|\n|`non_watermark_spend_usd`<br>Non-Watermark Spend (USD)|Any|Any|\n|`post_click_aov`<br>Post-Click AOV|Any|Any|\n|`post_click_aov_usd`<br>(USD) Post-Click AOV|Any|Any|\n|`post_click_conversions`<br>Post-Click Conversions|Any|Any|\n|`post_click_revenue`<br>Post-Click Revenue|Any|Any|\n|`post_click_revenue_usd`<br>(USD) Post-Click Revenue|Any|Any|\n|`post_click_total_spend_roi`<br>Post-Click Total Spend ROI|Any|Any|\n|`post_view_aov`<br>Post-View AOV|Any|Any|\n|`post_view_aov_usd`<br>(USD) Post-View AOV|Any|Any|\n|`post_view_conversions`<br>Post-View Conversions|Any|Any|\n|`post_view_revenue`<br>Post-View Revenue|Any|Any|\n|`post_view_revenue_usd`<br>(USD) Post-View Revenue|Any|Any|\n|`post_view_total_spend_roi`<br>Post-View Total Spend ROI|Any|Any|\n|`rr_per_1k_imps`<br>Response Rate/1K Imps|Any|Any|\n|`third_party_events`<br>3PA Events|Any|Any|\n|`third_party_revenue`<br>3PA Total Revenue|Any|Any|\n|`third_party_revenue_usd`<br>(USD) 3PA Total Revenue|Any|Any|\n|`total_aov`<br>Total AOV|Any|Any|\n|`total_aov_usd`<br>(USD) Total AOV|Any|Any|\n|`total_clicks`<br>|Any|Any|\n|`total_conversions`<br>|Any|Any|\n|`total_revenue`<br>|Any|Any|\n|`total_revenue_usd`<br>(USD) Total Revenue|Any|Any|\n|`total_spend`<br>|Any|Any|\n|`total_spend_cpa`<br>Total Spend eCPA|Any|Any|\n|`total_spend_cpa_usd`<br>(USD) Total Spend eCPA|Any|Any|\n|`total_spend_cpc`<br>Total Spend eCPC|Any|Any|\n|`total_spend_cpc_usd`<br>(USD) Total Spend eCPC|Any|Any|\n|`total_spend_cpcv`<br>Total Spend eCPCV|Any|Any|\n|`total_spend_cpcv_usd`<br>(USD) Total Spend eCPCV|Any|Any|\n|`total_spend_cpm`<br>Total Spend eCPM|Any|Any|\n|`total_spend_cpm_usd`<br>(USD) Total Spend eCPM|Any|Any|\n|`total_spend_pc_cpa`<br>Total Spend PC CPA|Any|Any|\n|`total_spend_pc_cpa_usd`<br>(USD) Total Spend PC CPA|Any|Any|\n|`total_spend_pv_cpa`<br>Total Spend PV CPA|Any|Any|\n|`total_spend_pv_cpa_usd`<br>(USD) Total Spend PV CPA|Any|Any|\n|`total_spend_roi`<br>Total Spend ROI|Any|Any|\n|`total_spend_usd`<br>(USD) Total Spend|Any|Any|\n|`total_spend_vcpm`<br>Total Spend vCPM |Any|Any|\n|`total_spend_vcpm_usd`<br>(USD) Total Spend vCPM |Any|Any|\n|`video_close`<br>Close|Any|Any|\n|`video_collapse`<br>Collapse|Any|Any|\n|`video_companion_clicks`<br>Companion Clicks|Any|Any|\n|`video_companion_ctr`<br>Companion CTR|Any|Any|\n|`video_companion_impressions`<br>Companion Impressions|Any|Any|\n|`video_complete`<br>100% Completed Views|Any|Any|\n|`video_complete_rate`<br>100% Completed Rate|Any|Any|\n|`video_complete_rate_impression_based`<br>100% Completed Rate - Impressions Based|Any|Any|\n|`video_engaged_impressions`<br>Engaged Impressions|Any|Any|\n|`video_engaged_rate`<br>Engaged Rate|Any|Any|\n|`video_expand`<br>Expand|Any|Any|\n|`video_first_quartile`<br>25% Completed Views|Any|Any|\n|`video_first_quartile_rate`<br>25% Completed Rate|Any|Any|\n|`video_first_quartile_rate_impression_based`<br>25% Completed Rate - Impressions Based|Any|Any|\n|`video_fullscreen`<br>Fullscreen|Any|Any|\n|`video_midpoint`<br>50% Completed Views|Any|Any|\n|`video_midpoint_rate`<br>50% Completed Rate|Any|Any|\n|`video_midpoint_rate_impression_based`<br>50% Completed Rate - Impressions Based|Any|Any|\n|`video_mute`<br>Mute|Any|Any|\n|`video_pause`<br>Pause|Any|Any|\n|`video_play_rate`<br>Play Rate|Any|Any|\n|`video_resume`<br>Resume|Any|Any|\n|`video_rewind`<br>Rewind|Any|Any|\n|`video_skip`<br>Skip|Any|Any|\n|`video_skippable_impressions`<br>Skippable Impressions|Any|Any|\n|`video_skipped_impressions`<br>Skipped Impressions|Any|Any|\n|`video_skipped_rate`<br>Skipped Rate|Any|Any|\n|`video_start`<br>Start|Any|Any|\n|`video_third_quartile`<br>75% Completed Views|Any|Any|\n|`video_third_quartile_rate`<br>75% Completed Rate|Any|Any|\n|`video_third_quartile_rate_impression_based`<br>75% Completed Rate - Impressions Based|Any|Any|\n|`video_unmute`<br>Unmute|Any|Any|\n|`viewability_rate`<br>Viewability Rate|Any|Any|\n|`viewability_rate_100_percent`<br>100% In View Rate|Any|Any|\n|`watermark_impressions`<br>|Any|Any|\n|`watermark_spend_pct`<br>Watermark Spend Percent|Any|Any|\n|`watermark_spend_usd`<br>Watermark Spend (USD)|Any|Any|\n\n### Pageable\nNo\n\n### Time Windows\n`current_day`, `last_X_days`, `month_to_date`, `yesterday`\n\n### Rollups\n`all`, `by_day`, `by_month`, `by_week`\n\n\n### Data Retention / Lookback Window\n1 year\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - title: Time Window
                  required:
                    - time_window
                - title: Date Range
                  required:
                    - start_time
              required:
                - fields
                - filters
                - order
                - rollup
              properties:
                end_time:
                  type: string
                  format: date-time
                  nullable: true
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                rollup:
                  type: string
                start_time:
                  type: string
                  format: date-time
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /audience-index:
    post:
      tags:
        - Datasets
      summary: Audience Index
      description: "\n\nSpecial index metrics for comparing your site visitors to 3rd party segments. \nBroken out by audience name and pixel.\n\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`audience_id`<br>|Any|Any|\n|`audience_name`<br>|Any|Any|\n|`audience_path`<br>|Any|Any|\n|`campaign_ads_txt_verified`<br>|Any|Any|\n|`campaign_agency_fee_pct`<br>|Any|Any|\n|`campaign_archived`<br>|Any|Any|\n|`campaign_bid_min_devices`<br>|Any|Any|\n|`campaign_brain_intraday_pacing`<br>|Any|Any|\n|`campaign_connected_id_type`<br>|Any|Any|\n|`campaign_conversion_type`<br>|Any|Any|\n|`campaign_conversion_variable_minutes`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_value`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_value`<br>|Any|Any|\n|`campaign_created_on`<br>Campaign Creation Time|Any|Any|\n|`campaign_currency_code`<br>Campaign Currency Code|Any|Any|\n|`campaign_custom_attribution_source`<br>|Any|Any|\n|`campaign_dcs_data_is_campaign_level`<br>|Any|Any|\n|`campaign_device_graph_only`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_applied`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_available`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_type`<br>|Any|Any|\n|`campaign_end_date`<br>(GMT) Campaign End Date|Any|Any|\n|`campaign_end_date_tz`<br>(CTZ) Campaign End Date|Any|Any|\n|`campaign_frequency_amount`<br>Campaign Frequency Amount|Any|Any|\n|`campaign_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`campaign_frequency_optimization`<br>Campaign Frequency Optimization|Any|Any|\n|`campaign_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`campaign_goal_alert`<br>|Any|Any|\n|`campaign_goal_category`<br>|Any|Any|\n|`campaign_goal_type`<br>|Any|Any|\n|`campaign_goal_value`<br>|Any|Any|\n|`campaign_has_custom_attribution`<br>|Any|Any|\n|`campaign_id`<br>|Any|Any|\n|`campaign_impression_cap_amount`<br>|Any|Any|\n|`campaign_impression_cap_automatic`<br>|Any|Any|\n|`campaign_impression_cap_type`<br>|Any|Any|\n|`campaign_in_flight`<br>In Flight|Any|Any|\n|`campaign_initial_start_date`<br>(GMT) Campaign Initial Start Date|Any|Any|\n|`campaign_initial_start_date_tz`<br>(CTZ) Campaign Initial Start Date|Any|Any|\n|`campaign_io_name`<br>|Any|Any|\n|`campaign_io_reference_num`<br>|Any|Any|\n|`campaign_is_programmatic_guaranteed`<br>Campaign Is Programmatic Guaranteed|Any|Any|\n|`campaign_merit_pixel_id`<br>|Any|Any|\n|`campaign_minimize_multi_ads`<br>Minimize Multi Ads|Any|Any|\n|`campaign_name`<br>|Any|Any|\n|`campaign_override_suspicious_traffic_filter`<br>|Any|Any|\n|`campaign_pacing_alert`<br>|Any|Any|\n|`campaign_pc_window_minutes`<br>|Any|Any|\n|`campaign_political`<br>|Any|Any|\n|`campaign_pv_pct`<br>|Any|Any|\n|`campaign_pv_window_minutes`<br>|Any|Any|\n|`campaign_restrict_targeting_to_deterministic_id`<br>|Any|Any|\n|`campaign_restrict_targeting_to_same_device_id`<br>|Any|Any|\n|`campaign_service_type`<br>Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag|Any|Any|\n|`campaign_source_campaign_id`<br>|Any|Any|\n|`campaign_spend_cap_amount`<br>|Any|Any|\n|`campaign_spend_cap_automatic`<br>|Any|Any|\n|`campaign_spend_cap_daily_cap`<br>|Any|Any|\n|`campaign_spend_cap_type`<br>|Any|Any|\n|`campaign_start_date`<br>(GMT) Campaign Start Date|Any|Any|\n|`campaign_start_date_tz`<br>(CTZ) Campaign Start Date|Any|Any|\n|`campaign_status`<br>Active Status|Any|Any|\n|`campaign_suspicious_traffic_filter_level`<br>|Any|Any|\n|`campaign_total_budget`<br>|Any|Any|\n|`campaign_total_impression_budget`<br>Campaign Impressions Budget|Any|Any|\n|`campaign_updated_on`<br>Campaign Update Time|Any|Any|\n|`campaign_version`<br>|Any|Any|\n|`campaign_zone_name`<br>Campaign Time Zone, a.k.a time_zone|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|**Metrics**|\n|`audience_index`<br>Measure of users exposed to your site/media against general internet population|Any|Any|\n|`matched_impressions`<br>|Any|Any|\n\n### Pageable\nYes\n\n### Time Windows\n`last_14_days`\n\n### Rollups\n`all`\n\n\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required:
                - fields
                - filters
                - order
                - rollup
                - time_window
              properties:
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                pagination:
                  type: object
                  description: >-
                    Streaming response if absent or `null`, Paginated response
                    otherwise
                  nullable: true
                  properties:
                    page_index:
                      type: integer
                      minimum: 0
                    page_size:
                      type: integer
                      minimum: 1
                      maximum: 1000
                rollup:
                  type: string
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    type: object
                    properties:
                      items_count:
                        type: integer
                        minimum: 0
                      page_index:
                        type: integer
                        minimum: 0
                      status:
                        type: string
                        enum:
                          - ok
                      total_items_count:
                        type: integer
                        minimum: 0
                      total_pages:
                        type: integer
                        minimum: 0
                  results:
                    type: array
                    items:
                      type: object
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /audience-index-pixel:
    post:
      tags:
        - Datasets
      summary: Audience Index Pixel
      description: "\nSpecial index metrics for comparing your site visitors to 3rd party segments.  Broken out by audience name and pixel.  Currently available in one interval: last 14 days.\n\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`audience_id`<br>|Any|Any|\n|`audience_name`<br>|Any|Any|\n|`audience_path`<br>|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|`pixel_advertiser_id`<br>|Any|Any|\n|`pixel_created_on`<br>Pixel Creation Time|Any|Any|\n|`pixel_external_identifier`<br>|Any|Any|\n|`pixel_id`<br>|Any|Any|\n|`pixel_name`<br>|Any|Any|\n|`pixel_provider_created_on`<br>|Any|Any|\n|`pixel_provider_id`<br>|Any|Any|\n|`pixel_provider_name`<br>|Any|Any|\n|`pixel_provider_updated_on`<br>|Any|Any|\n|`pixel_status`<br>|Any|Any|\n|`pixel_tag_type`<br>|Any|Any|\n|`pixel_type`<br>|Any|Any|\n|`pixel_updated_on`<br>Pixel Update Time|Any|Any|\n|**Metrics**|\n|`audience_index`<br>Measure of users exposed to your site/media against general internet population|Any|Any|\n|`matched_users`<br>|Any|Any|\n\n### Pageable\nYes\n\n### Time Windows\n`last_14_days`\n\n### Rollups\n`all`\n\n\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required:
                - fields
                - filters
                - order
                - rollup
                - time_window
              properties:
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                pagination:
                  type: object
                  description: >-
                    Streaming response if absent or `null`, Paginated response
                    otherwise
                  nullable: true
                  properties:
                    page_index:
                      type: integer
                      minimum: 0
                    page_size:
                      type: integer
                      minimum: 1
                      maximum: 1000
                rollup:
                  type: string
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    type: object
                    properties:
                      items_count:
                        type: integer
                        minimum: 0
                      page_index:
                        type: integer
                        minimum: 0
                      status:
                        type: string
                        enum:
                          - ok
                      total_items_count:
                        type: integer
                        minimum: 0
                      total_pages:
                        type: integer
                        minimum: 0
                  results:
                    type: array
                    items:
                      type: object
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /brain-feature-summary:
    post:
      tags:
        - Datasets
      summary: Brain Feature Summary Report
      description: "\nBrain Feature Summary Report\n\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`campaign_id`<br>|Any|Any|\n|`campaign_name`<br>|Any|Any|\n|`feature`<br>|Any|Any|\n|`index`<br>|Any|Any|\n|`model_goal`<br>|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|`position`<br>|Any|Any|\n|**Metrics**|\n\n### Pageable\nYes\n\n### Time Windows\n`last_X_days`, `month_to_date`, `yesterday`\n\n### Rollups\n`by_day`\n\n\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - title: Time Window
                  required:
                    - time_window
                - title: Date Range
                  required:
                    - start_time
              required:
                - fields
                - filters
                - order
                - rollup
              properties:
                end_time:
                  type: string
                  format: date-time
                  nullable: true
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                pagination:
                  type: object
                  description: >-
                    Streaming response if absent or `null`, Paginated response
                    otherwise
                  nullable: true
                  properties:
                    page_index:
                      type: integer
                      minimum: 0
                    page_size:
                      type: integer
                      minimum: 1
                      maximum: 1000
                rollup:
                  type: string
                start_time:
                  type: string
                  format: date-time
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    type: object
                    properties:
                      items_count:
                        type: integer
                        minimum: 0
                      page_index:
                        type: integer
                        minimum: 0
                      status:
                        type: string
                        enum:
                          - ok
                      total_items_count:
                        type: integer
                        minimum: 0
                      total_pages:
                        type: integer
                        minimum: 0
                  results:
                    type: array
                    items:
                      type: object
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /brain-feature-value:
    post:
      tags:
        - Datasets
      summary: Brain Feature Value Report
      description: "\nBrain Feature Value Report\n\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`bid_impact`<br>|Any|Any|\n|`campaign_id`<br>|Any|Any|\n|`campaign_name`<br>|Any|Any|\n|`feature`<br>|Any|Any|\n|`feature_report_type`<br>|Any|Any|\n|`feature_value`<br>|Any|Any|\n|`index`<br>|Any|Any|\n|`is_numeric`<br>|Any|Any|\n|`mean`<br>|Any|Any|\n|`model_goal`<br>|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|`position`<br>|Any|Any|\n|**Metrics**|\n\n### Pageable\nYes\n\n### Time Windows\n`last_X_days`, `month_to_date`, `yesterday`\n\n### Rollups\n`by_day`\n\n\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - title: Time Window
                  required:
                    - time_window
                - title: Date Range
                  required:
                    - start_time
              required:
                - fields
                - filters
                - order
                - rollup
              properties:
                end_time:
                  type: string
                  format: date-time
                  nullable: true
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                pagination:
                  type: object
                  description: >-
                    Streaming response if absent or `null`, Paginated response
                    otherwise
                  nullable: true
                  properties:
                    page_index:
                      type: integer
                      minimum: 0
                    page_size:
                      type: integer
                      minimum: 1
                      maximum: 1000
                rollup:
                  type: string
                start_time:
                  type: string
                  format: date-time
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    type: object
                    properties:
                      items_count:
                        type: integer
                        minimum: 0
                      page_index:
                        type: integer
                        minimum: 0
                      status:
                        type: string
                        enum:
                          - ok
                      total_items_count:
                        type: integer
                        minimum: 0
                      total_pages:
                        type: integer
                        minimum: 0
                  results:
                    type: array
                    items:
                      type: object
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /contextual-insights:
    post:
      tags:
        - Datasets
      summary: Contextual Insights
      description: "\nStandard performance metrics broken out by contextual categories that strategies are targeting\n\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`agg_timestamp`|`current_day`, `last_X_days`, `month_to_date`, `yesterday`|`by_day`, `by_month`, `by_week`|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`attribution_group`<br>|Any|Any|\n|`campaign_ads_txt_verified`<br>|Any|Any|\n|`campaign_agency_fee_pct`<br>|Any|Any|\n|`campaign_archived`<br>|Any|Any|\n|`campaign_bid_min_devices`<br>|Any|Any|\n|`campaign_brain_intraday_pacing`<br>|Any|Any|\n|`campaign_connected_id_type`<br>|Any|Any|\n|`campaign_conversion_type`<br>|Any|Any|\n|`campaign_conversion_variable_minutes`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_value`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_value`<br>|Any|Any|\n|`campaign_created_on`<br>Campaign Creation Time|Any|Any|\n|`campaign_currency_code`<br>Campaign Currency Code|Any|Any|\n|`campaign_custom_attribution_source`<br>|Any|Any|\n|`campaign_dcs_data_is_campaign_level`<br>|Any|Any|\n|`campaign_device_graph_only`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_applied`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_available`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_type`<br>|Any|Any|\n|`campaign_end_date`<br>(GMT) Campaign End Date|Any|Any|\n|`campaign_end_date_tz`<br>(CTZ) Campaign End Date|Any|Any|\n|`campaign_frequency_amount`<br>Campaign Frequency Amount|Any|Any|\n|`campaign_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`campaign_frequency_optimization`<br>Campaign Frequency Optimization|Any|Any|\n|`campaign_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`campaign_goal_alert`<br>|Any|Any|\n|`campaign_goal_category`<br>|Any|Any|\n|`campaign_goal_type`<br>|Any|Any|\n|`campaign_goal_value`<br>|Any|Any|\n|`campaign_has_custom_attribution`<br>|Any|Any|\n|`campaign_id`<br>|Any|Any|\n|`campaign_impression_cap_amount`<br>|Any|Any|\n|`campaign_impression_cap_automatic`<br>|Any|Any|\n|`campaign_impression_cap_type`<br>|Any|Any|\n|`campaign_in_flight`<br>In Flight|Any|Any|\n|`campaign_initial_start_date`<br>(GMT) Campaign Initial Start Date|Any|Any|\n|`campaign_initial_start_date_tz`<br>(CTZ) Campaign Initial Start Date|Any|Any|\n|`campaign_io_name`<br>|Any|Any|\n|`campaign_io_reference_num`<br>|Any|Any|\n|`campaign_is_programmatic_guaranteed`<br>Campaign Is Programmatic Guaranteed|Any|Any|\n|`campaign_merit_pixel_id`<br>|Any|Any|\n|`campaign_minimize_multi_ads`<br>Minimize Multi Ads|Any|Any|\n|`campaign_name`<br>|Any|Any|\n|`campaign_override_suspicious_traffic_filter`<br>|Any|Any|\n|`campaign_pacing_alert`<br>|Any|Any|\n|`campaign_pc_window_minutes`<br>|Any|Any|\n|`campaign_political`<br>|Any|Any|\n|`campaign_pv_pct`<br>|Any|Any|\n|`campaign_pv_window_minutes`<br>|Any|Any|\n|`campaign_restrict_targeting_to_deterministic_id`<br>|Any|Any|\n|`campaign_restrict_targeting_to_same_device_id`<br>|Any|Any|\n|`campaign_service_type`<br>Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag|Any|Any|\n|`campaign_source_campaign_id`<br>|Any|Any|\n|`campaign_spend_cap_amount`<br>|Any|Any|\n|`campaign_spend_cap_automatic`<br>|Any|Any|\n|`campaign_spend_cap_daily_cap`<br>|Any|Any|\n|`campaign_spend_cap_type`<br>|Any|Any|\n|`campaign_start_date`<br>(GMT) Campaign Start Date|Any|Any|\n|`campaign_start_date_tz`<br>(CTZ) Campaign Start Date|Any|Any|\n|`campaign_status`<br>Active Status|Any|Any|\n|`campaign_suspicious_traffic_filter_level`<br>|Any|Any|\n|`campaign_total_budget`<br>|Any|Any|\n|`campaign_total_impression_budget`<br>Campaign Impressions Budget|Any|Any|\n|`campaign_updated_on`<br>Campaign Update Time|Any|Any|\n|`campaign_version`<br>|Any|Any|\n|`campaign_zone_name`<br>Campaign Time Zone, a.k.a time_zone|Any|Any|\n|`contextual_parent`<br>|Any|Any|\n|`contextual_path`<br>|Any|Any|\n|`contextual_target_id`<br>|Any|Any|\n|`contextual_target_name`<br>|Any|Any|\n|`contextual_vendor_name`<br>|Any|Any|\n|`exchange_id`<br>|Any|Any|\n|`exchange_name`<br>|Any|Any|\n|`node_id`<br>|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|`strategy_ads_txt_verified`<br>|Any|Any|\n|`strategy_archived`<br>|Any|Any|\n|`strategy_audience_segment_exclude_op`<br>|Any|Any|\n|`strategy_audience_segment_include_op`<br>|Any|Any|\n|`strategy_bid_aggressiveness`<br>|Any|Any|\n|`strategy_bid_min_devices`<br>|Any|Any|\n|`strategy_bid_price_is_media_only`<br>|Any|Any|\n|`strategy_budget`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_value`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_value`<br>|Any|Any|\n|`strategy_created_on`<br>|Any|Any|\n|`strategy_currency_code`<br>|Any|Any|\n|`strategy_description`<br>|Any|Any|\n|`strategy_device_graph_only`<br>|Any|Any|\n|`strategy_end_date_raw`<br>|Any|Any|\n|`strategy_exchange_type_for_run_on_all`<br>|Any|Any|\n|`strategy_feature_compatibility`<br>|Any|Any|\n|`strategy_frequency_amount`<br>|Any|Any|\n|`strategy_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`strategy_frequency_optimization`<br>|Any|Any|\n|`strategy_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`strategy_goal_type`<br>|Any|Any|\n|`strategy_goal_value`<br>|Any|Any|\n|`strategy_groups`<br>|Any|Any|\n|`strategy_id`<br>|Any|Any|\n|`strategy_impression_pacing_amount`<br>|Any|Any|\n|`strategy_impression_pacing_interval`<br>|Any|Any|\n|`strategy_impression_pacing_type`<br>|Any|Any|\n|`strategy_max_bid`<br>|Any|Any|\n|`strategy_max_bid_wm`<br>|Any|Any|\n|`strategy_media_type`<br>|Any|Any|\n|`strategy_min_bid`<br>|Any|Any|\n|`strategy_name`<br>|Any|Any|\n|`strategy_pacing_amount`<br>|Any|Any|\n|`strategy_pacing_interval`<br>|Any|Any|\n|`strategy_pacing_optimization_amount`<br>|Any|Any|\n|`strategy_pacing_optimization_type`<br>|Any|Any|\n|`strategy_pacing_type`<br>|Any|Any|\n|`strategy_roi_target`<br>|Any|Any|\n|`strategy_run_on_all_exchanges`<br>|Any|Any|\n|`strategy_run_on_all_pmp`<br>|Any|Any|\n|`strategy_run_on_display`<br>|Any|Any|\n|`strategy_run_on_mobile`<br>|Any|Any|\n|`strategy_run_on_only_fraud_filtered_exchanges`<br>|Any|Any|\n|`strategy_run_on_streaming`<br>|Any|Any|\n|`strategy_site_restriction_transparent_urls`<br>|Any|Any|\n|`strategy_site_selectiveness`<br>|Any|Any|\n|`strategy_source_only`<br>|Any|Any|\n|`strategy_start_date_raw`<br>|Any|Any|\n|`strategy_status`<br>Active Status|Any|Any|\n|`strategy_supply_type`<br>|Any|Any|\n|`strategy_targeting_segment_exclude_op`<br>|Any|Any|\n|`strategy_targeting_segment_include_op`<br>|Any|Any|\n|`strategy_type`<br>|Any|Any|\n|`strategy_updated_on`<br>|Any|Any|\n|`strategy_use_bid_shading`<br>|Any|Any|\n|`strategy_use_campaign_end`<br>|Any|Any|\n|`strategy_use_campaign_start`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing_after_date`<br>|Any|Any|\n|`strategy_use_mm_freq`<br>|Any|Any|\n|`strategy_use_optimization`<br>|Any|Any|\n|`strategy_version`<br>|Any|Any|\n|`strategy_zone_name`<br>|Any|Any|\n|`vendor_id`<br>|Any|Any|\n|**Metrics**|\n|`clicks`<br>|Any|Any|\n|`ctc`<br>CTC|Any|Any|\n|`ctr`<br>CTR|Any|Any|\n|`impressions`<br>|Any|Any|\n|`media_cost_roi`<br>Media Cost ROI|Any|Any|\n|`post_click_aov`<br>Post-Click AOV|Any|Any|\n|`post_click_conversions`<br>Post-Click Conversions|Any|Any|\n|`post_click_revenue`<br>Post-Click Revenue|Any|Any|\n|`post_click_total_spend_roi`<br>Post-Click Total Spend ROI|Any|Any|\n|`post_view_aov`<br>Post-View AOV|Any|Any|\n|`post_view_conversions`<br>Post-View Conversions|Any|Any|\n|`post_view_conversions_raw`<br>Post-View Conversions (Raw)|Any|Any|\n|`post_view_revenue`<br>Post-View Revenue|Any|Any|\n|`post_view_revenue_raw`<br>Post-View Revenue (Raw)|Any|Any|\n|`post_view_total_spend_roi`<br>Post-View Total Spend ROI|Any|Any|\n|`revenue_raw`<br>Revenue (Raw)|Any|Any|\n|`rr_per_1k_imps`<br>Response Rate/1K Imps|Any|Any|\n|`total_aov`<br>Total AOV|Any|Any|\n|`total_conversions`<br>|Any|Any|\n|`total_revenue`<br>|Any|Any|\n|`total_spend`<br>|Any|Any|\n|`total_spend_cpa`<br>Total Spend eCPA|Any|Any|\n|`total_spend_cpc`<br>Total Spend eCPC|Any|Any|\n|`total_spend_cpm`<br>Total Spend eCPM|Any|Any|\n|`total_spend_pc_cpa`<br>Total Spend PC CPA|Any|Any|\n|`total_spend_pv_cpa`<br>Total Spend PV CPA|Any|Any|\n|`total_spend_roi`<br>Total Spend ROI|Any|Any|\n\n### Pageable\nNo\n\n### Time Windows\n`current_day`, `last_X_days`, `month_to_date`, `yesterday`\n\n### Rollups\n`all`, `by_day`, `by_month`, `by_week`\n\n\n### Data Retention / Lookback Window\n30 days\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - title: Time Window
                  required:
                    - time_window
                - title: Date Range
                  required:
                    - start_time
              required:
                - fields
                - filters
                - order
                - rollup
              properties:
                end_time:
                  type: string
                  format: date-time
                  nullable: true
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                rollup:
                  type: string
                start_time:
                  type: string
                  format: date-time
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /day-part:
    post:
      tags:
        - Datasets
      summary: Day Part Report
      description: "\nStandard performance metrics broken out by time of day and day of week. Available in standard intervals.\n\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`agg_timestamp`|`current_day`, `last_X_days`, `month_to_date`, `yesterday`|`by_day`, `by_month`, `by_week`|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`attribution_group`<br>|Any|Any|\n|`campaign_ads_txt_verified`<br>|Any|Any|\n|`campaign_agency_fee_pct`<br>|Any|Any|\n|`campaign_archived`<br>|Any|Any|\n|`campaign_bid_min_devices`<br>|Any|Any|\n|`campaign_brain_intraday_pacing`<br>|Any|Any|\n|`campaign_connected_id_type`<br>|Any|Any|\n|`campaign_conversion_type`<br>|Any|Any|\n|`campaign_conversion_variable_minutes`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_value`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_value`<br>|Any|Any|\n|`campaign_created_on`<br>Campaign Creation Time|Any|Any|\n|`campaign_currency_code`<br>Campaign Currency Code|Any|Any|\n|`campaign_custom_attribution_source`<br>|Any|Any|\n|`campaign_dcs_data_is_campaign_level`<br>|Any|Any|\n|`campaign_device_graph_only`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_applied`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_available`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_type`<br>|Any|Any|\n|`campaign_end_date`<br>(GMT) Campaign End Date|Any|Any|\n|`campaign_end_date_tz`<br>(CTZ) Campaign End Date|Any|Any|\n|`campaign_frequency_amount`<br>Campaign Frequency Amount|Any|Any|\n|`campaign_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`campaign_frequency_optimization`<br>Campaign Frequency Optimization|Any|Any|\n|`campaign_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`campaign_goal_alert`<br>|Any|Any|\n|`campaign_goal_category`<br>|Any|Any|\n|`campaign_goal_type`<br>|Any|Any|\n|`campaign_goal_value`<br>|Any|Any|\n|`campaign_has_custom_attribution`<br>|Any|Any|\n|`campaign_id`<br>|Any|Any|\n|`campaign_impression_cap_amount`<br>|Any|Any|\n|`campaign_impression_cap_automatic`<br>|Any|Any|\n|`campaign_impression_cap_type`<br>|Any|Any|\n|`campaign_in_flight`<br>In Flight|Any|Any|\n|`campaign_initial_start_date`<br>(GMT) Campaign Initial Start Date|Any|Any|\n|`campaign_initial_start_date_tz`<br>(CTZ) Campaign Initial Start Date|Any|Any|\n|`campaign_io_name`<br>|Any|Any|\n|`campaign_io_reference_num`<br>|Any|Any|\n|`campaign_is_programmatic_guaranteed`<br>Campaign Is Programmatic Guaranteed|Any|Any|\n|`campaign_merit_pixel_id`<br>|Any|Any|\n|`campaign_minimize_multi_ads`<br>Minimize Multi Ads|Any|Any|\n|`campaign_name`<br>|Any|Any|\n|`campaign_override_suspicious_traffic_filter`<br>|Any|Any|\n|`campaign_pacing_alert`<br>|Any|Any|\n|`campaign_pc_window_minutes`<br>|Any|Any|\n|`campaign_political`<br>|Any|Any|\n|`campaign_pv_pct`<br>|Any|Any|\n|`campaign_pv_window_minutes`<br>|Any|Any|\n|`campaign_restrict_targeting_to_deterministic_id`<br>|Any|Any|\n|`campaign_restrict_targeting_to_same_device_id`<br>|Any|Any|\n|`campaign_service_type`<br>Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag|Any|Any|\n|`campaign_source_campaign_id`<br>|Any|Any|\n|`campaign_spend_cap_amount`<br>|Any|Any|\n|`campaign_spend_cap_automatic`<br>|Any|Any|\n|`campaign_spend_cap_daily_cap`<br>|Any|Any|\n|`campaign_spend_cap_type`<br>|Any|Any|\n|`campaign_start_date`<br>(GMT) Campaign Start Date|Any|Any|\n|`campaign_start_date_tz`<br>(CTZ) Campaign Start Date|Any|Any|\n|`campaign_status`<br>Active Status|Any|Any|\n|`campaign_suspicious_traffic_filter_level`<br>|Any|Any|\n|`campaign_total_budget`<br>|Any|Any|\n|`campaign_total_impression_budget`<br>Campaign Impressions Budget|Any|Any|\n|`campaign_updated_on`<br>Campaign Update Time|Any|Any|\n|`campaign_version`<br>|Any|Any|\n|`campaign_zone_name`<br>Campaign Time Zone, a.k.a time_zone|Any|Any|\n|`day_part_id`<br>Day Part ID|Any|Any|\n|`day_part_name`<br>Day Part in the User's Timezone|Any|Any|\n|`exchange_id`<br>|Any|Any|\n|`exchange_name`<br>|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|`strategy_ads_txt_verified`<br>|Any|Any|\n|`strategy_archived`<br>|Any|Any|\n|`strategy_audience_segment_exclude_op`<br>|Any|Any|\n|`strategy_audience_segment_include_op`<br>|Any|Any|\n|`strategy_bid_aggressiveness`<br>|Any|Any|\n|`strategy_bid_min_devices`<br>|Any|Any|\n|`strategy_bid_price_is_media_only`<br>|Any|Any|\n|`strategy_budget`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_value`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_value`<br>|Any|Any|\n|`strategy_created_on`<br>|Any|Any|\n|`strategy_currency_code`<br>|Any|Any|\n|`strategy_description`<br>|Any|Any|\n|`strategy_device_graph_only`<br>|Any|Any|\n|`strategy_end_date_raw`<br>|Any|Any|\n|`strategy_exchange_type_for_run_on_all`<br>|Any|Any|\n|`strategy_feature_compatibility`<br>|Any|Any|\n|`strategy_frequency_amount`<br>|Any|Any|\n|`strategy_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`strategy_frequency_optimization`<br>|Any|Any|\n|`strategy_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`strategy_goal_type`<br>|Any|Any|\n|`strategy_goal_value`<br>|Any|Any|\n|`strategy_groups`<br>|Any|Any|\n|`strategy_id`<br>|Any|Any|\n|`strategy_impression_pacing_amount`<br>|Any|Any|\n|`strategy_impression_pacing_interval`<br>|Any|Any|\n|`strategy_impression_pacing_type`<br>|Any|Any|\n|`strategy_max_bid`<br>|Any|Any|\n|`strategy_max_bid_wm`<br>|Any|Any|\n|`strategy_media_type`<br>|Any|Any|\n|`strategy_min_bid`<br>|Any|Any|\n|`strategy_name`<br>|Any|Any|\n|`strategy_pacing_amount`<br>|Any|Any|\n|`strategy_pacing_interval`<br>|Any|Any|\n|`strategy_pacing_optimization_amount`<br>|Any|Any|\n|`strategy_pacing_optimization_type`<br>|Any|Any|\n|`strategy_pacing_type`<br>|Any|Any|\n|`strategy_roi_target`<br>|Any|Any|\n|`strategy_run_on_all_exchanges`<br>|Any|Any|\n|`strategy_run_on_all_pmp`<br>|Any|Any|\n|`strategy_run_on_display`<br>|Any|Any|\n|`strategy_run_on_mobile`<br>|Any|Any|\n|`strategy_run_on_only_fraud_filtered_exchanges`<br>|Any|Any|\n|`strategy_run_on_streaming`<br>|Any|Any|\n|`strategy_site_restriction_transparent_urls`<br>|Any|Any|\n|`strategy_site_selectiveness`<br>|Any|Any|\n|`strategy_source_only`<br>|Any|Any|\n|`strategy_start_date_raw`<br>|Any|Any|\n|`strategy_status`<br>Active Status|Any|Any|\n|`strategy_supply_type`<br>|Any|Any|\n|`strategy_targeting_segment_exclude_op`<br>|Any|Any|\n|`strategy_targeting_segment_include_op`<br>|Any|Any|\n|`strategy_type`<br>|Any|Any|\n|`strategy_updated_on`<br>|Any|Any|\n|`strategy_use_bid_shading`<br>|Any|Any|\n|`strategy_use_campaign_end`<br>|Any|Any|\n|`strategy_use_campaign_start`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing_after_date`<br>|Any|Any|\n|`strategy_use_mm_freq`<br>|Any|Any|\n|`strategy_use_optimization`<br>|Any|Any|\n|`strategy_version`<br>|Any|Any|\n|`strategy_zone_name`<br>|Any|Any|\n|`week_day_id`<br>Weekday ID|Any|Any|\n|`week_day_name`<br>|Any|Any|\n|**Metrics**|\n|`clicks`<br>|Any|Any|\n|`ctc`<br>CTC|Any|Any|\n|`ctr`<br>CTR|Any|Any|\n|`impressions`<br>|Any|Any|\n|`post_click_conversions`<br>Post-Click Conversions|Any|Any|\n|`post_view_conversions`<br>Post-View Conversions|Any|Any|\n|`rr_per_1k_imps`<br>Response Rate/1K Imps|Any|Any|\n|`total_conversions`<br>|Any|Any|\n|`total_spend`<br>|Any|Any|\n|`total_spend_cpa`<br>Total Spend eCPA|Any|Any|\n|`total_spend_cpc`<br>Total Spend eCPC|Any|Any|\n|`total_spend_cpcv`<br>Total Spend eCPCV|Any|Any|\n|`total_spend_cpm`<br>Total Spend eCPM|Any|Any|\n|`total_spend_pc_cpa`<br>Total Spend PC CPA|Any|Any|\n|`total_spend_pv_cpa`<br>Total Spend PV CPA|Any|Any|\n|`video_close`<br>Close|Any|Any|\n|`video_collapse`<br>Collapse|Any|Any|\n|`video_companion_clicks`<br>Companion Clicks|Any|Any|\n|`video_companion_ctr`<br>Companion CTR|Any|Any|\n|`video_companion_impressions`<br>Companion Impressions|Any|Any|\n|`video_complete`<br>100% Completed Views|Any|Any|\n|`video_complete_rate`<br>100% Completed Rate|Any|Any|\n|`video_engaged_impressions`<br>Engaged Impressions|Any|Any|\n|`video_engaged_rate`<br>Engaged Rate|Any|Any|\n|`video_expand`<br>Expand|Any|Any|\n|`video_first_quartile`<br>25% Completed Views|Any|Any|\n|`video_first_quartile_rate`<br>25% Completed Rate|Any|Any|\n|`video_fullscreen`<br>Fullscreen|Any|Any|\n|`video_midpoint`<br>50% Completed Views|Any|Any|\n|`video_midpoint_rate`<br>50% Completed Rate|Any|Any|\n|`video_mute`<br>Mute|Any|Any|\n|`video_pause`<br>Pause|Any|Any|\n|`video_play_rate`<br>Play Rate|Any|Any|\n|`video_resume`<br>Resume|Any|Any|\n|`video_rewind`<br>Rewind|Any|Any|\n|`video_skip`<br>Skip|Any|Any|\n|`video_skippable_impressions`<br>Skippable Impressions|Any|Any|\n|`video_skipped_impressions`<br>Skipped Impressions|Any|Any|\n|`video_skipped_rate`<br>Skipped Rate|Any|Any|\n|`video_start`<br>Start|Any|Any|\n|`video_third_quartile`<br>75% Completed Views|Any|Any|\n|`video_third_quartile_rate`<br>75% Completed Rate|Any|Any|\n|`video_unmute`<br>Unmute|Any|Any|\n\n### Pageable\nNo\n\n### Time Windows\n`campaign_to_date`, `current_day`, `last_X_days`, `month_to_date`, `yesterday`\n\n### Rollups\n`all`, `by_day`, `by_month`, `by_week`\n\n\n### Data Retention / Lookback Window\n1 year and CTD\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - title: Time Window
                  required:
                    - time_window
                - title: Date Range
                  required:
                    - start_time
              required:
                - fields
                - filters
                - order
                - rollup
              properties:
                end_time:
                  type: string
                  format: date-time
                  nullable: true
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                rollup:
                  type: string
                start_time:
                  type: string
                  format: date-time
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /deals:
    post:
      tags:
        - Datasets
      summary: Deals
      description: "\nMetrics that describe the path from a matched bid opportunity (biddable) to a delivered impression (win) for private marketplace deals. The data is stored in UTC timezone and is available by hour. In addition, the report updates on a 1 hour lag time at the top of the hour. For example, data from 1:00 – 1:59 AM will become available at roughly 3:00 AM.\n\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`agg_timestamp`|`current_day`, `last_X_days`, `last_X_hours`, `month_to_date`, `yesterday`|`by_day`, `by_hour`, `by_month`, `by_week`|\n|`deal_exchange_id`<br>|Any|Any|\n|`deal_external_id`<br>|Any|Any|\n|`deal_group_id`<br>|Any|Any|\n|`deal_group_name`<br>|Any|Any|\n|`deal_id`<br>|Any|Any|\n|`deal_name`<br>|Any|Any|\n|`deal_organization_id`<br>|Any|Any|\n|`deal_price_type`<br>|Any|Any|\n|`deal_publisher_id`<br>Deal Publisher ID|Any|Any|\n|**Metrics**|\n|`bid_rate`<br>|Any|Any|\n|`biddables`<br>|Any|Any|\n|`bids`<br>|Any|Any|\n|`matches`<br>|Any|Any|\n|`win_rate`<br>|Any|Any|\n|`wins`<br>|Any|Any|\n\n### Pageable\nNo\n\n### Time Windows\n`current_day`, `last_X_days`, `last_X_hours`, `month_to_date`, `yesterday`\n\n### Rollups\n`all`, `by_day`, `by_hour`, `by_month`, `by_week`\n\n\n### Data Retention / Lookback Window\n1 year\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - title: Time Window
                  required:
                    - time_window
                - title: Date Range
                  required:
                    - start_time
              required:
                - fields
                - filters
                - order
                - rollup
              properties:
                end_time:
                  type: string
                  format: date-time
                  nullable: true
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                rollup:
                  type: string
                start_time:
                  type: string
                  format: date-time
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /hyperlocal:
    post:
      tags:
        - Datasets
      summary: Hyperlocal Report
      description: "\nStandard performance metrics broken out by Hyperlocal Targeting objects created via third party.\n\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`agg_timestamp`|`current_day`, `last_X_days`, `month_to_date`, `yesterday`|`by_day`, `by_month`, `by_week`|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`attribution_group`<br>|Any|Any|\n|`campaign_ads_txt_verified`<br>|Any|Any|\n|`campaign_agency_fee_pct`<br>|Any|Any|\n|`campaign_archived`<br>|Any|Any|\n|`campaign_bid_min_devices`<br>|Any|Any|\n|`campaign_brain_intraday_pacing`<br>|Any|Any|\n|`campaign_connected_id_type`<br>|Any|Any|\n|`campaign_conversion_type`<br>|Any|Any|\n|`campaign_conversion_variable_minutes`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_value`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_value`<br>|Any|Any|\n|`campaign_created_on`<br>Campaign Creation Time|Any|Any|\n|`campaign_currency_code`<br>Campaign Currency Code|Any|Any|\n|`campaign_custom_attribution_source`<br>|Any|Any|\n|`campaign_dcs_data_is_campaign_level`<br>|Any|Any|\n|`campaign_device_graph_only`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_applied`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_available`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_type`<br>|Any|Any|\n|`campaign_end_date`<br>(GMT) Campaign End Date|Any|Any|\n|`campaign_end_date_tz`<br>(CTZ) Campaign End Date|Any|Any|\n|`campaign_frequency_amount`<br>Campaign Frequency Amount|Any|Any|\n|`campaign_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`campaign_frequency_optimization`<br>Campaign Frequency Optimization|Any|Any|\n|`campaign_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`campaign_goal_alert`<br>|Any|Any|\n|`campaign_goal_category`<br>|Any|Any|\n|`campaign_goal_type`<br>|Any|Any|\n|`campaign_goal_value`<br>|Any|Any|\n|`campaign_has_custom_attribution`<br>|Any|Any|\n|`campaign_id`<br>|Any|Any|\n|`campaign_impression_cap_amount`<br>|Any|Any|\n|`campaign_impression_cap_automatic`<br>|Any|Any|\n|`campaign_impression_cap_type`<br>|Any|Any|\n|`campaign_in_flight`<br>In Flight|Any|Any|\n|`campaign_initial_start_date`<br>(GMT) Campaign Initial Start Date|Any|Any|\n|`campaign_initial_start_date_tz`<br>(CTZ) Campaign Initial Start Date|Any|Any|\n|`campaign_io_name`<br>|Any|Any|\n|`campaign_io_reference_num`<br>|Any|Any|\n|`campaign_is_programmatic_guaranteed`<br>Campaign Is Programmatic Guaranteed|Any|Any|\n|`campaign_merit_pixel_id`<br>|Any|Any|\n|`campaign_minimize_multi_ads`<br>Minimize Multi Ads|Any|Any|\n|`campaign_name`<br>|Any|Any|\n|`campaign_override_suspicious_traffic_filter`<br>|Any|Any|\n|`campaign_pacing_alert`<br>|Any|Any|\n|`campaign_pc_window_minutes`<br>|Any|Any|\n|`campaign_political`<br>|Any|Any|\n|`campaign_pv_pct`<br>|Any|Any|\n|`campaign_pv_window_minutes`<br>|Any|Any|\n|`campaign_restrict_targeting_to_deterministic_id`<br>|Any|Any|\n|`campaign_restrict_targeting_to_same_device_id`<br>|Any|Any|\n|`campaign_service_type`<br>Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag|Any|Any|\n|`campaign_source_campaign_id`<br>|Any|Any|\n|`campaign_spend_cap_amount`<br>|Any|Any|\n|`campaign_spend_cap_automatic`<br>|Any|Any|\n|`campaign_spend_cap_daily_cap`<br>|Any|Any|\n|`campaign_spend_cap_type`<br>|Any|Any|\n|`campaign_start_date`<br>(GMT) Campaign Start Date|Any|Any|\n|`campaign_start_date_tz`<br>(CTZ) Campaign Start Date|Any|Any|\n|`campaign_status`<br>Active Status|Any|Any|\n|`campaign_suspicious_traffic_filter_level`<br>|Any|Any|\n|`campaign_total_budget`<br>|Any|Any|\n|`campaign_total_impression_budget`<br>Campaign Impressions Budget|Any|Any|\n|`campaign_updated_on`<br>Campaign Update Time|Any|Any|\n|`campaign_version`<br>|Any|Any|\n|`campaign_zone_name`<br>Campaign Time Zone, a.k.a time_zone|Any|Any|\n|`exchange_id`<br>|Any|Any|\n|`exchange_name`<br>|Any|Any|\n|`node_level`<br>|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|`path`<br>|Any|Any|\n|`postal_code`<br>|Any|Any|\n|`strategy_ads_txt_verified`<br>|Any|Any|\n|`strategy_archived`<br>|Any|Any|\n|`strategy_audience_segment_exclude_op`<br>|Any|Any|\n|`strategy_audience_segment_include_op`<br>|Any|Any|\n|`strategy_bid_aggressiveness`<br>|Any|Any|\n|`strategy_bid_min_devices`<br>|Any|Any|\n|`strategy_bid_price_is_media_only`<br>|Any|Any|\n|`strategy_budget`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_value`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_value`<br>|Any|Any|\n|`strategy_created_on`<br>|Any|Any|\n|`strategy_currency_code`<br>|Any|Any|\n|`strategy_description`<br>|Any|Any|\n|`strategy_device_graph_only`<br>|Any|Any|\n|`strategy_end_date_raw`<br>|Any|Any|\n|`strategy_exchange_type_for_run_on_all`<br>|Any|Any|\n|`strategy_feature_compatibility`<br>|Any|Any|\n|`strategy_frequency_amount`<br>|Any|Any|\n|`strategy_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`strategy_frequency_optimization`<br>|Any|Any|\n|`strategy_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`strategy_goal_type`<br>|Any|Any|\n|`strategy_goal_value`<br>|Any|Any|\n|`strategy_groups`<br>|Any|Any|\n|`strategy_id`<br>|Any|Any|\n|`strategy_impression_pacing_amount`<br>|Any|Any|\n|`strategy_impression_pacing_interval`<br>|Any|Any|\n|`strategy_impression_pacing_type`<br>|Any|Any|\n|`strategy_max_bid`<br>|Any|Any|\n|`strategy_max_bid_wm`<br>|Any|Any|\n|`strategy_media_type`<br>|Any|Any|\n|`strategy_min_bid`<br>|Any|Any|\n|`strategy_name`<br>|Any|Any|\n|`strategy_pacing_amount`<br>|Any|Any|\n|`strategy_pacing_interval`<br>|Any|Any|\n|`strategy_pacing_optimization_amount`<br>|Any|Any|\n|`strategy_pacing_optimization_type`<br>|Any|Any|\n|`strategy_pacing_type`<br>|Any|Any|\n|`strategy_roi_target`<br>|Any|Any|\n|`strategy_run_on_all_exchanges`<br>|Any|Any|\n|`strategy_run_on_all_pmp`<br>|Any|Any|\n|`strategy_run_on_display`<br>|Any|Any|\n|`strategy_run_on_mobile`<br>|Any|Any|\n|`strategy_run_on_only_fraud_filtered_exchanges`<br>|Any|Any|\n|`strategy_run_on_streaming`<br>|Any|Any|\n|`strategy_site_restriction_transparent_urls`<br>|Any|Any|\n|`strategy_site_selectiveness`<br>|Any|Any|\n|`strategy_source_only`<br>|Any|Any|\n|`strategy_start_date_raw`<br>|Any|Any|\n|`strategy_status`<br>Active Status|Any|Any|\n|`strategy_supply_type`<br>|Any|Any|\n|`strategy_targeting_segment_exclude_op`<br>|Any|Any|\n|`strategy_targeting_segment_include_op`<br>|Any|Any|\n|`strategy_type`<br>|Any|Any|\n|`strategy_updated_on`<br>|Any|Any|\n|`strategy_use_bid_shading`<br>|Any|Any|\n|`strategy_use_campaign_end`<br>|Any|Any|\n|`strategy_use_campaign_start`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing_after_date`<br>|Any|Any|\n|`strategy_use_mm_freq`<br>|Any|Any|\n|`strategy_use_optimization`<br>|Any|Any|\n|`strategy_version`<br>|Any|Any|\n|`strategy_zone_name`<br>|Any|Any|\n|`target_id`<br>|Any|Any|\n|**Metrics**|\n|`clicks`<br>|Any|Any|\n|`ctc`<br>CTC|Any|Any|\n|`ctr`<br>CTR|Any|Any|\n|`impressions`<br>|Any|Any|\n|`media_cost_roi`<br>Media Cost ROI|Any|Any|\n|`post_click_aov`<br>Post-Click AOV|Any|Any|\n|`post_click_conversions`<br>Post-Click Conversions|Any|Any|\n|`post_click_revenue`<br>Post-Click Revenue|Any|Any|\n|`post_click_total_spend_roi`<br>Post-Click Total Spend ROI|Any|Any|\n|`post_view_aov`<br>Post-View AOV|Any|Any|\n|`post_view_conversions`<br>Post-View Conversions|Any|Any|\n|`post_view_conversions_raw`<br>Post-View Conversions (Raw)|Any|Any|\n|`post_view_revenue`<br>Post-View Revenue|Any|Any|\n|`post_view_revenue_raw`<br>Post-View Revenue (Raw)|Any|Any|\n|`post_view_total_spend_roi`<br>Post-View Total Spend ROI|Any|Any|\n|`revenue_raw`<br>Revenue (Raw)|Any|Any|\n|`rr_per_1k_imps`<br>Response Rate/1K Imps|Any|Any|\n|`total_aov`<br>Total AOV|Any|Any|\n|`total_conversions`<br>|Any|Any|\n|`total_revenue`<br>|Any|Any|\n|`total_spend`<br>|Any|Any|\n|`total_spend_cpa`<br>Total Spend eCPA|Any|Any|\n|`total_spend_cpc`<br>Total Spend eCPC|Any|Any|\n|`total_spend_cpm`<br>Total Spend eCPM|Any|Any|\n|`total_spend_pc_cpa`<br>Total Spend PC CPA|Any|Any|\n|`total_spend_pv_cpa`<br>Total Spend PV CPA|Any|Any|\n|`total_spend_roi`<br>Total Spend ROI|Any|Any|\n\n### Pageable\nNo\n\n### Time Windows\n`current_day`, `last_X_days`, `month_to_date`, `yesterday`\n\n### Rollups\n`all`, `by_day`, `by_month`, `by_week`\n\n\n### Data Retention / Lookback Window\n90 days\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - title: Time Window
                  required:
                    - time_window
                - title: Date Range
                  required:
                    - start_time
              required:
                - fields
                - filters
                - order
                - rollup
              properties:
                end_time:
                  type: string
                  format: date-time
                  nullable: true
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                rollup:
                  type: string
                start_time:
                  type: string
                  format: date-time
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /performance:
    post:
      tags:
        - Datasets
      summary: Performance
      description: "\nStandard Aggregated Performance Report in Campaign Currency\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`agg_timestamp`|`current_day`, `last_X_days`, `month_to_date`, `yesterday`|`by_day`, `by_month`, `by_week`|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`attribution_group`<br>|Any|Any|\n|`campaign_ads_txt_verified`<br>|Any|Any|\n|`campaign_agency_fee_pct`<br>|Any|Any|\n|`campaign_archived`<br>|Any|Any|\n|`campaign_bid_min_devices`<br>|Any|Any|\n|`campaign_brain_intraday_pacing`<br>|Any|Any|\n|`campaign_connected_id_type`<br>|Any|Any|\n|`campaign_conversion_type`<br>|Any|Any|\n|`campaign_conversion_variable_minutes`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_value`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_value`<br>|Any|Any|\n|`campaign_created_on`<br>Campaign Creation Time|Any|Any|\n|`campaign_currency_code`<br>Campaign Currency Code|Any|Any|\n|`campaign_custom_attribution_source`<br>|Any|Any|\n|`campaign_dcs_data_is_campaign_level`<br>|Any|Any|\n|`campaign_device_graph_only`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_applied`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_available`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_type`<br>|Any|Any|\n|`campaign_end_date`<br>(GMT) Campaign End Date|Any|Any|\n|`campaign_end_date_tz`<br>(CTZ) Campaign End Date|Any|Any|\n|`campaign_frequency_amount`<br>Campaign Frequency Amount|Any|Any|\n|`campaign_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`campaign_frequency_optimization`<br>Campaign Frequency Optimization|Any|Any|\n|`campaign_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`campaign_goal_alert`<br>|Any|Any|\n|`campaign_goal_category`<br>|Any|Any|\n|`campaign_goal_type`<br>|Any|Any|\n|`campaign_goal_value`<br>|Any|Any|\n|`campaign_has_custom_attribution`<br>|Any|Any|\n|`campaign_id`<br>|Any|Any|\n|`campaign_impression_cap_amount`<br>|Any|Any|\n|`campaign_impression_cap_automatic`<br>|Any|Any|\n|`campaign_impression_cap_type`<br>|Any|Any|\n|`campaign_in_flight`<br>In Flight|Any|Any|\n|`campaign_initial_start_date`<br>(GMT) Campaign Initial Start Date|Any|Any|\n|`campaign_initial_start_date_tz`<br>(CTZ) Campaign Initial Start Date|Any|Any|\n|`campaign_io_name`<br>|Any|Any|\n|`campaign_io_reference_num`<br>|Any|Any|\n|`campaign_is_programmatic_guaranteed`<br>Campaign Is Programmatic Guaranteed|Any|Any|\n|`campaign_merit_pixel_id`<br>|Any|Any|\n|`campaign_minimize_multi_ads`<br>Minimize Multi Ads|Any|Any|\n|`campaign_name`<br>|Any|Any|\n|`campaign_override_suspicious_traffic_filter`<br>|Any|Any|\n|`campaign_pacing_alert`<br>|Any|Any|\n|`campaign_pc_window_minutes`<br>|Any|Any|\n|`campaign_political`<br>|Any|Any|\n|`campaign_pv_pct`<br>|Any|Any|\n|`campaign_pv_window_minutes`<br>|Any|Any|\n|`campaign_restrict_targeting_to_deterministic_id`<br>|Any|Any|\n|`campaign_restrict_targeting_to_same_device_id`<br>|Any|Any|\n|`campaign_service_type`<br>Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag|Any|Any|\n|`campaign_source_campaign_id`<br>|Any|Any|\n|`campaign_spend_cap_amount`<br>|Any|Any|\n|`campaign_spend_cap_automatic`<br>|Any|Any|\n|`campaign_spend_cap_daily_cap`<br>|Any|Any|\n|`campaign_spend_cap_type`<br>|Any|Any|\n|`campaign_start_date`<br>(GMT) Campaign Start Date|Any|Any|\n|`campaign_start_date_tz`<br>(CTZ) Campaign Start Date|Any|Any|\n|`campaign_status`<br>Active Status|Any|Any|\n|`campaign_suspicious_traffic_filter_level`<br>|Any|Any|\n|`campaign_total_budget`<br>|Any|Any|\n|`campaign_total_impression_budget`<br>Campaign Impressions Budget|Any|Any|\n|`campaign_updated_on`<br>Campaign Update Time|Any|Any|\n|`campaign_version`<br>|Any|Any|\n|`campaign_zone_name`<br>Campaign Time Zone, a.k.a time_zone|Any|Any|\n|`concept_id`<br>|Any|Any|\n|`concept_name`<br>|Any|Any|\n|`creative_file_type`<br>|Any|Any|\n|`creative_has_sound`<br>|Any|Any|\n|`creative_id`<br>|Any|Any|\n|`creative_is_native`<br>|Any|Any|\n|`creative_name`<br>|Any|Any|\n|`creative_rich_media`<br>|Any|Any|\n|`creative_size`<br>|Any|Any|\n|`creative_tpas_placement_id`<br>|Any|Any|\n|`creative_tpas_placement_name`<br>|Any|Any|\n|`deal_exchange_id`<br>|Any|Any|\n|`deal_external_id`<br>|Any|Any|\n|`deal_group_id`<br>|Any|Any|\n|`deal_group_name`<br>|Any|Any|\n|`deal_id`<br>|Any|Any|\n|`deal_name`<br>|Any|Any|\n|`deal_organization_id`<br>|Any|Any|\n|`deal_price_type`<br>|Any|Any|\n|`deal_publisher_id`<br>Deal Publisher ID|Any|Any|\n|`exchange_id`<br>|Any|Any|\n|`exchange_name`<br>|Any|Any|\n|`flight_id`<br>|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|`prisma_campaign_id`<br>|Any|Any|\n|`prisma_client_product_estimate`<br>|Any|Any|\n|`prisma_io_number`<br>|Any|Any|\n|`strategy_ads_txt_verified`<br>|Any|Any|\n|`strategy_archived`<br>|Any|Any|\n|`strategy_audience_segment_exclude_op`<br>|Any|Any|\n|`strategy_audience_segment_include_op`<br>|Any|Any|\n|`strategy_bid_aggressiveness`<br>|Any|Any|\n|`strategy_bid_min_devices`<br>|Any|Any|\n|`strategy_bid_price_is_media_only`<br>|Any|Any|\n|`strategy_budget`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_value`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_value`<br>|Any|Any|\n|`strategy_created_on`<br>|Any|Any|\n|`strategy_currency_code`<br>|Any|Any|\n|`strategy_description`<br>|Any|Any|\n|`strategy_device_graph_only`<br>|Any|Any|\n|`strategy_end_date_raw`<br>|Any|Any|\n|`strategy_exchange_type_for_run_on_all`<br>|Any|Any|\n|`strategy_feature_compatibility`<br>|Any|Any|\n|`strategy_frequency_amount`<br>|Any|Any|\n|`strategy_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`strategy_frequency_optimization`<br>|Any|Any|\n|`strategy_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`strategy_goal_type`<br>|Any|Any|\n|`strategy_goal_value`<br>|Any|Any|\n|`strategy_groups`<br>|Any|Any|\n|`strategy_id`<br>|Any|Any|\n|`strategy_impression_pacing_amount`<br>|Any|Any|\n|`strategy_impression_pacing_interval`<br>|Any|Any|\n|`strategy_impression_pacing_type`<br>|Any|Any|\n|`strategy_max_bid`<br>|Any|Any|\n|`strategy_max_bid_wm`<br>|Any|Any|\n|`strategy_media_type`<br>|Any|Any|\n|`strategy_min_bid`<br>|Any|Any|\n|`strategy_name`<br>|Any|Any|\n|`strategy_pacing_amount`<br>|Any|Any|\n|`strategy_pacing_interval`<br>|Any|Any|\n|`strategy_pacing_optimization_amount`<br>|Any|Any|\n|`strategy_pacing_optimization_type`<br>|Any|Any|\n|`strategy_pacing_type`<br>|Any|Any|\n|`strategy_roi_target`<br>|Any|Any|\n|`strategy_run_on_all_exchanges`<br>|Any|Any|\n|`strategy_run_on_all_pmp`<br>|Any|Any|\n|`strategy_run_on_display`<br>|Any|Any|\n|`strategy_run_on_mobile`<br>|Any|Any|\n|`strategy_run_on_only_fraud_filtered_exchanges`<br>|Any|Any|\n|`strategy_run_on_streaming`<br>|Any|Any|\n|`strategy_site_restriction_transparent_urls`<br>|Any|Any|\n|`strategy_site_selectiveness`<br>|Any|Any|\n|`strategy_source_only`<br>|Any|Any|\n|`strategy_start_date_raw`<br>|Any|Any|\n|`strategy_status`<br>Active Status|Any|Any|\n|`strategy_supply_type`<br>|Any|Any|\n|`strategy_targeting_segment_exclude_op`<br>|Any|Any|\n|`strategy_targeting_segment_include_op`<br>|Any|Any|\n|`strategy_type`<br>|Any|Any|\n|`strategy_updated_on`<br>|Any|Any|\n|`strategy_use_bid_shading`<br>|Any|Any|\n|`strategy_use_campaign_end`<br>|Any|Any|\n|`strategy_use_campaign_start`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing_after_date`<br>|Any|Any|\n|`strategy_use_mm_freq`<br>|Any|Any|\n|`strategy_use_optimization`<br>|Any|Any|\n|`strategy_version`<br>|Any|Any|\n|`strategy_zone_name`<br>|Any|Any|\n|**Metrics**|\n|`clicks`<br>|Any|Any|\n|`ctc`<br>CTC|Any|Any|\n|`ctr`<br>CTR|Any|Any|\n|`impressions`<br>|Any|Any|\n|`in_view`<br>In View Impressions|Any|Any|\n|`in_view_100_percent`<br>100% In View Impressions|Any|Any|\n|`in_view_15_seconds`<br>|Any|Any|\n|`in_view_15_seconds_rate`<br>|Any|Any|\n|`in_view_5_seconds`<br>|Any|Any|\n|`in_view_5_seconds_rate`<br>|Any|Any|\n|`measurability_rate`<br>Measurability Rate|Any|Any|\n|`measurable`<br>Measurable Impressions|Any|Any|\n|`post_click_aov`<br>Post-Click AOV|Any|Any|\n|`post_click_conversions`<br>Post-Click Conversions|Any|Any|\n|`post_click_revenue`<br>Post-Click Revenue|Any|Any|\n|`post_click_revenue_usd`<br>|Any|Any|\n|`post_click_total_spend_roi`<br>Post-Click Total Spend ROI|Any|Any|\n|`post_view_aov`<br>Post-View AOV|Any|Any|\n|`post_view_conversions`<br>Post-View Conversions|Any|Any|\n|`post_view_conversions_raw`<br>Post-View Conversions (Raw)|Any|Any|\n|`post_view_revenue`<br>Post-View Revenue|Any|Any|\n|`post_view_revenue_raw`<br>Post-View Revenue (Raw)|Any|Any|\n|`post_view_revenue_raw_usd`<br>|Any|Any|\n|`post_view_total_spend_roi`<br>Post-View Total Spend ROI|Any|Any|\n|`revenue`<br>Revenue (Raw)|Any|Any|\n|`rr_per_1k_imps`<br>Response Rate/1K Imps|Any|Any|\n|`total_aov`<br>Total AOV|Any|Any|\n|`total_conversions`<br>|Any|Any|\n|`total_revenue`<br>|Any|Any|\n|`total_spend`<br>|Any|Any|\n|`total_spend_cpa`<br>Total Spend eCPA|Any|Any|\n|`total_spend_cpc`<br>Total Spend eCPC|Any|Any|\n|`total_spend_cpcv`<br>Total Spend eCPCV|Any|Any|\n|`total_spend_cpm`<br>Total Spend eCPM|Any|Any|\n|`total_spend_pc_cpa`<br>Total Spend PC CPA|Any|Any|\n|`total_spend_pv_cpa`<br>Total Spend PV CPA|Any|Any|\n|`total_spend_roi`<br>Total Spend ROI|Any|Any|\n|`total_spend_usd`<br>|Any|Any|\n|`total_spend_vcpm`<br>Total Spend vCPM |Any|Any|\n|`tpa_conversions`<br>3PA Total Conversions|Any|Any|\n|`tpa_total_aov`<br>3PA Total AOV|Any|Any|\n|`tpa_total_aov_usd`<br>(USD) 3PA Total AOV|Any|Any|\n|`tpa_total_revenue`<br>3PA Total Revenue|Any|Any|\n|`tpa_total_revenue_usd`<br>(USD) 3PA Total Revenue|Any|Any|\n|`tpa_total_spend_cpa`<br>3PA Total Spend CPA|Any|Any|\n|`tpa_total_spend_cpa_usd`<br>(USD) 3PA Total Spend CPA|Any|Any|\n|`tpa_total_spend_roi`<br>3PA Total Spend ROI|Any|Any|\n|`uniques`<br>|`current_day`, `last_X_days`, `month_to_date`, `yesterday`|`all`, `by_day`, `by_month`, `by_week`|\n|`video_close`<br>Close|Any|Any|\n|`video_collapse`<br>Collapse|Any|Any|\n|`video_companion_clicks`<br>Companion Clicks|Any|Any|\n|`video_companion_ctr`<br>Companion CTR|Any|Any|\n|`video_companion_impressions`<br>Companion Impressions|Any|Any|\n|`video_complete`<br>100% Completed Views|Any|Any|\n|`video_complete_rate`<br>100% Completed Rate|Any|Any|\n|`video_complete_rate_impression_based`<br>VCR (Impression Based)|Any|Any|\n|`video_engaged_impressions`<br>Engaged Impressions|Any|Any|\n|`video_engaged_rate`<br>Engaged Rate|Any|Any|\n|`video_expand`<br>Expand|Any|Any|\n|`video_first_quartile`<br>25% Completed Views|Any|Any|\n|`video_first_quartile_rate`<br>25% Completed Rate|Any|Any|\n|`video_first_quartile_rate_impression_based`<br>25% Completed Rate - Impressions Based|Any|Any|\n|`video_fullscreen`<br>Fullscreen|Any|Any|\n|`video_midpoint`<br>50% Completed Views|Any|Any|\n|`video_midpoint_rate`<br>50% Completed Rate|Any|Any|\n|`video_midpoint_rate_impression_based`<br>50% Completed Rate - Impressions Based|Any|Any|\n|`video_mute`<br>|Any|Any|\n|`video_pause`<br>Pause|Any|Any|\n|`video_play_rate`<br>Play Rate|Any|Any|\n|`video_resume`<br>Resume|Any|Any|\n|`video_rewind`<br>Rewind|Any|Any|\n|`video_skip`<br>Skip|Any|Any|\n|`video_skippable_impressions`<br>Skippable Impressions|Any|Any|\n|`video_skipped_impressions`<br>Skipped Impressions|Any|Any|\n|`video_skipped_rate`<br>Skipped Rate|Any|Any|\n|`video_start`<br>Start|Any|Any|\n|`video_third_quartile`<br>75% Completed Views|Any|Any|\n|`video_third_quartile_rate`<br>75% Completed Rate|Any|Any|\n|`video_third_quartile_rate_impression_based`<br>75% Completed Rate - Impressions Based|Any|Any|\n|`video_unmute`<br>|Any|Any|\n|`viewability_rate`<br>Viewability Rate|Any|Any|\n|`viewability_rate_100_percent`<br>100% In View Rate|Any|Any|\n\n### Pageable\nNo\n\n### Time Windows\n`current_day`, `last_X_days`, `month_to_date`, `yesterday`\n\n### Rollups\n`all`, `by_day`, `by_month`, `by_week`\n\n\n### Data Retention / Lookback Window\nSince 2013\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - title: Time Window
                  required:
                    - time_window
                - title: Date Range
                  required:
                    - start_time
              required:
                - fields
                - filters
                - order
                - rollup
              properties:
                end_time:
                  type: string
                  format: date-time
                  nullable: true
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                rollup:
                  type: string
                start_time:
                  type: string
                  format: date-time
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /performance-hourly:
    post:
      tags:
        - Datasets
      summary: Performance Hourly
      description: "\nStandard Aggregated Performance Report in Campaign Currency\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`agg_timestamp`|`current_day`, `last_X_days`, `last_X_hours`, `month_to_date`, `yesterday`|`by_day`, `by_hour`, `by_month`, `by_week`|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`campaign_ads_txt_verified`<br>|Any|Any|\n|`campaign_agency_fee_pct`<br>|Any|Any|\n|`campaign_archived`<br>|Any|Any|\n|`campaign_bid_min_devices`<br>|Any|Any|\n|`campaign_brain_intraday_pacing`<br>|Any|Any|\n|`campaign_connected_id_type`<br>|Any|Any|\n|`campaign_conversion_type`<br>|Any|Any|\n|`campaign_conversion_variable_minutes`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_value`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_value`<br>|Any|Any|\n|`campaign_created_on`<br>Campaign Creation Time|Any|Any|\n|`campaign_currency_code`<br>Campaign Currency Code|Any|Any|\n|`campaign_custom_attribution_source`<br>|Any|Any|\n|`campaign_dcs_data_is_campaign_level`<br>|Any|Any|\n|`campaign_device_graph_only`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_applied`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_available`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_type`<br>|Any|Any|\n|`campaign_end_date`<br>(GMT) Campaign End Date|Any|Any|\n|`campaign_end_date_tz`<br>(CTZ) Campaign End Date|Any|Any|\n|`campaign_frequency_amount`<br>Campaign Frequency Amount|Any|Any|\n|`campaign_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`campaign_frequency_optimization`<br>Campaign Frequency Optimization|Any|Any|\n|`campaign_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`campaign_goal_alert`<br>|Any|Any|\n|`campaign_goal_category`<br>|Any|Any|\n|`campaign_goal_type`<br>|Any|Any|\n|`campaign_goal_value`<br>|Any|Any|\n|`campaign_has_custom_attribution`<br>|Any|Any|\n|`campaign_id`<br>|Any|Any|\n|`campaign_impression_cap_amount`<br>|Any|Any|\n|`campaign_impression_cap_automatic`<br>|Any|Any|\n|`campaign_impression_cap_type`<br>|Any|Any|\n|`campaign_in_flight`<br>In Flight|Any|Any|\n|`campaign_initial_start_date`<br>(GMT) Campaign Initial Start Date|Any|Any|\n|`campaign_initial_start_date_tz`<br>(CTZ) Campaign Initial Start Date|Any|Any|\n|`campaign_io_name`<br>|Any|Any|\n|`campaign_io_reference_num`<br>|Any|Any|\n|`campaign_is_programmatic_guaranteed`<br>Campaign Is Programmatic Guaranteed|Any|Any|\n|`campaign_merit_pixel_id`<br>|Any|Any|\n|`campaign_minimize_multi_ads`<br>Minimize Multi Ads|Any|Any|\n|`campaign_name`<br>|Any|Any|\n|`campaign_override_suspicious_traffic_filter`<br>|Any|Any|\n|`campaign_pacing_alert`<br>|Any|Any|\n|`campaign_pc_window_minutes`<br>|Any|Any|\n|`campaign_political`<br>|Any|Any|\n|`campaign_pv_pct`<br>|Any|Any|\n|`campaign_pv_window_minutes`<br>|Any|Any|\n|`campaign_restrict_targeting_to_deterministic_id`<br>|Any|Any|\n|`campaign_restrict_targeting_to_same_device_id`<br>|Any|Any|\n|`campaign_service_type`<br>Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag|Any|Any|\n|`campaign_source_campaign_id`<br>|Any|Any|\n|`campaign_spend_cap_amount`<br>|Any|Any|\n|`campaign_spend_cap_automatic`<br>|Any|Any|\n|`campaign_spend_cap_daily_cap`<br>|Any|Any|\n|`campaign_spend_cap_type`<br>|Any|Any|\n|`campaign_start_date`<br>(GMT) Campaign Start Date|Any|Any|\n|`campaign_start_date_tz`<br>(CTZ) Campaign Start Date|Any|Any|\n|`campaign_status`<br>Active Status|Any|Any|\n|`campaign_suspicious_traffic_filter_level`<br>|Any|Any|\n|`campaign_total_budget`<br>|Any|Any|\n|`campaign_total_impression_budget`<br>Campaign Impressions Budget|Any|Any|\n|`campaign_updated_on`<br>Campaign Update Time|Any|Any|\n|`campaign_version`<br>|Any|Any|\n|`campaign_zone_name`<br>Campaign Time Zone, a.k.a time_zone|Any|Any|\n|`flight_id`<br>|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|`prisma_campaign_id`<br>|Any|Any|\n|`prisma_client_product_estimate`<br>|Any|Any|\n|`prisma_io_number`<br>|Any|Any|\n|`strategy_ads_txt_verified`<br>|Any|Any|\n|`strategy_archived`<br>|Any|Any|\n|`strategy_audience_segment_exclude_op`<br>|Any|Any|\n|`strategy_audience_segment_include_op`<br>|Any|Any|\n|`strategy_bid_aggressiveness`<br>|Any|Any|\n|`strategy_bid_min_devices`<br>|Any|Any|\n|`strategy_bid_price_is_media_only`<br>|Any|Any|\n|`strategy_budget`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_value`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_value`<br>|Any|Any|\n|`strategy_created_on`<br>|Any|Any|\n|`strategy_currency_code`<br>|Any|Any|\n|`strategy_description`<br>|Any|Any|\n|`strategy_device_graph_only`<br>|Any|Any|\n|`strategy_end_date_raw`<br>|Any|Any|\n|`strategy_exchange_type_for_run_on_all`<br>|Any|Any|\n|`strategy_feature_compatibility`<br>|Any|Any|\n|`strategy_frequency_amount`<br>|Any|Any|\n|`strategy_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`strategy_frequency_optimization`<br>|Any|Any|\n|`strategy_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`strategy_goal_type`<br>|Any|Any|\n|`strategy_goal_value`<br>|Any|Any|\n|`strategy_groups`<br>|Any|Any|\n|`strategy_id`<br>|Any|Any|\n|`strategy_impression_pacing_amount`<br>|Any|Any|\n|`strategy_impression_pacing_interval`<br>|Any|Any|\n|`strategy_impression_pacing_type`<br>|Any|Any|\n|`strategy_max_bid`<br>|Any|Any|\n|`strategy_max_bid_wm`<br>|Any|Any|\n|`strategy_media_type`<br>|Any|Any|\n|`strategy_min_bid`<br>|Any|Any|\n|`strategy_name`<br>|Any|Any|\n|`strategy_pacing_amount`<br>|Any|Any|\n|`strategy_pacing_interval`<br>|Any|Any|\n|`strategy_pacing_optimization_amount`<br>|Any|Any|\n|`strategy_pacing_optimization_type`<br>|Any|Any|\n|`strategy_pacing_type`<br>|Any|Any|\n|`strategy_roi_target`<br>|Any|Any|\n|`strategy_run_on_all_exchanges`<br>|Any|Any|\n|`strategy_run_on_all_pmp`<br>|Any|Any|\n|`strategy_run_on_display`<br>|Any|Any|\n|`strategy_run_on_mobile`<br>|Any|Any|\n|`strategy_run_on_only_fraud_filtered_exchanges`<br>|Any|Any|\n|`strategy_run_on_streaming`<br>|Any|Any|\n|`strategy_site_restriction_transparent_urls`<br>|Any|Any|\n|`strategy_site_selectiveness`<br>|Any|Any|\n|`strategy_source_only`<br>|Any|Any|\n|`strategy_start_date_raw`<br>|Any|Any|\n|`strategy_status`<br>Active Status|Any|Any|\n|`strategy_supply_type`<br>|Any|Any|\n|`strategy_targeting_segment_exclude_op`<br>|Any|Any|\n|`strategy_targeting_segment_include_op`<br>|Any|Any|\n|`strategy_type`<br>|Any|Any|\n|`strategy_updated_on`<br>|Any|Any|\n|`strategy_use_bid_shading`<br>|Any|Any|\n|`strategy_use_campaign_end`<br>|Any|Any|\n|`strategy_use_campaign_start`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing_after_date`<br>|Any|Any|\n|`strategy_use_mm_freq`<br>|Any|Any|\n|`strategy_use_optimization`<br>|Any|Any|\n|`strategy_version`<br>|Any|Any|\n|`strategy_zone_name`<br>|Any|Any|\n|**Metrics**|\n|`clicks`<br>|Any|Any|\n|`ctc`<br>CTC|Any|Any|\n|`ctr`<br>CTR|Any|Any|\n|`impressions`<br>|Any|Any|\n|`in_view`<br>In View Impressions|Any|Any|\n|`in_view_100_percent`<br>100% In View Impressions|Any|Any|\n|`in_view_15_seconds`<br>|Any|Any|\n|`in_view_15_seconds_rate`<br>|Any|Any|\n|`in_view_5_seconds`<br>|Any|Any|\n|`in_view_5_seconds_rate`<br>|Any|Any|\n|`measurability_rate`<br>Measurability Rate|Any|Any|\n|`measurable`<br>Measurable Impressions|Any|Any|\n|`post_click_aov`<br>Post-Click AOV|Any|Any|\n|`post_click_conversions`<br>Post-Click Conversions|Any|Any|\n|`post_click_revenue`<br>Post-Click Revenue|Any|Any|\n|`post_click_revenue_usd`<br>|Any|Any|\n|`post_click_total_spend_roi`<br>Post-Click Total Spend ROI|Any|Any|\n|`post_view_aov`<br>Post-View AOV|Any|Any|\n|`post_view_conversions`<br>Post-View Conversions|Any|Any|\n|`post_view_conversions_raw`<br>Post-View Conversions (Raw)|Any|Any|\n|`post_view_revenue`<br>Post-View Revenue|Any|Any|\n|`post_view_revenue_raw`<br>Post-View Revenue (Raw)|Any|Any|\n|`post_view_revenue_raw_usd`<br>|Any|Any|\n|`post_view_total_spend_roi`<br>Post-View Total Spend ROI|Any|Any|\n|`revenue`<br>Revenue (Raw)|Any|Any|\n|`rr_per_1k_imps`<br>Response Rate/1K Imps|Any|Any|\n|`total_aov`<br>Total AOV|Any|Any|\n|`total_conversions`<br>|Any|Any|\n|`total_revenue`<br>|Any|Any|\n|`total_spend`<br>|Any|Any|\n|`total_spend_cpa`<br>Total Spend eCPA|Any|Any|\n|`total_spend_cpc`<br>Total Spend eCPC|Any|Any|\n|`total_spend_cpcv`<br>Total Spend eCPCV|Any|Any|\n|`total_spend_cpm`<br>Total Spend eCPM|Any|Any|\n|`total_spend_pc_cpa`<br>Total Spend PC CPA|Any|Any|\n|`total_spend_pv_cpa`<br>Total Spend PV CPA|Any|Any|\n|`total_spend_roi`<br>Total Spend ROI|Any|Any|\n|`total_spend_usd`<br>|Any|Any|\n|`total_spend_vcpm`<br>Total Spend vCPM |Any|Any|\n|`tpa_conversions`<br>3PA Total Conversions|Any|Any|\n|`tpa_total_aov`<br>3PA Total AOV|Any|Any|\n|`tpa_total_aov_usd`<br>(USD) 3PA Total AOV|Any|Any|\n|`tpa_total_revenue`<br>3PA Total Revenue|Any|Any|\n|`tpa_total_revenue_usd`<br>(USD) 3PA Total Revenue|Any|Any|\n|`tpa_total_spend_cpa`<br>3PA Total Spend CPA|Any|Any|\n|`tpa_total_spend_cpa_usd`<br>(USD) 3PA Total Spend CPA|Any|Any|\n|`tpa_total_spend_roi`<br>3PA Total Spend ROI|Any|Any|\n|`video_close`<br>Close|Any|Any|\n|`video_collapse`<br>Collapse|Any|Any|\n|`video_companion_clicks`<br>Companion Clicks|Any|Any|\n|`video_companion_ctr`<br>Companion CTR|Any|Any|\n|`video_companion_impressions`<br>Companion Impressions|Any|Any|\n|`video_complete`<br>100% Completed Views|Any|Any|\n|`video_complete_rate`<br>100% Completed Rate|Any|Any|\n|`video_complete_rate_impression_based`<br>VCR (Impression Based)|Any|Any|\n|`video_engaged_impressions`<br>Engaged Impressions|Any|Any|\n|`video_engaged_rate`<br>Engaged Rate|Any|Any|\n|`video_expand`<br>Expand|Any|Any|\n|`video_first_quartile`<br>25% Completed Views|Any|Any|\n|`video_first_quartile_rate`<br>25% Completed Rate|Any|Any|\n|`video_first_quartile_rate_impression_based`<br>25% Completed Rate - Impressions Based|Any|Any|\n|`video_fullscreen`<br>Fullscreen|Any|Any|\n|`video_midpoint`<br>50% Completed Views|Any|Any|\n|`video_midpoint_rate`<br>50% Completed Rate|Any|Any|\n|`video_midpoint_rate_impression_based`<br>50% Completed Rate - Impressions Based|Any|Any|\n|`video_mute`<br>|Any|Any|\n|`video_pause`<br>Pause|Any|Any|\n|`video_play_rate`<br>Play Rate|Any|Any|\n|`video_resume`<br>Resume|Any|Any|\n|`video_rewind`<br>Rewind|Any|Any|\n|`video_skip`<br>Skip|Any|Any|\n|`video_skippable_impressions`<br>Skippable Impressions|Any|Any|\n|`video_skipped_impressions`<br>Skipped Impressions|Any|Any|\n|`video_skipped_rate`<br>Skipped Rate|Any|Any|\n|`video_start`<br>Start|Any|Any|\n|`video_third_quartile`<br>75% Completed Views|Any|Any|\n|`video_third_quartile_rate`<br>75% Completed Rate|Any|Any|\n|`video_third_quartile_rate_impression_based`<br>75% Completed Rate - Impressions Based|Any|Any|\n|`video_unmute`<br>|Any|Any|\n|`viewability_rate`<br>Viewability Rate|Any|Any|\n|`viewability_rate_100_percent`<br>100% In View Rate|Any|Any|\n\n### Pageable\nNo\n\n### Time Windows\n`current_day`, `last_X_days`, `last_X_hours`, `month_to_date`, `yesterday`\n\n### Rollups\n`all`, `by_day`, `by_hour`, `by_month`, `by_week`\n\n\n### Data Retention / Lookback Window\n90 days\n### Time Zones\n`UTC`, `campaign`\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - title: Time Window
                  required:
                    - time_window
                - title: Date Range
                  required:
                    - start_time
              required:
                - fields
                - filters
                - order
                - rollup
              properties:
                end_time:
                  type: string
                  format: date-time
                  nullable: true
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                rollup:
                  type: string
                start_time:
                  type: string
                  format: date-time
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /pixel-loads:
    post:
      tags:
        - Datasets
      summary: Pixel Loads
      description: "\nLoads and Uniques metrics for `data` and `event` pixels, broken out by referrer and referrer rank, available by day.\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`agg_timestamp`|`current_day`, `last_X_days`, `month_to_date`, `yesterday`|`by_day`, `by_month`, `by_week`|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`pixel_advertiser_id`<br>|Any|Any|\n|`pixel_cost_cpm`<br>|Any|Any|\n|`pixel_cost_cpts`<br>|Any|Any|\n|`pixel_cost_pct_cpm`<br>|Any|Any|\n|`pixel_created_on`<br>Pixel Creation Time|Any|Any|\n|`pixel_currency`<br>|Any|Any|\n|`pixel_currency_fixed`<br>|Any|Any|\n|`pixel_eligible`<br>|Any|Any|\n|`pixel_external_identifier`<br>|Any|Any|\n|`pixel_id`<br>|Any|Any|\n|`pixel_name`<br>|Any|Any|\n|`pixel_pricing`<br>|Any|Any|\n|`pixel_provider_created_on`<br>|Any|Any|\n|`pixel_provider_execution_by`<br>|Any|Any|\n|`pixel_provider_id`<br>|Any|Any|\n|`pixel_provider_name`<br>|Any|Any|\n|`pixel_provider_provider_tax`<br>|Any|Any|\n|`pixel_provider_status`<br>|Any|Any|\n|`pixel_provider_taxonomy_file`<br>|Any|Any|\n|`pixel_provider_updated_on`<br>|Any|Any|\n|`pixel_provider_vendor_id`<br>|Any|Any|\n|`pixel_provider_version`<br>|Any|Any|\n|`pixel_rmx_conversion_minutes`<br>|Any|Any|\n|`pixel_rmx_conversion_type`<br>|Any|Any|\n|`pixel_rmx_friendly`<br>|Any|Any|\n|`pixel_rmx_merit`<br>|Any|Any|\n|`pixel_rmx_pc_window_minutes`<br>|Any|Any|\n|`pixel_rmx_pv_window_minutes`<br>|Any|Any|\n|`pixel_segment_op`<br>|Any|Any|\n|`pixel_status`<br>|Any|Any|\n|`pixel_tag_type`<br>|Any|Any|\n|`pixel_tags`<br>|Any|Any|\n|`pixel_type`<br>|Any|Any|\n|`pixel_updated_on`<br>Pixel Update Time|Any|Any|\n|`provider_id`<br>|Any|Any|\n|`referrer`<br>|Any|Any|\n|`referrer_rank`<br>|Any|Any|\n|**Metrics**|\n|`loads`<br>|Any|Any|\n|`uniques`<br>|Any|Any|\n\n### Pageable\nYes\n\n### Time Windows\n`current_day`, `last_X_days`, `month_to_date`, `yesterday`\n\n### Rollups\n`all`, `by_day`, `by_month`, `by_week`\n\n\n### Data Retention / Lookback Window\n90 days\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - title: Time Window
                  required:
                    - time_window
                - title: Date Range
                  required:
                    - start_time
              required:
                - fields
                - filters
                - order
                - rollup
              properties:
                end_time:
                  type: string
                  format: date-time
                  nullable: true
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                pagination:
                  type: object
                  description: >-
                    Streaming response if absent or `null`, Paginated response
                    otherwise
                  nullable: true
                  properties:
                    page_index:
                      type: integer
                      minimum: 0
                    page_size:
                      type: integer
                      minimum: 1
                      maximum: 1000
                rollup:
                  type: string
                start_time:
                  type: string
                  format: date-time
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    type: object
                    properties:
                      items_count:
                        type: integer
                        minimum: 0
                      page_index:
                        type: integer
                        minimum: 0
                      status:
                        type: string
                        enum:
                          - ok
                      total_items_count:
                        type: integer
                        minimum: 0
                      total_pages:
                        type: integer
                        minimum: 0
                  results:
                    type: array
                    items:
                      type: object
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /postal_code:
    post:
      tags:
        - Datasets
      summary: Postal Code Report
      description: "\nStandard performance metrics broken out by postal code. Only includes data for strategies that targeted or anti-targeted postal codes. Available in custom date ranges or intervals with the option to aggregate by day, week, or month.\n\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`agg_timestamp`|`current_day`, `last_X_days`, `month_to_date`, `yesterday`|`by_day`, `by_month`, `by_week`|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`attribution_group`<br>|Any|Any|\n|`campaign_ads_txt_verified`<br>|Any|Any|\n|`campaign_agency_fee_pct`<br>|Any|Any|\n|`campaign_archived`<br>|Any|Any|\n|`campaign_bid_min_devices`<br>|Any|Any|\n|`campaign_brain_intraday_pacing`<br>|Any|Any|\n|`campaign_connected_id_type`<br>|Any|Any|\n|`campaign_conversion_type`<br>|Any|Any|\n|`campaign_conversion_variable_minutes`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_value`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_value`<br>|Any|Any|\n|`campaign_created_on`<br>Campaign Creation Time|Any|Any|\n|`campaign_currency_code`<br>Campaign Currency Code|Any|Any|\n|`campaign_custom_attribution_source`<br>|Any|Any|\n|`campaign_dcs_data_is_campaign_level`<br>|Any|Any|\n|`campaign_device_graph_only`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_applied`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_available`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_type`<br>|Any|Any|\n|`campaign_end_date`<br>(GMT) Campaign End Date|Any|Any|\n|`campaign_end_date_tz`<br>(CTZ) Campaign End Date|Any|Any|\n|`campaign_frequency_amount`<br>Campaign Frequency Amount|Any|Any|\n|`campaign_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`campaign_frequency_optimization`<br>Campaign Frequency Optimization|Any|Any|\n|`campaign_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`campaign_goal_alert`<br>|Any|Any|\n|`campaign_goal_category`<br>|Any|Any|\n|`campaign_goal_type`<br>|Any|Any|\n|`campaign_goal_value`<br>|Any|Any|\n|`campaign_has_custom_attribution`<br>|Any|Any|\n|`campaign_id`<br>|Any|Any|\n|`campaign_impression_cap_amount`<br>|Any|Any|\n|`campaign_impression_cap_automatic`<br>|Any|Any|\n|`campaign_impression_cap_type`<br>|Any|Any|\n|`campaign_in_flight`<br>In Flight|Any|Any|\n|`campaign_initial_start_date`<br>(GMT) Campaign Initial Start Date|Any|Any|\n|`campaign_initial_start_date_tz`<br>(CTZ) Campaign Initial Start Date|Any|Any|\n|`campaign_io_name`<br>|Any|Any|\n|`campaign_io_reference_num`<br>|Any|Any|\n|`campaign_is_programmatic_guaranteed`<br>Campaign Is Programmatic Guaranteed|Any|Any|\n|`campaign_merit_pixel_id`<br>|Any|Any|\n|`campaign_minimize_multi_ads`<br>Minimize Multi Ads|Any|Any|\n|`campaign_name`<br>|Any|Any|\n|`campaign_override_suspicious_traffic_filter`<br>|Any|Any|\n|`campaign_pacing_alert`<br>|Any|Any|\n|`campaign_pc_window_minutes`<br>|Any|Any|\n|`campaign_political`<br>|Any|Any|\n|`campaign_pv_pct`<br>|Any|Any|\n|`campaign_pv_window_minutes`<br>|Any|Any|\n|`campaign_restrict_targeting_to_deterministic_id`<br>|Any|Any|\n|`campaign_restrict_targeting_to_same_device_id`<br>|Any|Any|\n|`campaign_service_type`<br>Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag|Any|Any|\n|`campaign_source_campaign_id`<br>|Any|Any|\n|`campaign_spend_cap_amount`<br>|Any|Any|\n|`campaign_spend_cap_automatic`<br>|Any|Any|\n|`campaign_spend_cap_daily_cap`<br>|Any|Any|\n|`campaign_spend_cap_type`<br>|Any|Any|\n|`campaign_start_date`<br>(GMT) Campaign Start Date|Any|Any|\n|`campaign_start_date_tz`<br>(CTZ) Campaign Start Date|Any|Any|\n|`campaign_status`<br>Active Status|Any|Any|\n|`campaign_suspicious_traffic_filter_level`<br>|Any|Any|\n|`campaign_total_budget`<br>|Any|Any|\n|`campaign_total_impression_budget`<br>Campaign Impressions Budget|Any|Any|\n|`campaign_updated_on`<br>Campaign Update Time|Any|Any|\n|`campaign_version`<br>|Any|Any|\n|`campaign_zone_name`<br>Campaign Time Zone, a.k.a time_zone|Any|Any|\n|`exchange_id`<br>|Any|Any|\n|`exchange_name`<br>|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|`postal_code`<br>|Any|Any|\n|`strategy_ads_txt_verified`<br>|Any|Any|\n|`strategy_archived`<br>|Any|Any|\n|`strategy_audience_segment_exclude_op`<br>|Any|Any|\n|`strategy_audience_segment_include_op`<br>|Any|Any|\n|`strategy_bid_aggressiveness`<br>|Any|Any|\n|`strategy_bid_min_devices`<br>|Any|Any|\n|`strategy_bid_price_is_media_only`<br>|Any|Any|\n|`strategy_budget`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_value`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_value`<br>|Any|Any|\n|`strategy_created_on`<br>|Any|Any|\n|`strategy_currency_code`<br>|Any|Any|\n|`strategy_description`<br>|Any|Any|\n|`strategy_device_graph_only`<br>|Any|Any|\n|`strategy_end_date_raw`<br>|Any|Any|\n|`strategy_exchange_type_for_run_on_all`<br>|Any|Any|\n|`strategy_feature_compatibility`<br>|Any|Any|\n|`strategy_frequency_amount`<br>|Any|Any|\n|`strategy_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`strategy_frequency_optimization`<br>|Any|Any|\n|`strategy_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`strategy_goal_type`<br>|Any|Any|\n|`strategy_goal_value`<br>|Any|Any|\n|`strategy_groups`<br>|Any|Any|\n|`strategy_id`<br>|Any|Any|\n|`strategy_impression_pacing_amount`<br>|Any|Any|\n|`strategy_impression_pacing_interval`<br>|Any|Any|\n|`strategy_impression_pacing_type`<br>|Any|Any|\n|`strategy_max_bid`<br>|Any|Any|\n|`strategy_max_bid_wm`<br>|Any|Any|\n|`strategy_media_type`<br>|Any|Any|\n|`strategy_min_bid`<br>|Any|Any|\n|`strategy_name`<br>|Any|Any|\n|`strategy_pacing_amount`<br>|Any|Any|\n|`strategy_pacing_interval`<br>|Any|Any|\n|`strategy_pacing_optimization_amount`<br>|Any|Any|\n|`strategy_pacing_optimization_type`<br>|Any|Any|\n|`strategy_pacing_type`<br>|Any|Any|\n|`strategy_roi_target`<br>|Any|Any|\n|`strategy_run_on_all_exchanges`<br>|Any|Any|\n|`strategy_run_on_all_pmp`<br>|Any|Any|\n|`strategy_run_on_display`<br>|Any|Any|\n|`strategy_run_on_mobile`<br>|Any|Any|\n|`strategy_run_on_only_fraud_filtered_exchanges`<br>|Any|Any|\n|`strategy_run_on_streaming`<br>|Any|Any|\n|`strategy_site_restriction_transparent_urls`<br>|Any|Any|\n|`strategy_site_selectiveness`<br>|Any|Any|\n|`strategy_source_only`<br>|Any|Any|\n|`strategy_start_date_raw`<br>|Any|Any|\n|`strategy_status`<br>Active Status|Any|Any|\n|`strategy_supply_type`<br>|Any|Any|\n|`strategy_targeting_segment_exclude_op`<br>|Any|Any|\n|`strategy_targeting_segment_include_op`<br>|Any|Any|\n|`strategy_type`<br>|Any|Any|\n|`strategy_updated_on`<br>|Any|Any|\n|`strategy_use_bid_shading`<br>|Any|Any|\n|`strategy_use_campaign_end`<br>|Any|Any|\n|`strategy_use_campaign_start`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing_after_date`<br>|Any|Any|\n|`strategy_use_mm_freq`<br>|Any|Any|\n|`strategy_use_optimization`<br>|Any|Any|\n|`strategy_version`<br>|Any|Any|\n|`strategy_zone_name`<br>|Any|Any|\n|**Metrics**|\n|`clicks`<br>|Any|Any|\n|`ctc`<br>CTC|Any|Any|\n|`ctr`<br>CTR|Any|Any|\n|`impressions`<br>|Any|Any|\n|`post_click_conversions`<br>Post-Click Conversions|Any|Any|\n|`post_view_conversions`<br>Post-View Conversions|Any|Any|\n|`rr_per_1k_imps`<br>Response Rate/1K Imps|Any|Any|\n|`total_conversions`<br>|Any|Any|\n|`total_spend`<br>|Any|Any|\n|`total_spend_cpa`<br>Total Spend eCPA|Any|Any|\n|`total_spend_cpc`<br>Total Spend eCPC|Any|Any|\n|`total_spend_cpm`<br>Total Spend eCPM|Any|Any|\n|`total_spend_pc_cpa`<br>Total Spend PC CPA|Any|Any|\n|`total_spend_pv_cpa`<br>Total Spend PV CPA|Any|Any|\n\n### Pageable\nNo\n\n### Time Windows\n`current_day`, `last_X_days`, `month_to_date`, `yesterday`\n\n### Rollups\n`all`, `by_day`, `by_month`, `by_week`\n\n\n### Data Retention / Lookback Window\n30 days\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - title: Time Window
                  required:
                    - time_window
                - title: Date Range
                  required:
                    - start_time
              required:
                - fields
                - filters
                - order
                - rollup
              properties:
                end_time:
                  type: string
                  format: date-time
                  nullable: true
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                rollup:
                  type: string
                start_time:
                  type: string
                  format: date-time
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /reach-frequency:
    post:
      tags:
        - Datasets
      summary: Reach and Frequency Report
      description: "\nBasic performance metrics as well as the \"uniques\" metric, broken out by frequency of ad exposure.  Available in standard intervals.\n\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`campaign_ads_txt_verified`<br>|Any|Any|\n|`campaign_agency_fee_pct`<br>|Any|Any|\n|`campaign_archived`<br>|Any|Any|\n|`campaign_bid_min_devices`<br>|Any|Any|\n|`campaign_brain_intraday_pacing`<br>|Any|Any|\n|`campaign_connected_id_type`<br>|Any|Any|\n|`campaign_conversion_type`<br>|Any|Any|\n|`campaign_conversion_variable_minutes`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_value`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_value`<br>|Any|Any|\n|`campaign_created_on`<br>Campaign Creation Time|Any|Any|\n|`campaign_currency_code`<br>Campaign Currency Code|Any|Any|\n|`campaign_custom_attribution_source`<br>|Any|Any|\n|`campaign_dcs_data_is_campaign_level`<br>|Any|Any|\n|`campaign_device_graph_only`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_applied`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_available`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_type`<br>|Any|Any|\n|`campaign_end_date`<br>(GMT) Campaign End Date|Any|Any|\n|`campaign_end_date_tz`<br>(CTZ) Campaign End Date|Any|Any|\n|`campaign_frequency_amount`<br>Campaign Frequency Amount|Any|Any|\n|`campaign_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`campaign_frequency_optimization`<br>Campaign Frequency Optimization|Any|Any|\n|`campaign_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`campaign_goal_alert`<br>|Any|Any|\n|`campaign_goal_category`<br>|Any|Any|\n|`campaign_goal_type`<br>|Any|Any|\n|`campaign_goal_value`<br>|Any|Any|\n|`campaign_has_custom_attribution`<br>|Any|Any|\n|`campaign_id`<br>|Any|Any|\n|`campaign_impression_cap_amount`<br>|Any|Any|\n|`campaign_impression_cap_automatic`<br>|Any|Any|\n|`campaign_impression_cap_type`<br>|Any|Any|\n|`campaign_in_flight`<br>In Flight|Any|Any|\n|`campaign_initial_start_date`<br>(GMT) Campaign Initial Start Date|Any|Any|\n|`campaign_initial_start_date_tz`<br>(CTZ) Campaign Initial Start Date|Any|Any|\n|`campaign_io_name`<br>|Any|Any|\n|`campaign_io_reference_num`<br>|Any|Any|\n|`campaign_is_programmatic_guaranteed`<br>Campaign Is Programmatic Guaranteed|Any|Any|\n|`campaign_merit_pixel_id`<br>|Any|Any|\n|`campaign_minimize_multi_ads`<br>Minimize Multi Ads|Any|Any|\n|`campaign_name`<br>|Any|Any|\n|`campaign_override_suspicious_traffic_filter`<br>|Any|Any|\n|`campaign_pacing_alert`<br>|Any|Any|\n|`campaign_pc_window_minutes`<br>|Any|Any|\n|`campaign_political`<br>|Any|Any|\n|`campaign_pv_pct`<br>|Any|Any|\n|`campaign_pv_window_minutes`<br>|Any|Any|\n|`campaign_restrict_targeting_to_deterministic_id`<br>|Any|Any|\n|`campaign_restrict_targeting_to_same_device_id`<br>|Any|Any|\n|`campaign_service_type`<br>Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag|Any|Any|\n|`campaign_source_campaign_id`<br>|Any|Any|\n|`campaign_spend_cap_amount`<br>|Any|Any|\n|`campaign_spend_cap_automatic`<br>|Any|Any|\n|`campaign_spend_cap_daily_cap`<br>|Any|Any|\n|`campaign_spend_cap_type`<br>|Any|Any|\n|`campaign_start_date`<br>(GMT) Campaign Start Date|Any|Any|\n|`campaign_start_date_tz`<br>(CTZ) Campaign Start Date|Any|Any|\n|`campaign_status`<br>Active Status|Any|Any|\n|`campaign_suspicious_traffic_filter_level`<br>|Any|Any|\n|`campaign_total_budget`<br>|Any|Any|\n|`campaign_total_impression_budget`<br>Campaign Impressions Budget|Any|Any|\n|`campaign_updated_on`<br>Campaign Update Time|Any|Any|\n|`campaign_version`<br>|Any|Any|\n|`campaign_zone_name`<br>Campaign Time Zone, a.k.a time_zone|Any|Any|\n|`frequency`<br>number of impressions seen by a unique user|Any|Any|\n|`frequency_bin`<br>|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|`strategy_ads_txt_verified`<br>|Any|Any|\n|`strategy_archived`<br>|Any|Any|\n|`strategy_audience_segment_exclude_op`<br>|Any|Any|\n|`strategy_audience_segment_include_op`<br>|Any|Any|\n|`strategy_bid_aggressiveness`<br>|Any|Any|\n|`strategy_bid_min_devices`<br>|Any|Any|\n|`strategy_bid_price_is_media_only`<br>|Any|Any|\n|`strategy_budget`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_value`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_value`<br>|Any|Any|\n|`strategy_created_on`<br>|Any|Any|\n|`strategy_currency_code`<br>|Any|Any|\n|`strategy_description`<br>|Any|Any|\n|`strategy_device_graph_only`<br>|Any|Any|\n|`strategy_end_date_raw`<br>|Any|Any|\n|`strategy_exchange_type_for_run_on_all`<br>|Any|Any|\n|`strategy_feature_compatibility`<br>|Any|Any|\n|`strategy_frequency_amount`<br>|Any|Any|\n|`strategy_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`strategy_frequency_optimization`<br>|Any|Any|\n|`strategy_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`strategy_goal_type`<br>|Any|Any|\n|`strategy_goal_value`<br>|Any|Any|\n|`strategy_groups`<br>|Any|Any|\n|`strategy_id`<br>|Any|Any|\n|`strategy_impression_pacing_amount`<br>|Any|Any|\n|`strategy_impression_pacing_interval`<br>|Any|Any|\n|`strategy_impression_pacing_type`<br>|Any|Any|\n|`strategy_max_bid`<br>|Any|Any|\n|`strategy_max_bid_wm`<br>|Any|Any|\n|`strategy_media_type`<br>|Any|Any|\n|`strategy_min_bid`<br>|Any|Any|\n|`strategy_name`<br>|Any|Any|\n|`strategy_pacing_amount`<br>|Any|Any|\n|`strategy_pacing_interval`<br>|Any|Any|\n|`strategy_pacing_optimization_amount`<br>|Any|Any|\n|`strategy_pacing_optimization_type`<br>|Any|Any|\n|`strategy_pacing_type`<br>|Any|Any|\n|`strategy_roi_target`<br>|Any|Any|\n|`strategy_run_on_all_exchanges`<br>|Any|Any|\n|`strategy_run_on_all_pmp`<br>|Any|Any|\n|`strategy_run_on_display`<br>|Any|Any|\n|`strategy_run_on_mobile`<br>|Any|Any|\n|`strategy_run_on_only_fraud_filtered_exchanges`<br>|Any|Any|\n|`strategy_run_on_streaming`<br>|Any|Any|\n|`strategy_site_restriction_transparent_urls`<br>|Any|Any|\n|`strategy_site_selectiveness`<br>|Any|Any|\n|`strategy_source_only`<br>|Any|Any|\n|`strategy_start_date_raw`<br>|Any|Any|\n|`strategy_status`<br>Active Status|Any|Any|\n|`strategy_supply_type`<br>|Any|Any|\n|`strategy_targeting_segment_exclude_op`<br>|Any|Any|\n|`strategy_targeting_segment_include_op`<br>|Any|Any|\n|`strategy_type`<br>|Any|Any|\n|`strategy_updated_on`<br>|Any|Any|\n|`strategy_use_bid_shading`<br>|Any|Any|\n|`strategy_use_campaign_end`<br>|Any|Any|\n|`strategy_use_campaign_start`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing_after_date`<br>|Any|Any|\n|`strategy_use_mm_freq`<br>|Any|Any|\n|`strategy_use_optimization`<br>|Any|Any|\n|`strategy_version`<br>|Any|Any|\n|`strategy_zone_name`<br>|Any|Any|\n|**Metrics**|\n|`clicks`<br>|Any|Any|\n|`ctc`<br>CTC|Any|Any|\n|`ctr`<br>CTR|Any|Any|\n|`impressions`<br>|Any|Any|\n|`post_click_conversions`<br>Post-Click Conversions|Any|Any|\n|`post_view_conversions`<br>Post-View Conversions|Any|Any|\n|`rr_per_1k_imps`<br>Response Rate/1K Imps|Any|Any|\n|`total_conversions`<br>|Any|Any|\n|`uniques`<br>|Any|Any|\n\n### Pageable\nYes\n\n### Time Windows\n`last_14_days`, `last_30_days`, `last_7_days`, `yesterday`\n\n### Rollups\n`all`\n\n\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required:
                - fields
                - filters
                - order
                - rollup
                - time_window
              properties:
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                pagination:
                  type: object
                  description: >-
                    Streaming response if absent or `null`, Paginated response
                    otherwise
                  nullable: true
                  properties:
                    page_index:
                      type: integer
                      minimum: 0
                    page_size:
                      type: integer
                      minimum: 1
                      maximum: 1000
                rollup:
                  type: string
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    type: object
                    properties:
                      items_count:
                        type: integer
                        minimum: 0
                      page_index:
                        type: integer
                        minimum: 0
                      status:
                        type: string
                        enum:
                          - ok
                      total_items_count:
                        type: integer
                        minimum: 0
                      total_pages:
                        type: integer
                        minimum: 0
                  results:
                    type: array
                    items:
                      type: object
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
  /win-loss:
    post:
      tags:
        - Datasets
      summary: Win/Loss
      description: "\nMetrics describe the auction before a win or even a bid has taken place.  Broken out by strategy, exchange, and deal dimensions and available by hour.\n\n\n### Fields\n\n| Field | Time Windows \t| Rollups \t|\n|-------|---------------|-----------|\n|**Dimensions**|\n|`agg_timestamp`|`current_day`, `last_X_days`, `last_X_hours`, `month_to_date`, `yesterday`|`by_day`, `by_hour`, `by_month`, `by_week`|\n|`advertiser_id`<br>|Any|Any|\n|`advertiser_name`<br>|Any|Any|\n|`agency_id`<br>|Any|Any|\n|`agency_name`<br>|Any|Any|\n|`attribution_group`<br>|Any|Any|\n|`campaign_ads_txt_verified`<br>|Any|Any|\n|`campaign_agency_fee_pct`<br>|Any|Any|\n|`campaign_archived`<br>|Any|Any|\n|`campaign_bid_min_devices`<br>|Any|Any|\n|`campaign_brain_intraday_pacing`<br>|Any|Any|\n|`campaign_connected_id_type`<br>|Any|Any|\n|`campaign_conversion_type`<br>|Any|Any|\n|`campaign_conversion_variable_minutes`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_cpm_value`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`campaign_cost_passthrough_percent_value`<br>|Any|Any|\n|`campaign_created_on`<br>Campaign Creation Time|Any|Any|\n|`campaign_currency_code`<br>Campaign Currency Code|Any|Any|\n|`campaign_custom_attribution_source`<br>|Any|Any|\n|`campaign_dcs_data_is_campaign_level`<br>|Any|Any|\n|`campaign_device_graph_only`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_applied`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_available`<br>|Any|Any|\n|`campaign_dynamic_budget_allocation_type`<br>|Any|Any|\n|`campaign_end_date`<br>(GMT) Campaign End Date|Any|Any|\n|`campaign_end_date_tz`<br>(CTZ) Campaign End Date|Any|Any|\n|`campaign_frequency_amount`<br>Campaign Frequency Amount|Any|Any|\n|`campaign_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`campaign_frequency_optimization`<br>Campaign Frequency Optimization|Any|Any|\n|`campaign_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`campaign_goal_alert`<br>|Any|Any|\n|`campaign_goal_category`<br>|Any|Any|\n|`campaign_goal_type`<br>|Any|Any|\n|`campaign_goal_value`<br>|Any|Any|\n|`campaign_has_custom_attribution`<br>|Any|Any|\n|`campaign_id`<br>|Any|Any|\n|`campaign_impression_cap_amount`<br>|Any|Any|\n|`campaign_impression_cap_automatic`<br>|Any|Any|\n|`campaign_impression_cap_type`<br>|Any|Any|\n|`campaign_in_flight`<br>In Flight|Any|Any|\n|`campaign_initial_start_date`<br>(GMT) Campaign Initial Start Date|Any|Any|\n|`campaign_initial_start_date_tz`<br>(CTZ) Campaign Initial Start Date|Any|Any|\n|`campaign_io_name`<br>|Any|Any|\n|`campaign_io_reference_num`<br>|Any|Any|\n|`campaign_is_programmatic_guaranteed`<br>Campaign Is Programmatic Guaranteed|Any|Any|\n|`campaign_merit_pixel_id`<br>|Any|Any|\n|`campaign_minimize_multi_ads`<br>Minimize Multi Ads|Any|Any|\n|`campaign_name`<br>|Any|Any|\n|`campaign_override_suspicious_traffic_filter`<br>|Any|Any|\n|`campaign_pacing_alert`<br>|Any|Any|\n|`campaign_pc_window_minutes`<br>|Any|Any|\n|`campaign_political`<br>|Any|Any|\n|`campaign_pv_pct`<br>|Any|Any|\n|`campaign_pv_window_minutes`<br>|Any|Any|\n|`campaign_restrict_targeting_to_deterministic_id`<br>|Any|Any|\n|`campaign_restrict_targeting_to_same_device_id`<br>|Any|Any|\n|`campaign_service_type`<br>Campaign Service Type, a.k.a. Managed Service Flag / managed_service_flag|Any|Any|\n|`campaign_source_campaign_id`<br>|Any|Any|\n|`campaign_spend_cap_amount`<br>|Any|Any|\n|`campaign_spend_cap_automatic`<br>|Any|Any|\n|`campaign_spend_cap_daily_cap`<br>|Any|Any|\n|`campaign_spend_cap_type`<br>|Any|Any|\n|`campaign_start_date`<br>(GMT) Campaign Start Date|Any|Any|\n|`campaign_start_date_tz`<br>(CTZ) Campaign Start Date|Any|Any|\n|`campaign_status`<br>Active Status|Any|Any|\n|`campaign_suspicious_traffic_filter_level`<br>|Any|Any|\n|`campaign_total_budget`<br>|Any|Any|\n|`campaign_total_impression_budget`<br>Campaign Impressions Budget|Any|Any|\n|`campaign_updated_on`<br>Campaign Update Time|Any|Any|\n|`campaign_version`<br>|Any|Any|\n|`campaign_zone_name`<br>Campaign Time Zone, a.k.a time_zone|Any|Any|\n|`deal_exchange_id`<br>|Any|Any|\n|`deal_external_id`<br>|Any|Any|\n|`deal_group_id`<br>|Any|Any|\n|`deal_group_name`<br>|Any|Any|\n|`deal_id`<br>|Any|Any|\n|`deal_name`<br>|Any|Any|\n|`deal_organization_id`<br>|Any|Any|\n|`deal_price_type`<br>|Any|Any|\n|`deal_publisher_id`<br>Deal Publisher ID|Any|Any|\n|`exchange_id`<br>|Any|Any|\n|`exchange_name`<br>|Any|Any|\n|`organization_id`<br>|Any|Any|\n|`organization_name`<br>|Any|Any|\n|`strategy_ads_txt_verified`<br>|Any|Any|\n|`strategy_archived`<br>|Any|Any|\n|`strategy_audience_segment_exclude_op`<br>|Any|Any|\n|`strategy_audience_segment_include_op`<br>|Any|Any|\n|`strategy_bid_aggressiveness`<br>|Any|Any|\n|`strategy_bid_min_devices`<br>|Any|Any|\n|`strategy_bid_price_is_media_only`<br>|Any|Any|\n|`strategy_budget`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_cpm_value`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_enabled`<br>|Any|Any|\n|`strategy_cost_passthrough_percent_value`<br>|Any|Any|\n|`strategy_created_on`<br>|Any|Any|\n|`strategy_currency_code`<br>|Any|Any|\n|`strategy_description`<br>|Any|Any|\n|`strategy_device_graph_only`<br>|Any|Any|\n|`strategy_end_date_raw`<br>|Any|Any|\n|`strategy_exchange_type_for_run_on_all`<br>|Any|Any|\n|`strategy_feature_compatibility`<br>|Any|Any|\n|`strategy_frequency_amount`<br>|Any|Any|\n|`strategy_frequency_interval`<br>Campaign Frequency Interval|Any|Any|\n|`strategy_frequency_optimization`<br>|Any|Any|\n|`strategy_frequency_type`<br>Campaign Frequency Type|Any|Any|\n|`strategy_goal_type`<br>|Any|Any|\n|`strategy_goal_value`<br>|Any|Any|\n|`strategy_groups`<br>|Any|Any|\n|`strategy_id`<br>|Any|Any|\n|`strategy_impression_pacing_amount`<br>|Any|Any|\n|`strategy_impression_pacing_interval`<br>|Any|Any|\n|`strategy_impression_pacing_type`<br>|Any|Any|\n|`strategy_max_bid`<br>|Any|Any|\n|`strategy_max_bid_wm`<br>|Any|Any|\n|`strategy_media_type`<br>|Any|Any|\n|`strategy_min_bid`<br>|Any|Any|\n|`strategy_name`<br>|Any|Any|\n|`strategy_pacing_amount`<br>|Any|Any|\n|`strategy_pacing_interval`<br>|Any|Any|\n|`strategy_pacing_optimization_amount`<br>|Any|Any|\n|`strategy_pacing_optimization_type`<br>|Any|Any|\n|`strategy_pacing_type`<br>|Any|Any|\n|`strategy_roi_target`<br>|Any|Any|\n|`strategy_run_on_all_exchanges`<br>|Any|Any|\n|`strategy_run_on_all_pmp`<br>|Any|Any|\n|`strategy_run_on_display`<br>|Any|Any|\n|`strategy_run_on_mobile`<br>|Any|Any|\n|`strategy_run_on_only_fraud_filtered_exchanges`<br>|Any|Any|\n|`strategy_run_on_streaming`<br>|Any|Any|\n|`strategy_site_restriction_transparent_urls`<br>|Any|Any|\n|`strategy_site_selectiveness`<br>|Any|Any|\n|`strategy_source_only`<br>|Any|Any|\n|`strategy_start_date_raw`<br>|Any|Any|\n|`strategy_status`<br>Active Status|Any|Any|\n|`strategy_supply_type`<br>|Any|Any|\n|`strategy_targeting_segment_exclude_op`<br>|Any|Any|\n|`strategy_targeting_segment_include_op`<br>|Any|Any|\n|`strategy_type`<br>|Any|Any|\n|`strategy_updated_on`<br>|Any|Any|\n|`strategy_use_bid_shading`<br>|Any|Any|\n|`strategy_use_campaign_end`<br>|Any|Any|\n|`strategy_use_campaign_start`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing`<br>|Any|Any|\n|`strategy_use_dba_strategy_pacing_after_date`<br>|Any|Any|\n|`strategy_use_mm_freq`<br>|Any|Any|\n|`strategy_use_optimization`<br>|Any|Any|\n|`strategy_version`<br>|Any|Any|\n|`strategy_zone_name`<br>|Any|Any|\n|**Metrics**|\n|`average_bid_amount_cpm`<br>|Any|Any|\n|`average_win_amount_cpm`<br>|Any|Any|\n|`bid_rate`<br>|Any|Any|\n|`bids`<br>|Any|Any|\n|`matched_bid_opportunities`<br>|Any|Any|\n|`max_bid_amount_cpm`<br>|Any|Any|\n|`max_win_amount_cpm`<br>|Any|Any|\n|`min_bid_amount_cpm`<br>|Any|Any|\n|`min_win_amount_cpm`<br>|Any|Any|\n|`pacing_matched_bid_opportunities`<br>|Any|Any|\n|`total_bid_amount_cpm`<br>|Any|Any|\n|`total_win_amount_cpm`<br>|Any|Any|\n|`win_rate`<br>|Any|Any|\n|`wins`<br>|Any|Any|\n\n### Pageable\nNo\n\n### Time Windows\n`current_day`, `last_X_days`, `last_X_hours`, `month_to_date`, `yesterday`\n\n### Rollups\n`all`, `by_day`, `by_hour`, `by_month`, `by_week`\n\n\n### Data Retention / Lookback Window\n1 year\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - title: Time Window
                  required:
                    - time_window
                - title: Date Range
                  required:
                    - start_time
              required:
                - fields
                - filters
                - order
                - rollup
              properties:
                end_time:
                  type: string
                  format: date-time
                  nullable: true
                fields:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: string
                filters:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      filters:
                        type: array
                        nullable: true
                        minItems: 2
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            filters:
                              type: array
                              description: >-
                                An array of filters. Required if `op` is `and`
                                or `or`.
                              items:
                                type: object
                            op:
                              type: string
                              description: |-
                                * `=`: Equals or contains if `value` is an array
                                * `!=`: Not equals
                                * `>`: Greater than
                                * `>=`: Greater than or equals
                                * `<`: Less than
                                * `<=`: Less than or equals
                                * `=~`: Text contains (case-insensitive)
                                * `and`: All filters must match
                                * `or`: At least one filter must match
                              default: '='
                            value:
                              oneOf:
                                - oneOf:
                                    - type: integer
                                    - type: number
                                    - type: string
                                    - type: boolean
                                - type: boolean
                                - type: array
                                  items:
                                    oneOf:
                                      - type: integer
                                      - type: number
                                      - type: string
                                      - type: boolean
                      op:
                        type: string
                        description: |-
                          * `=`: Equals or contains if `value` is an array
                          * `!=`: Not equals
                          * `>`: Greater than
                          * `>=`: Greater than or equals
                          * `<`: Less than
                          * `<=`: Less than or equals
                          * `=~`: Text contains (case-insensitive)
                          * `and`: All filters must match
                          * `or`: At least one filter must match
                        default: '='
                      value:
                        oneOf:
                          - oneOf:
                              - type: integer
                              - type: number
                              - type: string
                              - type: boolean
                          - type: boolean
                          - type: array
                            items:
                              oneOf:
                                - type: integer
                                - type: number
                                - type: string
                                - type: boolean
                full_entities:
                  type: array
                  uniqueItems: true
                  nullable: true
                  minItems: 1
                  items:
                    type: string
                order:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                      - field
                    properties:
                      desc:
                        type: boolean
                        default: false
                      field:
                        type: string
                      nulls_last:
                        type: boolean
                        default: false
                rollup:
                  type: string
                start_time:
                  type: string
                  format: date-time
                time_window:
                  type: string
                time_zone:
                  type: string
                  description: >-
                    **Only in supported datasets:** `campaign`, `UTC` or a time
                    zone name defined in https://www.iana.org/time-zones
      responses:
        '200':
          description: JSON for Paginated, JSONL for Streaming
          content:
            application/jsonl:
              schema:
                $ref: '#/components/schemas/StreamingResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        5XX:
          $ref: '#/components/responses/ServerError'
security:
  - Auth0:
      - offline_access
servers:
  - url: https://api.mediamath.com/reporting/v2
    description: Live Server
tags:
  - name: Common
  - name: Datasets
