> 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](broken://pages/AGjF4Hd97mwHJXYPvrAJ)
* [What ads can Epsilon Retail Media serve?](broken://pages/7bruejL6fW1Db9FhmGSe)
* [Epsilon API Terms of Use](broken://pages/EzX0oXf9g0OjzyEJW1Ro)
* [Acceptable Use Policy](broken://pages/eZ92VghfWvUhg3QBs4Fp)

## Data & API

* [API overview](broken://pages/S4FDf9KCSPZnHdq8wnlA)
* [Ad Integration Workflow Options for Retailers](broken://pages/yWudiwyU3wY4JNZiuFLc)
* [Before you start](broken://pages/sOAUiWPzM06l7eV57uO4)
* [HTTP persistence & endpoints](broken://pages/aHtZ3BhjtpCrtpI6lc1k)
* [Reporting Impressions and Clicks](broken://pages/FytKMZ8etMd1bbhHOUQi)
* [Ad generation filtering](broken://pages/YjTaI3SxlrgKVXe5ma4l)
* [Timeouts and graceful fallback behaviour](broken://pages/dHryinIZmJwkUZlT630d)
* [OAuth 2.0 Authentication](broken://pages/GjON0OcWIQ5WFDte2gtS)
* [Ad Interaction Events Reporting](broken://pages/QatWxiT2lpFqdH9UsF2Y)
* [Integrate Banner X Video Interaction Reporting](broken://pages/yVuxHZhOq8hBlXCtmyEY)
* [Integrate Banner X Shoppable Banner Interaction Reporting](broken://pages/RbOYknKbv7WRIDikRpXD)
* [Data overview](broken://pages/XGMW8hXRf1x75Wl7w4ED)
* [Sync data via file protocols](broken://pages/u7QA5WnIzFFVNqWvMed1)
* [Catalog & Products](broken://pages/ylwYcc2c5TeY22j7pbsT)
* [Syncing catalog via API](broken://pages/dN3MSFSdsg8UsalUDF7U)
* [Syncing products via API](broken://pages/G8UzCbIhhIH9rxIzHqDR)
* [Syncing catalog & products via file](broken://pages/eXANBCQiJ4hpKIXxsmDk)
* [Audience Targeting](broken://pages/7wg61mYolccce2Qeknc8)
* [Option 1: Curated Unified Audiences](broken://pages/VOiHNC4YkdASPIUpdS7e)
* [Option 2: Sync Customers & Audience](broken://pages/N6KeBpqTo9qS9AkCa1Dg)
* [Option 3: Sync Audiences only](broken://pages/7WBHWiQCxh3SfO5RFf2x)
* [Order data](broken://pages/tJxcoprPu7i88Krb7i8D)
* [Syncing order data via API](broken://pages/MJ8vL9agp9yjMRqJee0k)
* [Syncing order data via file](broken://pages/9PGfSitQGiFNhpdJvINp)

## FEATURE INTEGRATIONS

* [Location targeting](broken://pages/mEzZ8aZZhMV2RiGZ1XZR)
* [Pagination](broken://pages/bOZ2XlrTpGuBkqsEKktc)
* [Placement level product type blocking (HFSS support)](broken://pages/vzU85vMQ0kz1Gkm0frhb)
* [Marketplace sellerId](broken://pages/bTzeSPgsOLDrgmgCBy7t)
* [Single Sign On for retailers](broken://pages/z0Eds09GPOkTJmxBgWiU)
* [Integrating Parent Products](broken://pages/od811kjE8cPAtRwnVyt6)
* [Suggested Keywords](broken://pages/gKlJfIUDtYv90X3ULh1X)
* [Category Cross-sell](broken://pages/i1VQM6w2LZFcD7ORWMji)
* [Difference Between Category and Category Cross-sell Placements](broken://pages/jytbYpFSX40XhiDy1v0V)
* [Integration requirements](broken://pages/oKfkhT4H9s7dBoRqACI8)
* [Digital Services Act](broken://pages/eZWsf7SDpnqpFYGcNw8U)

## Generating ads

* [Product ads](broken://pages/tT2Kr4uMgKS8A7rQyv7M)
* [Requesting product ads](broken://pages/IRErXK7GTKkYylAHuWrX)
* [Banner ads (static)](broken://pages/iYOxKiFvw5OACuBqcVII)
* [Requesting banner ads](broken://pages/UTHmYJizrNyqenjq7JQE)
* [Banner content standard](broken://pages/rUrcFQyohVjodaSsP0gm)
* [Banner X](broken://pages/TwBfb7p26Zq4XHy8Hnn4)
* [Content standards](broken://pages/55lzq0RLadC1cSZO1FH4)
* [Banner X previewer](broken://pages/QH10LDAWXNfkIEBEIH8Q)
* [Banner X video ads](broken://pages/NOtpk0HIaIZ2yj2Dnh20)
* [Banner X video captions](broken://pages/eGTLe9PMbiuiDCGZOzFz)
* [Companion products](broken://pages/fiEiGsjN1VfO8TuC2UcI)
* [Generate banner X ads for different placements](broken://pages/EgcqhYmT2rF7nqA3b9cg)
* [Frequently asked questions (FAQs)](broken://pages/jUewV3LOmd9CNfc93hlG)
* [Go live checklist](broken://pages/pqEYU7EXL9sPHvvw962s)
* [UAT tests](broken://pages/GkVJrzJhSXhXdVJD68X7)

## Brand Pages

* [Brand Page Retailer Integration Guide](broken://pages/x6kjLWdlAo8pVsBBFjXT)
* [Overview](broken://pages/2AA5zWdiOjYNNSJyLg9B)
* [Prerequisites](broken://pages/1NIgwZz0NOTFWlCGpipL)
* [Integration Architecture](broken://pages/om1xulbUzGFlWJryo1Py)
* [Authentication](broken://pages/nQdJB0ENclw7Fjmrn9oz)
* [Brand Page APIs](broken://pages/OkllqQ8ywGeP6cneY08m)
* [Module Capabilities](broken://pages/qUZ4fgOkozw7jizWWn70)
* [Tracking & Attribution](broken://pages/QVxVO5jxLsfg1kryrvvx)
* [Validation & Troubleshooting](broken://pages/XXhw8inxeg1L5lpRgEJs)

## References

* [Audience targeting reference](broken://pages/NF5VEuK0PULIlMxGUWHr)
* [Product ad reference](broken://pages/JpWb9NFsJ8M8lL7AK9HN)
* [Banner ad (static) reference](broken://pages/D2SGBjvBykkOKe9f1slq)
* [Banner X reference](broken://pages/EPA8EPq2eeCrUcU6s1x1)
* [Catalog products reference](broken://pages/lhN38vle5oiDaNrTKAYI)
* [Order reference](broken://pages/G3gzGpFEadylH8ERKepF)

## Integration

* [Generate product and banner ads](broken://pages/XGLlJh1cm63SA8aIqxHj)
* [Generate banner X ads](broken://pages/cZBEa1DKtYU05dnJVdF0)
* [Report an order](broken://pages/QAlBy3N5fp4j2rikSMQV)
* [Retrieve a list of orders](broken://pages/k9MhStRX07bpkYh3wU5C)
* [Retrieve an order](broken://pages/Uucur8b7KEv3vYosNGqh)
* [Create or update a catalog](broken://pages/keoYKYGai4k6iOMMTCa5)
* [Create or update a product](broken://pages/KiW5TzoAXH1bzMLyBclm)
* [Retrieve a list of products](broken://pages/lmkk6V3vUUHfd3LEALr0)
* [Retrieve a product](broken://pages/3DrQNRMWVNcNYwwm5eOg)
* [Create or update a customer](broken://pages/qcvHivWwWtzycI8lKvvE)
* [Retrieve a list of customers](broken://pages/JT5NvbQAfFr99l0dqqTX)
* [Retrieve a customer](broken://pages/JWhtKXz2C84KuHc409E4)
* [Manage customer-segment linkage](broken://pages/5QxWOwFWHnvgMTLHmWpX)

## Citrus filter-mapping API

* [filterMapping](broken://pages/rQvbw3frDY3HnxkOoiW6)
* [create filter mapping](broken://pages/aDYOTax9XMi2b8la6Rx8)
* [get list of filter mappings](broken://pages/osxkUg6srxPYdMPbkhqL)
* [update a filter mapping](broken://pages/fezW9VDICkaTvSw1hBsO)
* [get a filter mapping](broken://pages/VAhC3K5r7ZyzreczuxLx)
* [delete a filter mapping](broken://pages/cHvgdiY0gHbjAII0Z1YU)

## CrossSellCategory API

* [crossSellCategory](broken://pages/No0snbPtb6GzgyLb257c)
* [Lists all cross sell categories (based on params provided)](broken://pages/i0u9arNQAndn5K8msTSA)
* [Create cross sell category](broken://pages/CLy43tYi6sQX9mZjUZ5G)
* [Get cross sell category for specified id](broken://pages/Q47KiZYfEBaSMN5PH8c4)
* [Delete cross sell category](broken://pages/iv4nSwMxPw4NuasIyG9s)

## REPORTING

* [Overview](broken://pages/4AtuRNkC3WgTwANlBcjf)
* [Schema Definitions](broken://pages/femYwnopZPPXvcoxWXzn)
* [Reference](broken://pages/ljoiH2lPNgiZeF2gxsTe)
* [Frequently Asked Questions](broken://pages/FGxCUePp3fxykC3Bt44b)
