Flipkart Affiliate API: Authentication & Product Feeds

Ryan
Ryan
IP Proxy Research Team

The Flipkart Affiliate API can provide registered affiliates with structured product, price, availability, seller, offer, and tracking-link data. The public documentation is still accessible, but it is old enough that you should verify API access in your Affiliate account before building a new integration.

Direct Answer

Use the Flipkart Affiliate API when you have an eligible Affiliate account and need approved product or offer data for affiliate use cases. Authentication uses an Affiliate Tracking ID and private API token sent in the Fk-Affiliate-Id and Fk-Affiliate-Token HTTPS headers. Start with the Product Feed Listing API, follow the current feed URLs returned by Flipkart, and avoid hardcoding signed feed URLs because they expire.

Key Takeaways
  • Affiliate API access requires a registered Affiliate account, an Affiliate Tracking ID, and a private API token.
  • Flipkart documents only one active Affiliate API token per affiliate account; generating a new token disables the previous one.
  • The Product Feed Listing API returns category-specific feed URLs and available API variants.
  • Product feeds can include price, special price, stock state, product URL, seller data, shipping information, and product attributes.
  • Feed URLs can expire, so integrations should follow the current URLs returned by the API rather than copying old sample URLs.
  • Flipkart's public Affiliate API release notes were last updated in 2016, so confirm current account access and supported endpoints before depending on the API in production.

What Is the Flipkart Affiliate API?

Flipkart describes its Affiliate APIs as interfaces for registered Affiliate Program users to access relevant product and offer information across actively marketed categories. The documented use cases include custom websites, shopping-comparison experiences, mobile applications, and niche content.

Flipkart Affiliate Program interface showing affiliate tools and API navigation
Figure 1: An archived Flipkart Affiliate Program interface showing the program navigation and affiliate tools. Source: Hyyzo.

The Affiliate API is separate from Flipkart Marketplace Seller APIs. Affiliate APIs are designed around affiliate product, offer, and reporting workflows, while Seller APIs support eligible marketplace seller operations. If the main question is which data source fits a particular workflow, see IPWeb's Flipkart API vs Scraper API comparison.

Check Access Before You Integrate

The public Affiliate API documentation remains available, but its release notes state that the developer guide was created in January 2016 and last updated on July 27, 2016. The same release notes mark unversioned Product Feed, Delta Feed, keyword search, and product-ID search endpoints as deprecated in favor of versioned APIs.

That makes an account-level check important before implementation. Do not assume that every endpoint or example URL in an old documentation page is currently enabled for a new account.

Pre-Integration Checklist
  • Confirm that your Flipkart Affiliate account is active and eligible for API access.
  • Open the Affiliate dashboard and verify that API Token and API Status options are available.
  • Generate or confirm the current Affiliate API token.
  • Use the API directory or feed URLs returned for your own Tracking ID instead of copying a sample user's URL.
  • Prefer the documented versioned feed variant when the directory provides both old and newer variants.
  • Review the current Affiliate API Terms of Use before putting the integration into production.
Flipkart Affiliate dashboard showing API reports downloads and affiliate link generator
Figure 2: An archived Flipkart Affiliate dashboard showing API, reports, downloads, and link-generation tools. Source: Hyyzo.

Flipkart's Affiliate API release notes and API Terms of Use are the best starting points for checking these boundaries.

How Flipkart Affiliate API Authentication Works

Registered affiliates authenticate requests with two HTTPS headers:

Table 1: Authentication headers documented for Flipkart Affiliate API requests.
HeaderValuePurpose
Fk-Affiliate-IdYour Affiliate Tracking IDIdentifies the affiliate account making the request
Fk-Affiliate-TokenYour private Affiliate API tokenAuthenticates API access

Table takeaway: Both the Tracking ID and private API token are required for authenticated Affiliate API requests.

Flipkart documents one API token per affiliate account. Generating another token disables the old one, so token rotation should be coordinated with any application already using the previous credential.

Minimal cURL Request

The Product Feed Listing API is a useful first call because it returns the categories and feed links available for your Tracking ID.

curl \
  -H "Fk-Affiliate-Id: $FLIPKART_AFFILIATE_ID" \
  -H "Fk-Affiliate-Token: $FLIPKART_AFFILIATE_TOKEN" \
  "https://affiliate-api.flipkart.net/affiliate/api/$FLIPKART_AFFILIATE_ID.json"

Keep the token on the server side or in a secret-management system. Do not expose it in browser JavaScript, public repositories, screenshots, or client-side configuration.

Minimal Python Request

import os
import requests

affiliate_id = os.environ["FLIPKART_AFFILIATE_ID"]
affiliate_token = os.environ["FLIPKART_AFFILIATE_TOKEN"]

url = (
    "https://affiliate-api.flipkart.net/affiliate/api/"
    f"{affiliate_id}.json"
)

headers = {
    "Fk-Affiliate-Id": affiliate_id,
    "Fk-Affiliate-Token": affiliate_token,
}

response = requests.get(url, headers=headers, timeout=30)
response.raise_for_status()

directory = response.json()
print(directory["title"])

The example intentionally requests the API directory first. Category feed URLs can contain signatures and expiry values, so the safer pattern is to discover the current URL from the directory response instead of hardcoding an old signed URL from documentation.

How to Get Product Feed URLs

The Product Feed Listing API returns a directory of catalogue categories. Each category can include links for a full product feed, a delta feed, and available API variants.

Official Flipkart Affiliate Tools illustration showing product content embedded on a website
Figure 3: Flipkart Affiliate tools can support product content presented on an affiliate website or application. Source: Flipkart Affiliate Program.
  1. Authenticate to the Product Feed Listing API with your Tracking ID and API token.
  2. Read the returned apiListings object.
  3. Select the category you need.
  4. Inspect its availableVariants.
  5. Use the current get URL returned for the supported version.
  6. Follow nextUrl for additional batches when the feed contains more products.

Flipkart's documentation says the API URLs are valid for a limited period and that each Product Feed API response contains up to 500 items. This is another reason not to store a signed feed URL as if it were a permanent endpoint.

The official Product APIs reference documents the Product Feed Listing API, Product Feed API, Delta Feed API, product search interfaces, and feed downloads.

Important Product Feed Fields

The versioned Product Feed documentation exposes more than a single current price. Depending on the category and response, the record can include product identity, multiple price fields, stock state, product URL, seller information, shipping data, and category-specific attributes.

Table 2: Useful fields in the documented versioned Flipkart Affiliate Product Feed.
FieldMeaningValidation note
productIdUnique Flipkart product identifierKeep it with every stored observation
titleProduct titleUseful for display, but do not use title alone as identity
maximumRetailPriceMaximum retail priceDo not confuse MRP with the active selling price
flipkartSellingPriceDocumented selling price after discountStore the amount and currency together
flipkartSpecialPriceDocumented special price after additional offers, when applicableKeep offer context when comparing prices
productUrlProduct URL associated with affiliate trackingPreserve the generated tracking parameters
inStockStock stateA price without availability can create a misleading comparison
sellerNameSeller nameSeller changes can explain price changes
shippingChargesShipping charge informationConsider total cost, not price alone
productFamilyRelated product variantsUseful for avoiding variant mismatches

Table takeaway: A useful affiliate product record should preserve product identity, price type, seller, stock state, variant context, and timestamp rather than storing only one numeric price.

Official Flipkart Affiliate search widget displaying product names and prices
Figure 4: Flipkart's Affiliate Search Widget is an example of product information being presented to users. Source: Flipkart Affiliate Program.

Pagination and Delta Feeds

Flipkart documents a batch size of 500 products for Product Feed API calls. When more records are available, the response includes a nextUrl that can be followed to retrieve the next batch.

For update-oriented workflows, the Delta Feed API is designed to return products that changed after a particular category version. The documented changes can include products that were added, updated, or deleted. Deleted products can appear with isAvailable set to false.

A practical ingestion process therefore separates three jobs:

  • initial category discovery through the Product Feed Listing API;
  • full or paginated Product Feed ingestion for a baseline dataset;
  • Delta Feed checks for later changes when the current account and endpoint support them.

Do not modify signed expiry or sig values on a feed URL. Refresh the directory or feed link when it expires instead.

Offers API

The Affiliate documentation also includes Offer APIs. The documented All Offer API can return active offers with fields such as title, description, URL, category, start and end times, image URLs, and availability. A Deals of the Day interface is documented separately.

These offer records should be kept separate from the core product-price fields. A temporary promotional offer can change the effective price without changing the product's underlying MRP or standard selling-price field.

See Flipkart's Offer APIs reference for the documented request and response fields.

Common Response Codes

Authentication problems, expired URLs, bad request parameters, and server failures should be handled as different states instead of being collapsed into a generic “no data” result.

Table 3: Common response codes listed in the Flipkart Affiliate API documentation.
CodeDocumented meaningWhat to check
200Successful callValidate the response body before storing it
202Request being processedDo not treat it as a completed dataset
400Bad requestReview parameters and URL format
401UnauthorizedCheck the API token and Affiliate Tracking ID
403Forbidden / tampered URLUse an untouched current URL returned by the API
404Not foundConfirm the requested resource or endpoint
410URL expiredRefresh the feed URL instead of retrying the expired URL indefinitely
500 / 503Server error / service unavailableRetry with bounded backoff and preserve the error state
599Connection timed outRetry safely and distinguish timeout from an empty feed

Table takeaway: A 401, 403, 410, or 5xx response describes a request or service state, not a product becoming unavailable.

Affiliate API vs Seller API vs Scraper API

These data sources solve different problems and should not be treated as interchangeable.

Table 4: Flipkart Affiliate API compared with Seller API and public-page data workflows.
SourceBest fitAccess modelMain boundary
Affiliate APIApproved affiliate product, offer, and reporting workflowsAffiliate Tracking ID + API tokenFields and access depend on the Affiliate Program and documented APIs
Marketplace Seller APIEligible seller marketplace operationsRegistered seller/partner application authorizationNot a general public product-price database
Third-party data APINormalized external product observationsVendor-specificRequires source, freshness, and compliance validation
Public-page scraper workflowPermitted page-state validationPage access rather than Affiliate authenticationMust respect source rules and handle layout or page-state changes

Table takeaway: Use the Affiliate API for eligible affiliate workflows; choose another source only when the job falls outside that access model and the alternative is permitted.

For a deeper decision framework, use the Flipkart API vs Scraper API guide.

If a permitted public-page validation workflow also needs location-specific routing, dynamic residential proxies can support regional product-page and availability checks across selected locations.

Using Affiliate Data for Price Tracking

An Affiliate Product Feed can provide price-related fields, but a current feed response is not automatically a price-history database. Historical tracking requires storing comparable observations over time.

For each observation, keep at least the product ID, relevant variant attributes, price type, seller when available, stock state, currency, source URL, and collection timestamp. If the record changes, compare like with like before calling it a price drop.

For quick browser-based price checks rather than a structured feed integration, see the Flipkart Price Tracker Extension guide to compare extension-based history checks, alerts, and validation steps.

This is the same distinction behind IPWeb's Flipkart price tracker guide: a price graph is useful only when the observations are comparable. For a broader multi-product monitoring design, see the e-commerce price tracking API guide.

Official Flipkart Affiliate reports dashboard showing earnings orders and traffic
Figure 5: Flipkart Affiliate reporting tracks metrics such as earnings, orders, and traffic separately from raw product-feed data. Source: Flipkart Affiliate Program.

Frequently Asked Questions

Does Flipkart still have Affiliate API documentation?
Yes. Flipkart's public Affiliate API documentation is still accessible, including registration, Product Feed, Offer, reporting, error-code, and Terms of Use pages. However, the public release notes show a last update in July 2016, so confirm current API access and supported endpoints in your Affiliate account before building a production integration.
How do I authenticate to the Flipkart Affiliate API?
The documentation uses two HTTPS headers: Fk-Affiliate-Id for the Affiliate Tracking ID and Fk-Affiliate-Token for the private API token. The account must be eligible for Affiliate API access.
Can I hardcode a Flipkart Product Feed URL?
Do not treat signed feed URLs as permanent. Flipkart documents limited validity for API URLs, and expired URLs can return HTTP 410. Retrieve the current feed URL through the API directory and refresh it when necessary.
How many products does a Product Feed request return?
Flipkart's public documentation states a batch size of 500 products per Product Feed API call. Use the returned nextUrl to continue through additional batches.
Does the Affiliate API include Flipkart price data?
The versioned Product Feed documentation includes fields such as maximum retail price, selling price, special price, stock state, seller information, shipping charges, and product attributes. The exact fields available should be verified against the current response for your category and account.
Is the Flipkart Affiliate API the same as the Seller API?
No. The Affiliate API supports eligible affiliate product, offer, and reporting workflows. Marketplace Seller APIs use a different authorization model and are designed for eligible seller or partner operations.
Can I build a Flipkart price-history chart from the Affiliate API?
A feed can supply price observations, but historical charts require you to store timestamped, comparable records over time. Preserve product identity, variant, seller, stock state, price type, and currency so changes are not misclassified.

Final Thoughts

The Flipkart Affiliate API is most useful when an eligible affiliate needs structured product or offer data through an approved interface. Start by confirming current account access, authenticate with the Tracking ID and private token, discover current feed URLs from the API directory, and store enough product context to validate every downstream comparison. Because the public documentation is old and some legacy endpoints are explicitly deprecated, build around current account responses rather than old sample URLs.

About the author
View all articles
Ryan
Ryan
IP Proxy Research Team

Ryan is a web data and proxy infrastructure specialist focused on IP networks, scraping systems, SERP APIs, and global data access solutions. He shares practical insights on proxy usage, data collection architecture, and scalable web intelligence systems.

Service areas
Proxy IP Web Scraping & Data Infrastructure Specialist

You may be interested in

Gemini API available regions and runtime region access checks

Is the Gemini API Available in My Region? How to Check

Gemini API regional availability should be checked from the environment that actually sends the request. A developer can be physically located in a supported country while a Colab instance, cloud VM, CI runner, remote notebook, or production service runs somewhere else. Google explicitly documents this distinction for Colab, where region restrictions are based on the Colab instance region rather than the user's region. Quick Answer Check Google's current Gemini API and Google AI Studio available-regions page before changing SDK code. For Colab, Google says the relevant location is the Colab instance region and provides !curl ipinfo.io as a way to...

Marcus

Marcus

Proxy Network Analyst

Wayback Machine API cover showing archived web pages, a historical timeline, and API response data

How to Use the Wayback Machine API for Archived Web Data

The Wayback Machine can help verify how a public page looked at an earlier point in time, but clicking through the calendar is slow when you need repeatable checks. The more practical approach is to query capture metadata first, narrow the result set, and then open the archived snapshot that matches the time window you need. For most archive-data work, the Wayback CDX Server API is the main interface because it can return multiple captures and filter them by date, status code, MIME type, and other fields. The simpler Availability API is useful when you only need a quick answer...

Ryan

Ryan

IP Proxy Research Team

OpenAI API Access Denied cover showing API key project and permission checks

Why Is OpenAI API Access Denied?

OpenAI API access denied errors usually point to a specific access layer: an invalid or stale API key, the wrong project or organization context, missing project or model permissions, an endpoint mismatch, an unsupported region, IP allowlisting, or a server-side network problem. The fastest way to diagnose the failure is to capture the exact HTTP status and error body before changing credentials or application settings. Do not treat every 401 or 403 as the same problem. A browser message may come from your own frontend or backend, while a server-side OpenAI API response can contain a specific error type, code,...

Marcus

Marcus

Proxy Network Analyst

Ready to scale your data operations?
Join 10,000+ teams using IPWeb to power their web data collection. Start free today.

Strictly anti-abuse

Fraud, automated operation, and unauthorized use are prohibited.

Enterprise-level services

For legitimate commercial and technical use cases only

Risk control and restrictions

Abnormal behavior may trigger service restrictions or termination.

Compliance data use

Data acquisition and use must comply with relevant regulations.

Privacy protection first

The collection or misuse of sensitive personal information is strictly prohibited.

All services are subject to《the Usage Policy》