> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pureclarity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit a product feed URL

> Submit a URL where PureClarity can download a full JSON product feed.
The feed is processed asynchronously, so the URL must remain accessible
for at least 24 hours after submission.




## OpenAPI

````yaml /integrations/custom/api-reference/openapi.yaml post /api/productfeed
openapi: 3.0.3
info:
  title: PureClarity Capture API
  description: >
    The PureClarity Capture API provides endpoints for server-side integration
    with the PureClarity

    personalization platform. Use these endpoints to submit tracking events,
    retrieve personalized

    recommendations, manage product data feeds, and handle GDPR compliance.


    ## Authentication


    All endpoints require your **Access Key** (`appKey` / `appId` / `AccessKey`)
    to identify your store.

    Server-side endpoints also require a **Secret Key** (`secretKey` /
    `SecretKey`) for authentication.


    You can find both keys in the PureClarity Admin console under **My Account >
    Integrations**.


    <Warning>Never expose your Secret Key in client-side code or public
    repositories.</Warning>


    ## Regional Endpoints


    PureClarity operates in two regions. Use the base URL for the region your
    account is provisioned in:


    | Region | Base URL |

    |--------|----------|

    | EU (Ireland) | `https://api-eu-w-1.pureclarity.net` |

    | US (Virginia) | `https://api-us-e-1.pureclarity.net` |


    For data feed operations via SFTP streaming, use the SFTP regional endpoints
    on port 443:


    | Region | SFTP Base URL |

    |--------|---------------|

    | EU (Ireland) | `https://sftp-eu-w-1.pureclarity.net` |

    | US (Virginia) | `https://sftp-us-e-1.pureclarity.net` |
  version: 1.0.0
  contact:
    name: PureClarity Support
    email: support@pureclarity.com
    url: https://pureclarity.com
  license:
    name: Proprietary
servers:
  - url: https://api-eu-w-1.pureclarity.net
    description: EU Region (Ireland)
  - url: https://api-us-e-1.pureclarity.net
    description: US Region (Virginia)
security: []
tags:
  - name: Server-side
    description: Server-side personalization and event tracking
  - name: Data Feeds
    description: Product, category, brand, and user data feed management
  - name: GDPR
    description: GDPR compliance endpoints for user data management
paths:
  /api/productfeed:
    post:
      tags:
        - Data Feeds
      summary: Submit a product feed URL
      description: |
        Submit a URL where PureClarity can download a full JSON product feed.
        The feed is processed asynchronously, so the URL must remain accessible
        for at least 24 hours after submission.
      operationId: submitProductFeed
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductFeedRequest'
            example:
              appKey: your-access-key
              secretKey: your-secret-key
              url: https://yourdomain.com/feeds/pureclarity-products.json
      responses:
        '200':
          description: Feed submission accepted
          content:
            text/plain:
              schema:
                type: string
                example: The request was submitted successfully
        '400':
          description: Validation error or invalid access key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedErrorResponse'
components:
  schemas:
    ProductFeedRequest:
      type: object
      required:
        - appKey
        - secretKey
        - url
      properties:
        appKey:
          type: string
          description: Your store's unique access key
        secretKey:
          type: string
          description: Your store's secret key
        url:
          type: string
          format: uri
          description: |
            URL where PureClarity can download the full JSON feed.
            The feed must remain accessible for at least 24 hours.
    FeedErrorResponse:
      type: object
      properties:
        Error:
          type: string
          description: Error message describing what went wrong

````