Monotote API documentation
https://apik.monotote.com/v1Products By Catalog
This endpoint retrieves catalog products, allowing you to access a wide range of products available in the catalog.
Parameters
catalogrequired | string | catalog |
api-keyrequired | string | publisher api-key |
country | string | Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch. |
language | string | Allowed: en, de, fr, es, it, nl, dk, pl, at, au, no, ch, us. |
page | integer | page |
limit | integer | limit |
sort | string | Sorting option for product listing. Allowed values: - featured - newest - priceDesc - priceAsc No default value applied. |
Request sample
curl --request GET \
--url 'https://apik.monotote.com/v1/search/products/nike?catalog=nike&api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}&page=1&limit=24&sort=featured'const res = await fetch("https://apik.monotote.com/v1/search/products/nike?catalog=nike&api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}&page=1&limit=24&sort=featured");
const data = await res.json();
console.log(data);import requests
res = requests.get("https://apik.monotote.com/v1/search/products/nike?catalog=nike&api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}&page=1&limit=24&sort=featured")
data = res.json()
print(data)Responses
[
{
"status": {
"code": "200",
"error": "false",
"text": "success"
},
"body": {
"input": {
"keyword": "-",
"facets": [
{
"key": "46e489fb-1e36-40b3-9d05-4cb17dfcd52b",
"name": "Atlanta Hawks",
"display_name": "Atlanta Hawks",
"level": "1",
"checked": "false"
}
]
},
"meta": {
"total_products": "7282",
"total_pages": "292",
"sort": "newest",
"page": "1",
"limit": "25"
},
"products": {
"NUK-ABCDEF": {
"site_id": "5745",
"partner_name": "nike",
"partner_line": "nike",
"sku": "NUK-tGrmD4",
"name": "Zoom Freak 4 ASW",
"url": "https://www.nike.com/gb/t/zoom-freak-4-asw-basketball-shoes-tGrmD4/DV1178-500",
"thumb": "https://static.nike.com/a/images/t_default/edcba1fe-3eb6-4faa-865a-8d9240fdbb08/zoom-freak-4-asw-basketball-shoes-tGrmD4.png",
"price": "124.95",
"special_price": "0",
"currency": "gbp",
"attributes": {
"sku_public": "DV1178-500"
},
"inherit_attributes": {
"product_customize": "false",
"product_label": "label_just_in"
},
"disabled": "false",
"affiliate": "Awin",
"likes": "0",
"affiliate_url": "https://www.awin1.com/cread.php?p=https%3A%2F%2Fwww.nike.com%2Fgb%2Ft%2Fzoom-freak-4-asw-basketball-shoes-tGrmD4%2FDV1178-500&awinmid=16327&awinaffid=511687&clickref=monotote&clickref6=Monotote"
}
}
}
}
]{
"status": {
"code": "404",
"error": "true",
"error_type": "catalog_not_found",
"text": "Catalog not found."
},
"body": "null"
}{
"status": {
"code": "409",
"error": "true",
"error_type": "api_authentication_error",
"text": "API authentication has failed"
},
"body": "null"
}{
"error": {
"message": "You exceeded the rate limit",
"httpCode": "429",
"code": "9"
}
}Available & Non-available Sizes
This endpoint retrieves the list of sizes for the specified product, enabling you to explore the sizing options.
Parameters
style-coderequired | string | product style-code |
api-keyrequired | string | publisher api-key |
country | string | Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch. |
language | string | Allowed: en, de, fr, es, it, nl, dk, pl, at, au, no, ch, us. |
Request sample
curl --request GET \
--url 'https://apik.monotote.com/v1/sizes/nike/style-code/IM1346-001?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}'const res = await fetch("https://apik.monotote.com/v1/sizes/nike/style-code/IM1346-001?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}");
const data = await res.json();
console.log(data);import requests
res = requests.get("https://apik.monotote.com/v1/sizes/nike/style-code/IM1346-001?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}")
data = res.json()
print(data)Responses
[
{
"status": {
"code": "200",
"error": "false",
"text": "success"
},
"body": {
"url": "https://www.awin1.com/cread.php?awinmid=19590&awinaffid=793143&networkref2=cs1_3&clickref=monotote&clickref6=Monotote&p=https%3A%2F%2Fwww.nike.com%2Fgb%2Ft%2Fgiannis-freak-5-basketball-shoes-jlgqHX%2FDX4985-402",
"sizes": [
{
"availability": "true",
"sku": "NUK-EN-DX4985-402-1001332136",
"parent_sku": "NUK-jlgqHX",
"name": "Giannis Freak 5",
"style_code": "DX4985-402",
"size": 5.5
},
{
"availability": "false",
"sku": "NUK-EN-DX4985-402-1001332137",
"parent_sku": "NUK-jlgqHX",
"name": "Giannis Freak 5",
"style_code": "DX4985-403",
"size": 6
},
{
"availability": "true",
"sku": "NUK-EN-DX4985-402-1001332138",
"parent_sku": "NUK-jlgqHX",
"name": "Giannis Freak 5",
"style_code": "DX4985-404",
"size": 6.5
}
],
"price": "114.95",
"full_price": "114.95",
"specail_price": "0",
"currency": "GBP",
"style_code": "DX4985-402"
}
}
]{
"status": {
"code": "404",
"error": "true",
"error_type": "catalog_not_found",
"text": "Catalog not found."
},
"body": "null"
}{
"status": {
"code": "409",
"error": "true",
"error_type": "api_authentication_error",
"text": "API authentication has failed"
},
"body": "null"
}{
"error": {
"message": "You exceeded the rate limit",
"httpCode": "429",
"code": "9"
}
}Search URL By Keyword
Returns a tracked affiliate (Awin) deep link to a Nike search for the given keywords, scoped by country.
Parameters
api-keyrequired | string | publisher api-key |
keywords | string | search keywords |
country | string | Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch. |
Request sample
curl --request GET \ --url 'https://apik.monotote.com/v1/url/nike?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&keywords=&country=uk'
const res = await fetch("https://apik.monotote.com/v1/url/nike?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&keywords=&country=uk");
const data = await res.json();
console.log(data);import requests
res = requests.get("https://apik.monotote.com/v1/url/nike?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&keywords=&country=uk")
data = res.json()
print(data)Responses
{
"status": {
"code": 200,
"error": "false",
"text": "success"
},
"body": {
"input": {
"keyword": "Air Jordan 4 white cement"
},
"url": "https://www.awin1.com/cread.php?awinmid=16327&awinaffid=1726465&clickref=monotote-search-url-air-jordan-4-white-cement&clickref6=Monotote&p=https%3A%2F%2Fwww.nike.com%2Fgb%2Fw%3Fq%3DAir%2BJordan%2B4%2Bwhite%2Bcement%26vst%3DAir%2BJordan%2B4%2Bwhite%2Bcement"
}
}{
"status": {
"code": "404",
"error": "true",
"error_type": "catalog_not_found",
"text": "Catalog not found."
},
"body": "null"
}{
"status": {
"code": "409",
"error": "true",
"error_type": "api_authentication_error",
"text": "API authentication has failed"
},
"body": "null"
}{
"error": {
"message": "You exceeded the rate limit",
"httpCode": "429",
"code": "9"
}
}Facets By Catalog
This endpoint provides access to catalog facets, offering comprehensive insights into product categories and attributes to help you explore and refine product selections.
Parameters
catalogrequired | string | catalog |
api-keyrequired | string | publisher api-key |
country | string | Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch. |
language | string | Allowed: en, de, fr, es, it, nl, dk, pl, at, au, no, ch, us. |
Request sample
curl --request GET \
--url 'https://apik.monotote.com/v1/search/facets/nike?catalog=nike&api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}'const res = await fetch("https://apik.monotote.com/v1/search/facets/nike?catalog=nike&api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}");
const data = await res.json();
console.log(data);import requests
res = requests.get("https://apik.monotote.com/v1/search/facets/nike?catalog=nike&api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}")
data = res.json()
print(data)Responses
[
{
"status": {
"code": "200",
"error": "false",
"text": "success"
},
"body": {
"results": {
"on_sale": {
"key": "nba",
"display_name": "NBA",
"type": "checkbox",
"facets": [
{
"key": null,
"name": null,
"display_name": null,
"level": null,
"checked": null
}
]
},
"soccer_club_teams": {
"key": "nba",
"display_name": "NBA",
"type": "checkbox",
"facets": [
{
"key": null,
"name": null,
"display_name": null,
"level": null,
"checked": null
}
]
}
}
}
}
]{
"status": {
"code": "404",
"error": "true",
"error_type": "catalog_not_found",
"text": "Catalog not found."
},
"body": "null"
}{
"status": {
"code": "409",
"error": "true",
"error_type": "api_authentication_error",
"text": "API authentication has failed"
},
"body": "null"
}{
"error": {
"message": "You exceeded the rate limit",
"httpCode": "429",
"code": "9"
}
}Available Sizes
This endpoint retrieves the list of available sizes for the specified product, enabling you to explore the sizing options.
Parameters
style-coderequired | string | product style-code |
api-keyrequired | string | publisher api-key |
country | string | Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch. |
language | string | Allowed: en, de, fr, es, it, nl, dk, pl, at, au, no, ch, us. |
Request sample
curl --request GET \
--url 'https://apik.monotote.com/v1/product/nike/available-sizes?style-code=IM1346-001&api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}'const res = await fetch("https://apik.monotote.com/v1/product/nike/available-sizes?style-code=IM1346-001&api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}");
const data = await res.json();
console.log(data);import requests
res = requests.get("https://apik.monotote.com/v1/product/nike/available-sizes?style-code=IM1346-001&api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}")
data = res.json()
print(data)Responses
[
{
"status": {
"code": "200",
"error": "false",
"text": "success"
},
"body": {
"url": "https://www.awin1.com/cread.php?awinmid=19590&awinaffid=793143&networkref2=cs1_3&clickref=monotote&clickref6=Monotote&p=https%3A%2F%2Fwww.nike.com%2Fgb%2Ft%2Fgiannis-freak-5-basketball-shoes-jlgqHX%2FDX4985-402",
"sizes": [
"5.5",
"6",
"6.5"
],
"price": "114.95",
"full_price": "114.95",
"specail_price": "0",
"currency": "GBP",
"style_code": "DX4985-402"
}
}
]{
"status": {
"code": "404",
"error": "true",
"error_type": "catalog_not_found",
"text": "Catalog not found."
},
"body": "null"
}{
"status": {
"code": "409",
"error": "true",
"error_type": "api_authentication_error",
"text": "API authentication has failed"
},
"body": "null"
}{
"error": {
"message": "You exceeded the rate limit",
"httpCode": "429",
"code": "9"
}
}Product By Style-Code
This endpoint provides detailed product information, offering comprehensive data about specific products.
Parameters
style-coderequired | string | product style-code |
api-keyrequired | string | publisher api-key |
country | string | Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch. |
language | string | Allowed: en, de, fr, es, it, nl, dk, pl, at, au, no, ch, us. |
Request sample
curl --request GET \
--url 'https://apik.monotote.com/v1/product/nike/style-code/IM1346-001?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}'const res = await fetch("https://apik.monotote.com/v1/product/nike/style-code/IM1346-001?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}");
const data = await res.json();
console.log(data);import requests
res = requests.get("https://apik.monotote.com/v1/product/nike/style-code/IM1346-001?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}")
data = res.json()
print(data)Responses
[
{
"product": {
"type": "configurable",
"site_id": 7033,
"active": false,
"out_of_stock": true,
"partner_name": "NIKE",
"partner_line": "NIKE",
"sku": "NUK-NL-0P1HcH",
"sku_public": "DD9315-110",
"url": "https://www.nike.com/nl/t/0P1HcH",
"checked_at": "2023-10-13T11:46:18+00:00",
"name": "Air Jordan 1 Low G",
"thumb": "https://static.nike.com/a/images/t_PDP_1280_v1/u_126ab356-44d8-4a06-89b4-fcdcc8df0245,c_scale,fl_relative,w_1.0,h_1.0,fl_layer_apply/44d09b72-fa09-4bad-a5b5-406265761ad9/air-jordan-1-low-g-golfschoenen-0P1HcH.png#b3bc1d3ea144b0daa32e40f1c42bfa950b4f15bcbf310bc4",
"price": "149.99",
"special_price": "0",
"price_real": "149.99",
"currency": "EUR",
"gender": "null",
"images": [
null
],
"category_id": "null",
"attributes": {
"partner_name": "Nike",
"partner_line": "Nike",
"special_price": 0,
"price": 149.99,
"sku": "NUK-NL-0P1HcH",
"sku_public": "DD9315-110",
"name": "Air Jordan 1 Low G",
"short_description": "<div><p>Voel je goed, van de eerste tee tot de laatste putt. De Air Jordan 1 G is ge\u00efnspireerd op een van de meest iconische sneakers ooit en een absolute klassieker op de baan. De schoen heeft Air demping onder de voet, een Wings logo op de hak en een ge\u00efntegreerd profiel zodat je alles uit je swing kunt halen. Hij is net zo geweldig als de originele AJ1 en heeft alles wat je nodig hebt om comfortabel 18 holes te spelen.</p><ul><li>Colour Shown: Wit/Pure Platinum/Wit</li> <li>Style: DD9315-110</li></ul></div>",
"description": "Voel je goed",
"country": "NL",
"product_feature": false,
"seo_friendly_url": "https://www.nike.com/nl/t/air-jordan-1-low-g-golfschoenen-0P1HcH",
"sub_title": "Golfschoenen",
"similar_products": "DD9315-003",
"hub_messages": "",
"sustainable_materials": false,
"product_fetch_from": "fetch_product_from_ps",
"legacy_sku": "NUK-0P1HcH"
},
"alternative_urls": [
null
],
"all_skus": [
null
],
"checksum": "bda775ac96b0614764840c933cf258a7",
"disabled": false,
"affiliate": {
"code": "awin",
"name": "awin",
"logo": "https://cdn-corp.monotote.com/affiliates/awin.png",
"indirect_tracking_method": "none",
"cookie_url": "https://plugin.monotote.com/affiliate.html"
},
"checkout_type": "redirect",
"plugin_theme": "nike",
"plugin_view_type": "default",
"is_real_time": true,
"shortcode": "nikenl",
"use_affiliate_cookie": true,
"affiliate_link": "https://www.awin1.com/cread.php?awinmid=16327&awinaffid=310025&networkref2=cs1_3&clickref=monotote-local&clickref6=Monotote&p=https%3A%2F%2Fwww.nike.com%2Fgb%2Ft%2Fair-jordan-2-retro-se-shoes-kQXc3w%2FDQ0558-160",
"subproducts": {}
}
}
]{
"status": {
"code": "404",
"error": "true",
"error_type": "catalog_not_found",
"text": "Catalog not found."
},
"body": "null"
}{
"status": {
"code": "409",
"error": "true",
"error_type": "api_authentication_error",
"text": "API authentication has failed"
},
"body": "null"
}{
"error": {
"message": "You exceeded the rate limit",
"httpCode": "429",
"code": "9"
}
}Affiliate Link By Style Code
This endpoint will return affiliate link of a product based on stylecode
Parameters
style-coderequired | string | style-code |
api-keyrequired | string | publisher api-key |
country | string | Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch. |
language | string | Allowed: en, de, fr, es, it, nl, dk, pl, at, au, no, ch, us. |
Request sample
curl --request GET \
--url 'https://apik.monotote.com/v1/affiliate-link/nike/style-code/IM1346-001?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}'const res = await fetch("https://apik.monotote.com/v1/affiliate-link/nike/style-code/IM1346-001?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}");
const data = await res.json();
console.log(data);import requests
res = requests.get("https://apik.monotote.com/v1/affiliate-link/nike/style-code/IM1346-001?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}")
data = res.json()
print(data)Responses
[
{
"status": {
"code": "200",
"error": "false",
"text": "success"
},
"body": {
"Affiliate_url": "https://www.awin1.com/cread.php?awinmid=19590&awinaffid=793143&networkref2=cs1_3&clickref=monotote&clickref6=Monotote&p=https%3A%2F%2Fwww.nike.com%2Fgb%2Ft%2Fdri-fit-fitness-t-shirt-jBhLHX/AR6029-010",
"pixel_url": "https://www.awin1.com/cshow.php?s=2757274&v=19590&q=401412&r=793143&pv=1",
"method": "none",
"trigger": "2"
}
}
]{
"status": {
"code": "404",
"error": "true",
"error_type": "catalog_not_found",
"text": "Catalog not found."
},
"body": "null"
}{
"status": {
"code": "409",
"error": "true",
"error_type": "api_authentication_error",
"text": "API authentication has failed"
},
"body": "null"
}{
"status": {
"code": "410",
"error": "true",
"error_type": "invalid_product",
"text": "Product not available"
},
"body": "null"
}{
"error": {
"message": "You exceeded the rate limit",
"httpCode": "429",
"code": "9"
}
}Affiliate Link
This endpoint will return affiliate link of a product
Parameters
skurequired | string | sku |
api-keyrequired | string | publisher api-key |
country | string | Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch. |
language | string | Allowed: en, de, fr, es, it, nl, dk, pl, at, au, no, ch, us. |
Request sample
curl --request GET \
--url 'https://apik.monotote.com/v1/affiliate-link/NUK-sBxXXKpD?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}'const res = await fetch("https://apik.monotote.com/v1/affiliate-link/NUK-sBxXXKpD?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}");
const data = await res.json();
console.log(data);import requests
res = requests.get("https://apik.monotote.com/v1/affiliate-link/NUK-sBxXXKpD?api-key=2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u&country=uk&language={language}")
data = res.json()
print(data)Responses
[
{
"status": {
"code": "200",
"error": "false",
"text": "success"
},
"body": {
"Affiliate_url": "https://www.awin1.com/cread.php?awinmid=34017&awinaffid=1171080&clickref=monotote&clickref6=Monotote&p=https%3A%2F%2Fwww.nike.com%2Fno%2Ft%2Fracing-ankelsokker-tTbNSP%2FSK0122-819",
"pixel_url": "https://www.awin1.com/cshow.php?s=2757274&q=401412&r=1171080&pv=1",
"method": "none",
"trigger": "8"
}
}
]{
"status": {
"code": "404",
"error": "true",
"error_type": "catalog_not_found",
"text": "Catalog not found."
},
"body": "null"
}{
"status": {
"code": "409",
"error": "true",
"error_type": "api_authentication_error",
"text": "API authentication has failed"
},
"body": "null"
}{
"status": {
"code": "410",
"error": "true",
"error_type": "invalid_product",
"text": "Product not available"
},
"body": "null"
}{
"error": {
"message": "You exceeded the rate limit",
"httpCode": "429",
"code": "9"
}
}