# Recommendations Feed API

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /{orgName}/projects/{projectName}/feeds/{id}/data:
    post:
      summary: Recommendations Feed API
      deprecated: false
      description: "The Recommendations Feed API returns a ranked list of products from an Intempt feed (Recommendation Feed) such as Most Popular, Recently Viewed, Purchased Together, Image Similarity, or other personalized recommendation strategies.\n\nUse this endpoint when you want to:\n\t•\tFetch products for a specific feed (/{id}/data)\n\t•\tGet personalized recommendations using a user/profile identifier (type + id)\n\t•\tAdd product context for product-based feeds (using productId)\n\t•\tControl pagination using offset + limit\n\t•\tReturn only the fields you need using fields[] (for lighter payloads and faster rendering)\n\nHow identification works\n\t•\tIf type is USER → id should be your userId\n\t•\tIf type is PROFILE → id should be the profileId, and sourceId must also be provided\n\nResponse\n\t•\tReturns { \"products\": [...] } where each product object contains only the properties you requested in fields."
      operationId: post_{orgName}projects{projectName}feeds{id}data
      tags: []
      parameters:
        - name: orgName
          in: path
          description: Organization name
          required: true
          example: ''
          schema:
            type: string
            default: demo-organization
        - name: projectName
          in: path
          description: Name of a project
          required: true
          example: ''
          schema:
            type: string
            default: demo-project
        - name: id
          in: path
          description: Product feed id
          required: true
          example: ''
          schema:
            type: string
            default: '1002'
        - name: apiKey
          in: query
          description: Intempt api key
          required: false
          schema:
            type: string
            default: identifier.secret
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                  description: >-
                    Unique identifiers that depend on the profile type. Used by
                    feeds that require user-specific input, such as Recently
                    Viewed, User Affinity, and other personalized recommendation
                    features
                  default: ''
                type:
                  type: string
                  description: >-
                    Specifies whether the identifier represents a User or a
                    Profile. The corresponding ID value must match the selected
                    type: a User ID when set to USER, or a Profile ID when set
                    to PROFILE
                  default: ''
                  enum:
                    - USER
                    - PROFILE
                productId:
                  type: string
                  default: ''
                  description: >-
                    Identifier of the product used in feeds that require product
                    context, such as Image Similarity or Purchased Together
                offset:
                  type: number
                  default: '0'
                  description: >-
                    Specifies the index position from which the feed begins
                    returning elements. A value of 0 starts from the first
                    ranked product; higher values skip the preceding products
                limit:
                  type: number
                  default: '3'
                  description: >-
                    Specifies the maximum number of products to display. The
                    default value is 3
                fields:
                  type: array
                  items:
                    type: string
                  default: ''
                  description: >-
                    An array of field names to include in the response payload.
                    Examples: id, price, description, title, url
              x-apidog-orders:
                - id
                - type
                - productId
                - offset
                - limit
                - fields
            example:
              type: USER
              id: user_jtalemkw_5928174630519_zamrittoQ7
              sourceId: '4829375106281943752'
              fields:
                - id
                - price
                - link
                - updatedAt
              productId: '1234'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  products:
                    type: array
                    items:
                      type: string
                      format: json
                    description: >-
                      An array of product objects containing the specified
                      properties
                    default: ''
                required:
                  - products
                x-apidog-orders:
                  - products
              example:
                products:
                  - id: '4821'
                    price: 51.04
                    link: https://example.com/item/alpha-4921
                    updatedAt: Nov 25, 2025 11:43 AM
                  - id: '9375'
                    price: 369.05
                    link: https://example.com/item/beta-9375
                    updatedAt: Nov 25, 2025 11:43 AM
                  - id: '6142'
                    price: 275.92
                    link: https://example.com/item/gamma-6142
                    updatedAt: Nov 25, 2025 11:30 AM
          headers: {}
          x-apidog-name: OK
      security: []
      x-apidog-folder: ''
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1137771/apis/api-24815718-run
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []

```