The Create an offer API from Takealot — 2 operation(s) for create an offer.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/takealot-create-an-offer-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Takealot Seller Create an offer API
description: The Takealot Seller API for Offers represents the initial phase of the Seller API.
version: '2.0'
servers:
- url: https://seller-api.takealot.com/
tags:
- name: Create an offer
paths:
/v2/offers/offer/{identifier}:
post:
operationId: create_offer_by_identifier_v2
description: Create an offer by providing the variant's Barcode
summary: Create An Offer (v2)
parameters:
- name: identifier
in: path
description: The Barcode for the variant to create an offer against. It is not required to prepend BARCODE.
required: true
schema:
type: string
tags:
- Create an offer
responses:
'200':
description: OK
headers:
x-RateLimit-Limit:
schema:
type: integer
x-RateLimit-Remaining:
schema:
type: integer
x-RateLimit-Reset:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/V2OfferUpdateSuccessResponse'
text/csv:
schema:
$ref: '#/components/schemas/V2OfferUpdateSuccessResponse'
application/pdf:
schema:
$ref: '#/components/schemas/V2OfferUpdateSuccessResponse'
text/html:
schema:
$ref: '#/components/schemas/V2OfferUpdateSuccessResponse'
'400':
description: Bad Request Error
headers:
x-RateLimit-Limit:
schema:
type: integer
x-RateLimit-Remaining:
schema:
type: integer
x-RateLimit-Reset:
schema:
type: string
content:
application/json:
schema:
type: object
properties:
message:
type: string
text/csv:
schema:
type: object
properties:
message:
type: string
application/pdf:
schema:
type: object
properties:
message:
type: string
text/html:
schema:
type: object
properties:
message:
type: string
'403':
description: Forbidden Error
headers:
x-RateLimit-Limit:
schema:
type: integer
x-RateLimit-Remaining:
schema:
type: integer
x-RateLimit-Reset:
schema:
type: string
content:
application/json:
schema:
type: object
properties:
message:
type: string
text/csv:
schema:
type: object
properties:
message:
type: string
application/pdf:
schema:
type: object
properties:
message:
type: string
text/html:
schema:
type: object
properties:
message:
type: string
'404':
description: Not Found Error
headers:
x-RateLimit-Limit:
schema:
type: integer
x-RateLimit-Remaining:
schema:
type: integer
x-RateLimit-Reset:
schema:
type: string
content:
application/json:
schema:
type: object
properties:
message:
type: string
text/csv:
schema:
type: object
properties:
message:
type: string
application/pdf:
schema:
type: object
properties:
message:
type: string
text/html:
schema:
type: object
properties:
message:
type: string
'500':
description: Server Error
headers:
x-RateLimit-Limit:
schema:
type: integer
x-RateLimit-Remaining:
schema:
type: integer
x-RateLimit-Reset:
schema:
type: string
content:
application/json:
schema:
type: object
properties:
message:
type: string
text/csv:
schema:
type: object
properties:
message:
type: string
application/pdf:
schema:
type: object
properties:
message:
type: string
text/html:
schema:
type: object
properties:
message:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/V2OfferSingleCreate'
required: true
/v2/offers/offer:
post:
operationId: create_offer_by_identifier_query_v2
description: Create an offer by providing the variant's Barcode
summary: Create An Offer (v2)
parameters:
- name: identifier
in: query
description: The Barcode for the variant to create an offer against. It is not required to prepend BARCODE.
required: true
schema:
type: string
tags:
- Create an offer
responses:
'200':
description: OK
headers:
x-RateLimit-Limit:
schema:
type: integer
x-RateLimit-Remaining:
schema:
type: integer
x-RateLimit-Reset:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/V2OfferUpdateSuccessResponse'
text/csv:
schema:
$ref: '#/components/schemas/V2OfferUpdateSuccessResponse'
application/pdf:
schema:
$ref: '#/components/schemas/V2OfferUpdateSuccessResponse'
text/html:
schema:
$ref: '#/components/schemas/V2OfferUpdateSuccessResponse'
'400':
description: Bad Request Error
headers:
x-RateLimit-Limit:
schema:
type: integer
x-RateLimit-Remaining:
schema:
type: integer
x-RateLimit-Reset:
schema:
type: string
content:
application/json:
schema:
type: object
properties:
message:
type: string
text/csv:
schema:
type: object
properties:
message:
type: string
application/pdf:
schema:
type: object
properties:
message:
type: string
text/html:
schema:
type: object
properties:
message:
type: string
'403':
description: Forbidden Error
headers:
x-RateLimit-Limit:
schema:
type: integer
x-RateLimit-Remaining:
schema:
type: integer
x-RateLimit-Reset:
schema:
type: string
content:
application/json:
schema:
type: object
properties:
message:
type: string
text/csv:
schema:
type: object
properties:
message:
type: string
application/pdf:
schema:
type: object
properties:
message:
type: string
text/html:
schema:
type: object
properties:
message:
type: string
'404':
description: Not Found Error
headers:
x-RateLimit-Limit:
schema:
type: integer
x-RateLimit-Remaining:
schema:
type: integer
x-RateLimit-Reset:
schema:
type: string
content:
application/json:
schema:
type: object
properties:
message:
type: string
text/csv:
schema:
type: object
properties:
message:
type: string
application/pdf:
schema:
type: object
properties:
message:
type: string
text/html:
schema:
type: object
properties:
message:
type: string
'500':
description: Server Error
headers:
x-RateLimit-Limit:
schema:
type: integer
x-RateLimit-Remaining:
schema:
type: integer
x-RateLimit-Reset:
schema:
type: string
content:
application/json:
schema:
type: object
properties:
message:
type: string
text/csv:
schema:
type: object
properties:
message:
type: string
application/pdf:
schema:
type: object
properties:
message:
type: string
text/html:
schema:
type: object
properties:
message:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/V2OfferSingleCreate'
required: true
components:
schemas:
V2OfferSingleCreate:
type: object
properties:
sku:
type: string
description: The unique SKU of the offer. Please send us a unique sku whose length is less than 256 characters.
selling_price:
type: integer
description: The price at which the offer will sell for on Takealot (promotion prices will be prioitised). Please ensure you supply us with a positive whole number.
rrp:
type: integer
description: The original price of the offer. Please ensure you supply us with a positive whole number.
leadtime_days:
type: integer
description: The leadtime days of the offer. You can remove leadtime days from your offer by sending through -1.
leadtime_stock:
type: array
description: The leadtime stock of the offer. Please ensure that the merchant_warehouse_id is correct, found at https://seller.takealot.com/api/seller-api/offers and send a positive whole number for the quantity.
items:
type: object
properties:
merchant_warehouse_id:
type: integer
quantity:
type: integer
V2OfferLeadtimeStock:
type: object
properties:
merchant_warehouse:
type: object
properties:
warehouse_id:
type: integer
name:
type: string
quantity_available:
type: integer
V2StockCover:
type: object
description: please note that 0 means there is no stock and hence no cover. -1 means there have been no sales units in the past 30 days hence stock cover cannot be determined.
properties:
warehouse_id:
type: integer
stock_cover_days:
type: integer
V2SalesUnits:
type: object
properties:
warehouse_id:
type: integer
sales_units:
type: integer
V2OfferUpdateSuccessResponse:
type: object
properties:
offer:
$ref: '#/components/schemas/V2Offer'
validation_errors:
type: array
items:
type: object
properties:
message:
type: string
code:
type: string
V2OfferWarehouseStock:
type: object
properties:
warehouse:
type: object
properties:
warehouse_id:
type: integer
name:
type: string
quantity_available:
type: integer
V2Offer:
type: object
properties:
tsin_id:
type: integer
offer_id:
type: integer
sku:
type: string
barcode:
type: string
product_label_number:
type: string
selling_price:
type: integer
rrp:
type: integer
leadtime_days:
type: integer
leadtime_stock:
type: array
items:
$ref: '#/components/schemas/V2OfferLeadtimeStock'
status:
type: string
title:
type: string
offer_url:
type: string
stock_cover:
type: array
items:
$ref: '#/components/schemas/V2StockCover'
sales_units:
type: array
items:
$ref: '#/components/schemas/V2SalesUnits'
discount:
type: string
discount_shown:
type: boolean
storage_fee_eligible:
type: boolean
date_created:
type: string
stock_at_takealot_total:
type: integer
total_excess_takealot_stock:
type: integer
stock_at_takealot:
type: array
items:
$ref: '#/components/schemas/V2OfferWarehouseStock'
stock_on_way:
type: array
items:
$ref: '#/components/schemas/V2OfferWarehouseStock'
total_stock_on_way:
type: integer
total_stock_cover:
type: integer
catalogue_quality_score:
type: integer