# Reference (/api)



<span className="eyebrow">
  Endpoints
</span>

The API reference is generated from the Vizit Public API OpenAPI specification. Every operation has a page with its request and response schemas, parameters, and code samples.

For behaviors that apply across the API — authentication, error shapes, pagination — see the [standards](/standards/authentication) pages.

## Authentication [#authentication]

Exchange client credentials for short-lived Bearer tokens used on protected endpoints.

* [Obtain an access token](/api/authentication/createToken)

## Product Details [#product-details]

Create, update, and retrieve Product Detail Page (PDP) content for ingestion into Vizit.

* [List product categories](/api/product-details/listProductCategories)
* [Submit a PDP by GTIN](/api/product-details/upsertPdpByGtin)
* [Retrieve PDP scores by GTIN](/api/product-details/getPdpByGtin)
* [Submit a PDP by Amazon ASIN](/api/product-details/upsertPdpByAsin)
* [Retrieve PDP scores by ASIN](/api/product-details/getPdpByAsin)

## Exports [#exports]

Create and poll asynchronous bulk export jobs for PDP and image scores, then download their CSV artifacts.

* [Create a bulk export job](/api/exports/createExport)
* [Retrieve an export](/api/exports/getExport)
* [Download an export artifact](/api/exports/downloadExport)

## Images [#images]

Submit standalone images for asynchronous scoring and poll for their results.

* [Submit an image for scoring](/api/images/scoreImage)
* [Retrieve an image score](/api/images/getImageScore)

## Spark Ideas [#spark-ideas]

Request Spark Ideas (written suggestions for a root image) and poll for their results.

* [Request a Spark Idea](/api/spark-ideas/createSparkIdea)
* [Retrieve a Spark Idea](/api/spark-ideas/getSparkIdea)

## Spark Images [#spark-images]

Request Spark Images (generated image variations for a root image) and poll for their results.

* [Request a Spark Images batch](/api/spark-images/createSparkImagesBatch)
* [Retrieve a Spark Images batch](/api/spark-images/getSparkImagesBatch)
