Retrieve an export

Queues an asynchronous bulk export for the caller's organization. The response returns immediately with `status: PENDING` and a `status_url` pointing at [Retrieve an export](/api/exports/getExport); poll there until `status` reaches `COMPLETED` to obtain the short-lived presigned download URL. Org scope is enforced by the access token; the optional `filters` block narrows within the org. Each caller is limited to one in-flight `PENDING`/`PROCESSING` export at a time — additional submissions return `409 EXPORT_CONCURRENCY_LIMIT`. ## CSV format Exports are CSV in v1 (JSONL and Parquet deferred to v2). The header row is fixed per `subject`; carousel rows in `subject=images` exports emit empty values for hero-only columns so partners can rely on a stable column set. ### `subject=pdps` column set | Column | Type | Notes | | --- | --- | --- | | `pdp_id` | uuid | PDP identifier; stable across refreshes | | `portfolio_id` | uuid | Owning portfolio | | `retailer_region` | string | e.g. `amazon_us`, `walmart_us` | | `item_id` | string | ASIN or GTIN, depending on retailer | | `name` | string \| null | PDP display name | | `brand` | string \| null | | | `category_id` | uuid \| null | Vizit category identifier | | `category` | string \| null | Category display name | | `listing_score` | int \| null | 0–100, resolved per org | | `raw_listing_score` | float \| null | Pre-blend, pre-penalty | | `listing_score_blended` | int \| null | 0–100, pre-penalty | | `score_penalty` | bool \| null | True if any penalty applied | | `image_count_penalty` | float \| null | | | `image_mix_penalty` | float \| null | | | `image_order_penalty` | float \| null | | | `high_scoring_asset_count` | int \| null | | | `is_ideal_content_mix` | bool \| null | | | `images_matching_ideal_mix` | int \| null | | | `score_status` | string | `CREATED`, `PROCESSING`, `SCORED`, or `CATEGORY_NOT_FOUND` | | `created_at` | date-time | | | `updated_at` | date-time | | | `last_refreshed` | date-time \| null | Last successful scrape + score | ### `subject=images` column set Hero-score and mobile-readiness columns are populated only for hero rows; carousel rows emit empty values in those columns. | Column | Type | Notes | | --- | --- | --- | | `image_id` | uuid | | | `pdp_id` | uuid | Parent PDP | | `portfolio_id` | uuid | Denormalized from PDP for row-standalone exports | | `retailer_region` | string | | | `item_id` | string | ASIN or GTIN of the parent PDP | | `image_type` | string | `hero` or `carousel` | | `image_url` | string | | | `position` | int | 1-based position within the PDP (matches `CarouselImageResponse.position`) | | `source` | string \| null | e.g. `scraped` | | `vizit_score` | int \| null | 0–100, resolved per org | | `raw_score` | float \| null | | | `hero_score` | int \| null | 0–100; null for carousel rows. The `hero_score_breakdown` sub-scores (heroism, category_edge, technical_integrity, local_support) are intentionally omitted from v1 — the hero formula is in flight | | `mobile_ready` | bool \| null | All five clarity scores ≥ 80. Null for carousel | | `mobile_brand_clarity` | float \| null | Null for carousel | | `mobile_product_type_clarity` | float \| null | Null for carousel | | `mobile_variant_clarity` | float \| null | Null for carousel | | `mobile_count_clarity` | float \| null | Null for carousel | | `mobile_size_clarity` | float \| null | Null for carousel | | `mobile_scored_model` | string \| null | Null for carousel | | `classification` | string \| null | e.g. `Lifestyle`, `Packshot` | | `classification_confidence` | float \| null | 0–1 | | `classification_high_confidence` | bool \| null | | | `created_at` | date-time | | | `updated_at` | date-time | | | `scored_at` | date-time \| null | Last successful score |