---
title: "Preview the data"
method: POST
path: "/connectors/amazon_ads/preview"
tags: ["connectors.amazon_ads"]
---

# Preview the data

`POST /connectors/amazon_ads/preview`

## Request

- Base URL: `https://headless.dataddo.com/customer-api/v1`
- URL: `https://headless.dataddo.com/customer-api/v1/connectors/amazon_ads/preview`
- Auth: none declared

## Request body

- PostSourceAmazonAdsInput
  - `o_auth_id` string
  - `authorizer_id` string
  - `nullable_fields` boolean: Setting this parameter to true allows the use of null values. If set to false, default values for each data type will be used instead.
  - `ensure_data_types` object: Overrides the default data types of the produced Source schema, ensuring that each field is typed as specified.
  - `data_types` object: Overrides the default data types of the produced Source schema, ensuring that each field is typed as specified.
  - `connector_id` string
  - `template_id` string
  - `label` string
  - `allow_empty` boolean: Setting this parameter to true allows extraction operations to proceed even if they produce 0 rows. If set to false, the operation will result in an error if no rows are extracted.
  - `date_range` string, nullable
  - `report_type` string
  - `time_unit` string
  - `ad_product` string
  - `profile` string
  - `groupBy` string[]: Array of strings.
  - `inventory_base_group_by` string: Amazon requires Inventory reports to pick exactly one of "supplySource"/"site" as the base dimension - a single-select field (rather than validating array content) keeps the invalid combination unrepresentable, matching how FacebookAdsTrait's $breakdowns avoids Facebook's breakdown-compatibility matrix. Merged into the effective groupBy in getGroupBy() below, so callers never need to know about the split.
  - `advertisers` string[]: Array of strings.
  - `columns` string[]: Array of strings.
  - `campaignStatus` string[]: Array of strings.
  - `adStatus` string[]: Array of strings.
  - `campaign_site_amazon_business` boolean
  - `use_extraction_timestamp` boolean
  - `use_hash` boolean
  - `use_date_start` boolean
  - `use_date_stop` boolean
  - `use_masked_columns` boolean
  - `hash_columns` string[]: Array of strings.
  - `masked_columns` string[]: Array of strings.

## Response `200`

Data preview

- PreviewDto
  - `code` string
  - `blob` string
  - `message` string
  - `header` string[]: Array of strings.
  - `log` Log[]
    - `request_url` string
    - `request_method` string
    - `request_header` object: Set of key/value pairs.
    - `request_body` string
    - `response_status_code` integer
    - `response_status` string
    - `response_header` object: Set of key/value pairs.
    - `response_body` string
    - `response_content_length` integer
    - `duration` number, float
    - `cached` boolean
    - `error` string, nullable
  - `key` string[]: Array of strings.
  - `type` string[]
  - `row_count` integer
  - `data` object[]: Row-oriented data: a list of rows, each row a map keyed by column name.

---

[API](https://skmtc.dev/dataddo/apis/dataddo-headless-beta-api.md) · [All operations](https://skmtc.dev/dataddo/apis/dataddo-headless-beta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dataddo/apis/dataddo-headless-beta-api/revisions/dcfa2345bd10?raw)