> For the complete documentation index, see [llms.txt](https://developers.citrusad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.citrusad.com/integration/reference.md).

# Reference

{% hint style="info" %}
Epsilon Retail Media's documentation is now centralized with our knowledgebase!

For up to date guides, please view [this page](https://help.citrusad.com/retail-media-interface/integration) in the new Integration APIs space of our documentation.
{% endhint %}

Reference documentation for the Integration APIs.

## Getting started

* [Overview](/integration/reference/overview.md)
* [What ads can Epsilon Retail Media serve?](/integration/reference/what-ads-can-citrusad-serve-1.md)
* [Epsilon API Terms of Use](/integration/reference/epsilon-api-terms-of-use.md)
* [Acceptable Use Policy](/integration/reference/acceptable-use-policy.md)

## Data & API

* [API overview](/integration/reference/api-overview.md)
* [Ad Integration Workflow Options for Retailers](/integration/reference/integration-workflow-options-1.md)
* [Before you start](/integration/reference/before-you-start.md)
* [HTTP persistence & endpoints](/integration/reference/http-persistence-ad-caching-endpoints-1.md)
* [Reporting Impressions and Clicks](/integration/reference/reporting-impressions-clicks.md)
* [Ad generation filtering](/integration/reference/ad-generation-filtering-1.md)
* [Timeouts and graceful fallback behaviour](/integration/reference/timeouts-and-graceful-fallback-behaviour.md)
* [OAuth 2.0 Authentication](/integration/reference/oauth-20-authentication.md)
* [Ad Interaction Events Reporting](/integration/reference/ad-interaction-events-reporting.md)
* [Integrate Banner X Video Interaction Reporting](/integration/reference/integrate-banner-x-video-interaction-reporting.md)
* [Integrate Banner X Shoppable Banner Interaction Reporting](/integration/reference/integrate-banner-x-shoppable-banner-interaction-reporting.md)
* [Data overview](/integration/reference/data-overview-1.md)
* [Sync data via file protocols](/integration/reference/syncing-data-via-file-protocols-1.md)
* [Catalog & Products](/integration/reference/catalog-products-2.md)
* [Syncing catalog via API](/integration/reference/syncing-catalog-via-api.md)
* [Syncing products via API](/integration/reference/syncing-products-via-api.md)
* [Syncing catalog & products via file](/integration/reference/syncing-catalog-products-via-file.md)
* [Audience Targeting](/integration/reference/audience-targeting-new.md)
* [Option 1: Curated Unified Audiences](/integration/reference/option-1-curated-unified-audiences.md)
* [Option 2: Sync Customers & Audience](/integration/reference/integration-option-2-sync-customers-audience.md)
* [Option 3: Sync Audiences only](/integration/reference/integration-option-3-sync-audiences-only.md)
* [Order data](/integration/reference/order-data-1.md)
* [Syncing order data via API](/integration/reference/syncing-order-data-via-api.md)
* [Syncing order data via file](/integration/reference/syncing-order-data-via-file.md)

## FEATURE INTEGRATIONS

* [Location targeting](/integration/reference/location-targeting.md)
* [Pagination](/integration/reference/pagination.md)
* [Placement level product type blocking (HFSS support)](/integration/reference/placement-level-product-type-blocking-hfss-support.md)
* [Marketplace sellerId](/integration/reference/marketplace-sellerid.md)
* [Single Sign On for retailers](/integration/reference/single-sign-on.md)
* [Integrating Parent Products](/integration/reference/integrating-parent-products.md)
* [Suggested Keywords](/integration/reference/suggested-keywords.md)
* [Category Cross-sell](/integration/reference/category-cross-sell.md)
* [Difference Between Category and Category Cross-sell Placements](/integration/reference/difference-between-category-and-category-cross-sell-placements.md)
* [Integration requirements](/integration/reference/integration-requirements.md)
* [Digital Services Act](/integration/reference/digital-services-act.md)

## Generating ads

* [Product ads](/integration/reference/product-ads.md)
* [Requesting product ads](/integration/reference/requesting-product-ads-1.md)
* [Banner ads (static)](/integration/reference/banner-ads-static.md)
* [Requesting banner ads](/integration/reference/requesting-banner-ads.md)
* [Banner content standard](/integration/reference/banner-content-standard-1.md)
* [Banner X](/integration/reference/banner-x-responsive.md)
* [Content standards](/integration/reference/banner-x-content-standard-1.md)
* [Banner X previewer](/integration/reference/integrating-your-banner-x-previewer.md)
* [Banner X video ads](/integration/reference/video-ads-banner-x.md)
* [Banner X video captions](/integration/reference/bannerx-video-captions.md)
* [Companion products](/integration/reference/companion-products-banner-x.md)
* [Generate banner X ads for different placements](/integration/reference/requesting-banner-x-ads.md)
* [Frequently asked questions (FAQs)](/integration/reference/frequently-asked-questions-faqs.md)
* [Go live checklist](/integration/reference/go-live-checklist-1.md)
* [UAT tests](/integration/reference/uat-tests-1.md)

## Brand Pages

* [Brand Page Retailer Integration Guide](/integration/reference/brand-page-retailer-integration-guide.md)
* [Overview](/integration/reference/overview-1.md)
* [Prerequisites](/integration/reference/prerequisites.md)
* [Integration Architecture](/integration/reference/integration-architecture.md)
* [Authentication](/integration/reference/authentication-1.md)
* [Brand Page APIs](/integration/reference/brand-page-apis.md)
* [Module Capabilities](/integration/reference/module-capabilities.md)
* [Tracking & Attribution](/integration/reference/tracking-attribution.md)
* [Validation & Troubleshooting](/integration/reference/validation-troubleshooting.md)

## References

* [Audience targeting reference](/integration/reference/audience-targeting-reference.md)
* [Product ad reference](/integration/reference/product-ad-reference-1.md)
* [Banner ad (static) reference](/integration/reference/banner-ad-static-reference.md)
* [Banner X reference](/integration/reference/banner-x-reference-1.md)
* [Catalog products reference](/integration/reference/catalog-products-reference.md)
* [Order reference](/integration/reference/order-reference.md)

## Integration

* [Generate product and banner ads](/integration/reference/generate.md)
* [Generate banner X ads](/integration/reference/bannerx.md)
* [Report an order](/integration/reference/report-an-order.md)
* [Retrieve a list of orders](/integration/reference/retrieve-a-list-of-orders.md)
* [Retrieve an order](/integration/reference/retrieve-an-order.md)
* [Create or update a catalog](/integration/reference/create-or-update-a-catalog.md)
* [Create or update a product](/integration/reference/create-or-update-a-product.md)
* [Retrieve a list of products](/integration/reference/retrieve-a-list-of-products.md)
* [Retrieve a product](/integration/reference/retrieve-a-product.md)
* [Create or update a customer](/integration/reference/create-or-update-a-customer.md)
* [Retrieve a list of customers](/integration/reference/retrieve-a-list-of-customers.md)
* [Retrieve a customer](/integration/reference/retrieve-a-customer.md)
* [Manage customer-segment linkage](/integration/reference/manage-customers-and-segments.md)

## Citrus filter-mapping API

* [filterMapping](/integration/reference/filtermapping.md)
* [create filter mapping](/integration/reference/createfiltermapping-1.md)
* [get list of filter mappings](/integration/reference/listfiltermappings-1.md)
* [update a filter mapping](/integration/reference/updatefiltermapping-1.md)
* [get a filter mapping](/integration/reference/getfiltermapping-1.md)
* [delete a filter mapping](/integration/reference/deletefiltermapping-1.md)

## CrossSellCategory API

* [crossSellCategory](/integration/reference/crosssellcategory.md)
* [Lists all cross sell categories (based on params provided)](/integration/reference/listcrosssellcategories.md)
* [Create cross sell category](/integration/reference/createcrosssellcategory.md)
* [Get cross sell category for specified id](/integration/reference/getcrosssellcategory.md)
* [Delete cross sell category](/integration/reference/deletecrosssellcategory.md)

## REPORTING

* [Overview](/integration/reference/reporting-overview.md)
* [Schema Definitions](/integration/reference/reporting-schema-definitions.md)
* [Reference](/integration/reference/reporting-reference.md)
* [Frequently Asked Questions](/integration/reference/reporting-faq.md)