Monotote API documentation

Base URL: https://apik.monotote.com/v1

Products By Catalog

GET /search/products/nike

This endpoint retrieves catalog products, allowing you to access a wide range of products available in the catalog.

Parameters

catalogrequiredstring
query
catalog
Default: nike
api-keyrequiredstring
query
publisher api-key
Default: 2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u
countrystring
query
Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch.
languagestring
query
Allowed: en, de, fr, es, it, nl, dk, pl, at, au, no, ch, us.
pageinteger
query
page
Default: 1
limitinteger
query
limit
Default: 24 · Allowed: 24, 50, 100
sortstring
query
Sorting option for product listing. Allowed values: - featured - newest - priceDesc - priceAsc No default value applied.
Allowed: featured, newest, priceDesc, priceAsc

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'

Responses

200 Successful operation.
[
  {
    "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"
        }
      }
    }
  }
]
404 Not found.
{
  "status": {
    "code": "404",
    "error": "true",
    "error_type": "catalog_not_found",
    "text": "Catalog not found."
  },
  "body": "null"
}
409 API authentication error (check your api-key).
{
  "status": {
    "code": "409",
    "error": "true",
    "error_type": "api_authentication_error",
    "text": "API authentication has failed"
  },
  "body": "null"
}
429 Rate limit exceeded.
{
  "error": {
    "message": "You exceeded the rate limit",
    "httpCode": "429",
    "code": "9"
  }
}

Available & Non-available Sizes

GET /sizes/nike/style-code/{style-code}

This endpoint retrieves the list of sizes for the specified product, enabling you to explore the sizing options.

Parameters

style-coderequiredstring
path
product style-code
Default: IM1346-001
api-keyrequiredstring
query
publisher api-key
Default: 2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u
countrystring
query
Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch.
languagestring
query
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}'

Responses

200 Successful operation.
[
  {
    "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"
    }
  }
]
404 Not found.
{
  "status": {
    "code": "404",
    "error": "true",
    "error_type": "catalog_not_found",
    "text": "Catalog not found."
  },
  "body": "null"
}
409 API authentication error (check your api-key).
{
  "status": {
    "code": "409",
    "error": "true",
    "error_type": "api_authentication_error",
    "text": "API authentication has failed"
  },
  "body": "null"
}
429 Rate limit exceeded.
{
  "error": {
    "message": "You exceeded the rate limit",
    "httpCode": "429",
    "code": "9"
  }
}

Search URL By Keyword

GET /url/nike

Returns a tracked affiliate (Awin) deep link to a Nike search for the given keywords, scoped by country.

Parameters

api-keyrequiredstring
query
publisher api-key
Default: 2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u
keywordsstring
query
search keywords
Default:
countrystring
query
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'

Responses

200 Successful operation.
{
  "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"
  }
}
404 Not found.
{
  "status": {
    "code": "404",
    "error": "true",
    "error_type": "catalog_not_found",
    "text": "Catalog not found."
  },
  "body": "null"
}
409 API authentication error (check your api-key).
{
  "status": {
    "code": "409",
    "error": "true",
    "error_type": "api_authentication_error",
    "text": "API authentication has failed"
  },
  "body": "null"
}
429 Rate limit exceeded.
{
  "error": {
    "message": "You exceeded the rate limit",
    "httpCode": "429",
    "code": "9"
  }
}

Facets By Catalog

GET /search/facets/nike

This endpoint provides access to catalog facets, offering comprehensive insights into product categories and attributes to help you explore and refine product selections.

Parameters

catalogrequiredstring
query
catalog
Default: nike
api-keyrequiredstring
query
publisher api-key
Default: 2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u
countrystring
query
Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch.
languagestring
query
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}'

Responses

200 Successful operation.
[
  {
    "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
            }
          ]
        }
      }
    }
  }
]
404 Not found.
{
  "status": {
    "code": "404",
    "error": "true",
    "error_type": "catalog_not_found",
    "text": "Catalog not found."
  },
  "body": "null"
}
409 API authentication error (check your api-key).
{
  "status": {
    "code": "409",
    "error": "true",
    "error_type": "api_authentication_error",
    "text": "API authentication has failed"
  },
  "body": "null"
}
429 Rate limit exceeded.
{
  "error": {
    "message": "You exceeded the rate limit",
    "httpCode": "429",
    "code": "9"
  }
}

Available Sizes

GET /product/nike/available-sizes

This endpoint retrieves the list of available sizes for the specified product, enabling you to explore the sizing options.

Parameters

style-coderequiredstring
query
product style-code
Default: IM1346-001
api-keyrequiredstring
query
publisher api-key
Default: 2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u
countrystring
query
Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch.
languagestring
query
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}'

Responses

200 Successful operation.
[
  {
    "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"
    }
  }
]
404 Not found.
{
  "status": {
    "code": "404",
    "error": "true",
    "error_type": "catalog_not_found",
    "text": "Catalog not found."
  },
  "body": "null"
}
409 API authentication error (check your api-key).
{
  "status": {
    "code": "409",
    "error": "true",
    "error_type": "api_authentication_error",
    "text": "API authentication has failed"
  },
  "body": "null"
}
429 Rate limit exceeded.
{
  "error": {
    "message": "You exceeded the rate limit",
    "httpCode": "429",
    "code": "9"
  }
}

Product By Style-Code

GET /product/nike/style-code/{style-code}

This endpoint provides detailed product information, offering comprehensive data about specific products.

Parameters

style-coderequiredstring
path
product style-code
Default: IM1346-001
api-keyrequiredstring
query
publisher api-key
Default: 2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u
countrystring
query
Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch.
languagestring
query
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}'

Responses

200 Successful operation.
[
  {
    "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": {}
    }
  }
]
404 Not found.
{
  "status": {
    "code": "404",
    "error": "true",
    "error_type": "catalog_not_found",
    "text": "Catalog not found."
  },
  "body": "null"
}
409 API authentication error (check your api-key).
{
  "status": {
    "code": "409",
    "error": "true",
    "error_type": "api_authentication_error",
    "text": "API authentication has failed"
  },
  "body": "null"
}
429 Rate limit exceeded.
{
  "error": {
    "message": "You exceeded the rate limit",
    "httpCode": "429",
    "code": "9"
  }
}

Affiliate Link By Style Code

GET /affiliate-link/nike/style-code/{style-code}

This endpoint will return affiliate link of a product based on stylecode

Parameters

style-coderequiredstring
path
style-code
Default: IM1346-001
api-keyrequiredstring
query
publisher api-key
Default: 2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u
countrystring
query
Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch.
languagestring
query
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}'

Responses

200 Successful operation.
[
  {
    "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"
    }
  }
]
404 Not found.
{
  "status": {
    "code": "404",
    "error": "true",
    "error_type": "catalog_not_found",
    "text": "Catalog not found."
  },
  "body": "null"
}
409 API authentication error (check your api-key).
{
  "status": {
    "code": "409",
    "error": "true",
    "error_type": "api_authentication_error",
    "text": "API authentication has failed"
  },
  "body": "null"
}
410 The requested resource is no longer available.
{
  "status": {
    "code": "410",
    "error": "true",
    "error_type": "invalid_product",
    "text": "Product not available"
  },
  "body": "null"
}
429 Rate limit exceeded.
{
  "error": {
    "message": "You exceeded the rate limit",
    "httpCode": "429",
    "code": "9"
  }
}

Affiliate Link

GET /affiliate-link/{sku}

This endpoint will return affiliate link of a product

Parameters

skurequiredstring
path
sku
Default: NUK-sBxXXKpD
api-keyrequiredstring
query
publisher api-key
Default: 2y104ozr6eol2exv0xynp7hxzjheiww4qx8xb249lgoehgowtgnf3u
countrystring
query
Allowed: us, uk, nl, no, dk, de, au, pl, fr, at, it, ch.
languagestring
query
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}'

Responses

200 Successful operation.
[
  {
    "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"
    }
  }
]
404 Not found.
{
  "status": {
    "code": "404",
    "error": "true",
    "error_type": "catalog_not_found",
    "text": "Catalog not found."
  },
  "body": "null"
}
409 API authentication error (check your api-key).
{
  "status": {
    "code": "409",
    "error": "true",
    "error_type": "api_authentication_error",
    "text": "API authentication has failed"
  },
  "body": "null"
}
410 The requested resource is no longer available.
{
  "status": {
    "code": "410",
    "error": "true",
    "error_type": "invalid_product",
    "text": "Product not available"
  },
  "body": "null"
}
429 Rate limit exceeded.
{
  "error": {
    "message": "You exceeded the rate limit",
    "httpCode": "429",
    "code": "9"
  }
}