{"title":"Product Feed API Integration","category":"default","creationDate":1778252957,"content":"

The Adyen Product Feed API provides a way for you to communicate with our centralized product knowledge hub that synchronizes your inventory with AI platforms. It operates on an asynchronous batch processing model to perform \"semantic mapping\" between your inventory data and industry-standard Agentic Commerce protocols. You can upload batches of information about your inventory to Adyen, and we will synchronize it with AI platforms.<\/p>\n

Requirements<\/h2>\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nAn existing online payments<\/a> integration.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

How it works<\/h2>\n

The Product Feed API enables you to synchronize your product catalog with AI platforms through Adyen's centralized product knowledge hub. Here's how it works:<\/p>\n

    \n
  1. Batch Ingestion<\/strong>: You upload product data in batches of up to 200 items. Each item declares its target platforms via a platforms<\/code> array.<\/li>\n
  2. Semantic Mapping<\/strong>: Adyen processes your data and maps it to industry-standard Agentic Commerce protocols.<\/li>\n
  3. AI Platform Synchronization<\/strong>: The mapped data is synchronized with AI platforms like OpenAI and Meta. A single item can target multiple platforms in one request.<\/li>\n
  4. Asynchronous Processing<\/strong>: The API operates asynchronously, so you can check ingestion status later.<\/li>\n<\/ol>\n

    API Architecture & Operations<\/h2>\n

    The API focuses on high-efficiency batch ingestion rather than individual item management. A single ingestion item can be fanned out to multiple AI platforms in a single request via the per-item platforms<\/code> array.<\/p>\n

    Base URL:<\/p>\n\n\n\n\n\n\n
    Environment<\/th>\nURL<\/th>\n<\/tr>\n<\/thead>\n
    Test<\/td>\nhttps:\/\/commerce-suite-test.adyen.com\/commerce-suite\/productFeed<\/code><\/td>\n<\/tr>\n
    Live<\/td>\nhttps:\/\/commerce-suite.adyen.com\/commerce-suite\/productFeed<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Core Endpoints<\/h3>\n\n\n\n\n\n\n\n
    Method<\/th>\nPath<\/th>\nSummary<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    POST<\/strong><\/td>\n\/v1\/ingestions<\/code><\/td>\nIngest a product feed<\/td>\nIngests a list of up to 200 items<\/strong> for asynchronous processing to OpenAI and\/or Meta. Each item declares its target platforms via platforms<\/code>. Products omitted from the request remain unchanged.<\/td>\n<\/tr>\n
    DELETE<\/strong><\/td>\n\/v1\/ingestions<\/code><\/td>\nDelete products<\/td>\nDeletes up to 200 products<\/strong> from one or more AI platforms (Meta, OpenAI) in a single call.<\/td>\n<\/tr>\n
    GET<\/strong><\/td>\n\/v1\/ingestions\/{ingestionId}<\/code><\/td>\nGet product ingestion status<\/td>\nRetrieves the processing state (Pending, Processing, ProcessingOnPlatform, Succeeded, Failed, Processed) per platform, along with a summary of success\/failure\/pending\/processing counts and per-product errors.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Authentication<\/h3>\n

    Secure your requests using one of the following methods:<\/p>\n