Intempt
  1. API Reference
Intempt
  • Installation
    • Basic Intempt Installation
    • Create source
    • Google Tag Manager
    • Environment Setup
    • Validating Installation
  • SDK
    • JS SDK
    • Android SDK
    • iOS SDK
    • Node.js SDK
  • API Reference
    • Track data
      POST
    • Consent
      POST
    • Choose API
      POST
    • Recommendations Feed API
      POST
  • Data Ingestion & Tracking
    • intempt:html / intempt:page / intempt:session
    • Product Catalog Ingestion via API
    • How Intempt Works — A One-Page Mental Model
    • Revenue & Refund Tracking
    • Recommendation events mapping
    • Track Events API (Recommendations)
  • Data Models & Event Schema
    • Event Schema Overview
  • Webhooks
    • All about Webhooks
  • Server Side Experiments
    • Overview
  1. API Reference

Recommendations Feed API

POST
/{orgName}/projects/{projectName}/feeds/{id}/data
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.
Use this endpoint when you want to:
• Fetch products for a specific feed (/{id}/data)
• Get personalized recommendations using a user/profile identifier (type + id)
• Add product context for product-based feeds (using productId)
• Control pagination using offset + limit
• Return only the fields you need using fields[] (for lighter payloads and faster rendering)
How identification works
• If type is USER → id should be your userId
• If type is PROFILE → id should be the profileId, and sourceId must also be provided
Response
• Returns { "products": [...] } where each product object contains only the properties you requested in fields.

Request

Path Params

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '//projects//feeds//data?apiKey' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "PROFILE",
    "id": "prof_jtalemkw_5928174630519_zamrittoQ7",
    "sourceId": "4829375106281943752",
    "fields": ["id", "price", "link", "updatedAt"],
    "productId": "1234"
}'
Response Response 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"
        }
    ]
}
Modified at 2026-01-27 13:35:31
Previous
Choose API
Next
intempt:html / intempt:page / intempt:session
Built with