πŸ›οΈ

ASOS Product Search, Prices & Size Availability APIs

Browse ASOS products in a consistent storefront, inspect size variants, and collect current price and availability observations. Product-level stock is not proof that your selected size is available.

Open the standalone ASOS demo

Inspect one page from a US footwear category

Replace <API_KEY> with your own authorized platform API key from the dashboard before deliberately submitting a request. The key travels in the URL; keep it out of shared links, screenshots and logs.

The example uses categoryId 4209, store and country US, currency USD, language en-US and US sizing, with limit 10, offset 0 and freshness sorting. These public inputs were observed successfully, but products, counts and availability can change. Opening the page, navigating, expanding panels or copying the example sends no data request.

Base URL https://api.opendata-api.com

curl -X GET 'https://api.opendata-api.com/api/project/asos/products-v2-list?key=<API_KEY>&categoryId=4209&country=US&currency=USD&lang=en-US&limit=10&offset=0&sizeSchema=US&sort=freshness&store=US'
Market context, product identity and stock limits
  • Keep country, store, currency, lang and sizeSchema with each catalog observation. The observed US settings are store US, currency USD, lang en-US and sizeSchema US; provide country US where that operation accepts it. Optional regional inputs do not establish omission defaults, and country-directory membership does not prove identical product coverage or comparable prices across markets.
  • Find a browsing category in nested navigation link.categoryId; a node ID is not interchangeable. The observed category 4209 returned ten products from a reported itemCount of 1523. A separate keyword request returned empty products and facets, which does not mean the category has no products. Because categoryId is required while q documentation says not to combine them, do not treat keyword-only search as a valid public example. Autocomplete numberOfResults counts catalog matches, not demand.
  • A listing product ID identifies the product, not a sizeId or variant ID. Detail and stock observations each contained eight variants, but equal counts do not prove a positional match. The stock payload is an array even for one product: match productId first, then confirm a shared variant identifier and the meaning of its stock fields. Keep missing or unresolved size availability unknown rather than treating product-level isInStock as a size-level answer.
  • Save your own observation time and market context alongside current prices, variant decisions and reported stockLastUpdatedDate values. That data timestamp is not automatically the fetch time or a freshness guarantee. Restock comparisons and historical prices require repeated observations stored by your application; these reads do not establish push alerts, exact quantities or inventory reservation.
  • Prefer products-v2-list, products-v4-detail and products-v4-get-stock-price for new catalog and stock workflows. The older listing, detail and similarity operations are explicitly deprecated and were not live-verified. Retention is not a promise of availability, schema compatibility or an interchangeable fallback.

Read the request result before trusting stock

Check HTTP status separately from the gateway's code, message and data business result. Gateway code 200 indicates business success; HTTP 200 alone does not. Then inspect the operation payload inside data: an empty product list is not a size-stock answer, and product-level isInStock does not establish availability of a chosen variant.

Find the ASOS task you need
Discover storefronts and category links

countries-list accepts an optional language such as en-US and returns market settings. Use the selected country's store, currency, language and size schema together. categories-list accepts optional country and language; inspect nested links for link.categoryId rather than using a navigation node's own ID. These are metadata reads, not product or stock checks.

Browse a category or suggest search terms

products-v2-list requires numeric categoryId, offset and limit plus a string store code; obtain the category from navigation and keep regional inputs aligned. Its q notes conflict with the required categoryId, so the safe example uses category browsing rather than a keyword-only request. v2-auto-complete requires q and returns suggestions with catalog-match counts, not product IDs or search-volume metrics.

Inspect product variants, prices and stock

Take a product ID from a listing: products-v4-detail requires numeric id, while products-v4-get-stock-price requires numeric productIds. Keep the same storefront, currency, language and size schema. Only a single product ID is verified for stock-price; match its root-array entry by productId, then verify the actual variant join and availability fields before deciding whether a size is in stock.

Review deprecated integration contracts

The five deprecated detail, listing and similarity operations are retained for migration reference, not verified working alternatives. Detail and similarity requests require a product ID. The legacy listing requires categoryId, limit and offset as strings plus a numeric store siteId; the current listing instead requires a string store code and numeric categoryId, limit and offset. Do not assume compatible inputs or response fields.

Catalog navigation

GET /api/project/asos/categories-list

List ASOS category navigation

Full docs β†’
Details

Retrieve ASOS category navigation for an optional country and language context. The documented examples are country=US and lang=en-US; no defaults for omitted inputs are documented. The supplied successful US/en-US observation returned an object with navigation, brands and footer arrays containing 2, 5 and 3 entries respectively, with nested children. These counts describe one observation, not fixed limits. Recursively inspect children to find product-bearing links: an observed View all node exposed link.categoryId=4209 for US men's shoes, boots and sneakers. Keep this listing category ID separate from a navigation node's own identifier. Unverified source-example text additionally shows node fields such as alias, id, type, content, display and link, with title and image metadata and link fields including webUrl, appUrl and linkType; those additional fields are not all established by the supplied observation summary. This is navigation metadata, not a product listing or a stock response.

Submit only the request you choose 0 required Β· 2 optional
ParameterInValue
query
query

Request cost is temporarily unavailable. No price is assumed.

View pricing
curl -X GET 'https://api.opendata-api.com/api/project/asos/categories-list?key=<API_KEY>'

Market configuration

GET /api/project/asos/countries-list

List ASOS countries and storefront settings

Full docs β†’
Details

Retrieve ASOS country and storefront configuration metadata with an optional lang language code. The documented and successfully observed language is en-US; no omission default is documented. The supplied successful response was a root-level array of 250 country entries, not an object containing a results property. Entries expose country, store and name, together with languages, currencies and sizeSchemas collections. The observed United States entry had store US, primary language en-US, currency USD and primary size schema US. Use those settings together when configuring compatible catalog requests. Unverified source-example text additionally contains metadata such as imageUrl, region, siteId and siteUrl; these extra fields are not all confirmed by the supplied observation summary. The observed entry count is not a fixed limit, and a country entry is not proof of identical product coverage, shipping eligibility or support for every possible currency-language-size combination.

Submit only the request you choose 0 required Β· 1 optional
ParameterInValue
query

Request cost is temporarily unavailable. No price is assumed.

View pricing
curl -X GET 'https://api.opendata-api.com/api/project/asos/countries-list?key=<API_KEY>'

Legacy product lookup

GET /api/project/asos/products-detail-deprecated

Look up legacy ASOS product details (deprecated)

Full docs β†’
Details

Deprecated ASOS product-detail lookup retained for identifying and migrating existing integrations, not recommended for new catalog enrichment. The required numeric id is obtained from a product listing. Optional currency, lang, sizeSchema and store values are documented as coming from the country directory; the examples are USD, en-US, US and US respectively. store is the country directory's store value, not the product-listing sideId. No defaults for omitted inputs are documented. The legacy currency field is declared numeric even though its documented example is USD; this conflicting input contract remains unverified and neither numeric nor text currency handling should be assumed. No live probe or response example was supplied for this deprecated operation. Its stated purpose is product-detail retrieval, but no returned fields, response shape, current availability or compatibility with newer detail records can be verified from the supplied evidence. Use products-v4-detail as the migration target for review, with explicit field and locale comparisons rather than assuming drop-in compatibility.

Submit only the request you choose 1 required Β· 4 optional
ParameterInValue
query
query
query
query
Optional filters and regional inputs (1)
ParameterInValue
query

Request cost is temporarily unavailable. No price is assumed.

View pricing
curl -X GET 'https://api.opendata-api.com/api/project/asos/products-detail-deprecated?key=<API_KEY>&id=<id>'

Legacy product discovery

GET /api/project/asos/products-list-deprecated

Review the deprecated ASOS category product listing contract

Full docs β†’
Details

Deprecated category-based product listing retained for migration reference. Supply categoryId from category discovery, store from the country record's siteId, and the required offset and limit query values. Optional country, currency, lang and sizeSchema select the regional context; brand, size, base_colour and attribute filters narrow the category, while min and max are documented as integer price bounds. The documented sort values are freshness, priceasc and pricedesc. This legacy contract does not list a q parameter, so do not assume it supports the keyword search available in the current listing contract. Parameter documentation references facetValues[].id for range, colour, brand and size filter choices. No response example or successful probe is supplied for this deprecated endpoint, so its product fields, response envelope, pagination metadata and present availability are unverified. When moving to /products/v2/list, explicitly review min/max versus priceMin/priceMax and recheck saved filters rather than treating the paths as aliases.

Submit only the request you choose 4 required Β· 13 optional
ParameterInValue
query
query
query
query
query
Optional filters and regional inputs (12)
ParameterInValue
query
query
query
query
query
query
query
query
query
query
query
query

Request cost is temporarily unavailable. No price is assumed.

View pricing
curl -X GET 'https://api.opendata-api.com/api/project/asos/products-list-deprecated?key=<API_KEY>&categoryId=<categoryId>&limit=<limit>&offset=<offset>&store=<store>'

Product catalog discovery

GET /api/project/asos/products-v2-list

Browse ASOS category products with regional filters and pagination

Full docs β†’
Details

List products for a category using required numeric categoryId, offset and limit plus the required string store from country discovery. Optional country, currency, lang and sizeSchema define the regional context. Documented filters include comma-separated brand, size, base_colour and attribute IDs, integer priceMin/priceMax bounds, range, and freshness/priceasc/pricedesc sorting. The supplied US category probe used categoryId=4209, offset=0, limit=10 and freshness sorting; HTTP 200 returned categoryName='Shoes, Boots & Sneakers', itemCount=1523, ten products and ten facets. The first observed product was ID 210916181, ASOS DESIGN two strap monk shoes, with a current USD price of 94.99. Treat itemCount as a reported count, not the number of rows in the current page or proof of complete coverage. A separate keyword probe returned HTTP 200 with itemCount=0, products=[], facets=[], categoryName=null and searchPassMeta.isPartial=false and isSpellcheck=false; its searchTerm echoed the supplied term twice, separated by a comma. This does not establish a universal cause for empty searches. The q notes say not to combine it with categoryId, yet categoryId remains required in this published contract; the keyword-only probe does not remove that constraint. The supplied truncated example additionally documents diagnostics and facets[].facetValues[] entries with id, name, count and isSelected, plus facet metadata such as displayStyle, facetType and hasSelectedValues. Those nested example fields and optional filter combinations are not independently established by the probe summaries. Save product IDs for separate detail or stock checks; listing data does not provide exact inventory quantities, sales rankings or built-in price history.

Submit only the request you choose 4 required Β· 16 optional
ParameterInValue
query
query
query
query
query
query
query
query
query
Optional filters and regional inputs (11)
ParameterInValue
query
query
query
query
query
query
query
query
query
query
query

Request cost is temporarily unavailable. No price is assumed.

View pricing
curl -X GET 'https://api.opendata-api.com/api/project/asos/products-v2-list?key=<API_KEY>&categoryId=<categoryId>&limit=<limit>&offset=<offset>&store=<store>'

Legacy recommendations

GET /api/project/asos/products-v2-list-similarities-deprecated

Review the deprecated ASOS product-similarity lookup contract

Full docs β†’
Details

Deprecated product-similarity lookup retained to identify legacy recommendation dependencies. It requires a numeric id taken from a product returned by /products/v2/list and accepts an optional string store code from /countries/list. The documented example id is 9851612 and store example is US; those examples do not establish present product availability. No successful probe is supplied for this operation. An unverified, truncated source response example shows a root id and products array whose entries contain order and product. The example product includes id, name, brandName, colour, images, isAvailable, isInStock, productCode, price and variants. Its price object includes currency, current, previous, rrp, isMarkedDown and isOutletPrice; current contains text and value. Example variants include id, brandSize, sizeId, sizeOrder, isAvailable, isInStock and isLowInStock. These are example field names, not a verified current response contract, inventory quantities or a documented similarity score. Do not assume this path still returns recommendations or that another supplied operation is an equivalent replacement. If replacing the dependency with application-defined recommendations, retrieve candidates through the current listing and inspect details separately, clearly labeling the selection logic as your own.

Submit only the request you choose 1 required Β· 1 optional
ParameterInValue
query
query

Request cost is temporarily unavailable. No price is assumed.

View pricing
curl -X GET 'https://api.opendata-api.com/api/project/asos/products-v2-list-similarities-deprecated?key=<API_KEY>&id=<id>'

Products

GET /api/project/asos/products-v3-detail-deprecated

Retrieve legacy v3 ASOS product details (deprecated)

Full docs β†’
Details

Deprecated product-detail lookup retained for existing v3 clients and migration planning. Supply the required numeric id obtained from a product listing. Optional currency, lang, sizeSchema and store values should come from country discovery; the documented examples are USD, en-US, US and US respectively. The store input is the country-discovery store value, not the site identifier used by product listings. No live response was supplied for this deprecated endpoint, so its current availability and response contract are unverified. A truncated source example names id, name, productCode, brand, alternateNames, info, media, price, variants and isInStock. In that unverified excerpt, alternateNames contains locale and title, brand includes brandId and name, info includes aboutMe, careInfo and sizeAndFit, media includes images and catwalk entries, and price includes currency, current, previous and rrp. The variants excerpt includes brandSize, isAvailable and isLowInStock but is incomplete. These source-only fields are migration clues, not confirmed current outputs or exact stock quantities. For new detail integrations, evaluate products-v4-detail and compare saved fixtures before switching; do not assume identical variant, media or price structures.

Submit only the request you choose 1 required Β· 4 optional
ParameterInValue
query
query
query
query
query

Request cost is temporarily unavailable. No price is assumed.

View pricing
curl -X GET 'https://api.opendata-api.com/api/project/asos/products-v3-detail-deprecated?key=<API_KEY>&id=<id>'
GET /api/project/asos/products-v3-list-similarities-deprecated

List legacy v3 ASOS similar products (deprecated)

Full docs β†’
Details

Deprecated similar-product lookup for an existing ASOS product. Supply the required numeric id returned by a product listing. Optional currency, lang, sizeSchema and store preserve the regional request context; documented examples are USD, en-US, US and US. Select currency, sizing and store values from country discovery and use lang for the language code. No live response was supplied for this deprecated route, so present-day recommendation behavior and availability are unverified. A truncated source example has a root id and products array; each visible entry has order and a nested product. Product fields in that unverified excerpt include id, name, brandName, colour, images, price, variants, isAvailable and isInStock. Visible price fields include currency, current, previous and rrp; visible variant fields include brandSize, sizeId, sizeOrder and isLowInStock. Treat these as source-only structural clues, not confirmed outputs, similarity scores, exact inventory quantities or a guaranteed ranking contract. No current non-deprecated similarity replacement is established by the supplied evidence. A category-listing fallback can support separate discovery, but must not be presented as equivalent recommendations from this endpoint.

Submit only the request you choose 1 required Β· 4 optional
ParameterInValue
query
query
query
query
query

Request cost is temporarily unavailable. No price is assumed.

View pricing
curl -X GET 'https://api.opendata-api.com/api/project/asos/products-v3-list-similarities-deprecated?key=<API_KEY>&id=<id>'
GET /api/project/asos/products-v4-detail

Get ASOS product details, images and size variants

Full docs β†’
Details

Retrieve a detailed ASOS product record using the required numeric id from a product listing. Optional currency, lang, sizeSchema and store values come from country discovery; use the store value, not the site identifier used by listings. A successful HTTP 200 observation used id=210916181, store=US, currency=USD, lang=en-US and sizeSchema=US. The response was an object with the matching product id and name, description, productCode, gender, brand, productType, info, media, localisedData, size flags and variants. That product was a brown leather monk shoe with brand.id=53, brand.name=ASOS DESIGN, gender=Men and productType.name=Shoes. info contained aboutMe, sizeAndFit and careInfo. media.images contained four records with url, type, colourWayId, colour and isPrimary; other media collections may be empty. The eight observed variants included id, sizeId, brandSize, displaySizeText, sizeOrder, sku, isAvailable, colourWayId and colour. For example, variant 210916195 had sizeId 388476 and displaySizeText US 7; these identifiers are distinct from product id 210916181. localisedData contained locale, title and pdpUrl records. Optional fields such as rating, shippingRestriction and fitType were null in this sample, so handle missing or empty values and variable array lengths. The observed response had no root price or isInStock field. A separate truncated source example names price, isInStock, alternateNames and brand.brandId, but those fields were not confirmed in the observed v4 record. Use the separate stock and price lookup for availability and price observations; detail variants do not provide exact stock counts, a guaranteed refresh interval or built-in price history.

Submit only the request you choose 1 required Β· 4 optional
ParameterInValue
query
query
query
query
query

Request cost is temporarily unavailable. No price is assumed.

View pricing
curl -X GET 'https://api.opendata-api.com/api/project/asos/products-v4-detail?key=<API_KEY>&id=<id>'
GET /api/project/asos/products-v4-get-stock-price

Get ASOS product stock and current prices

Full docs β†’
Details

Retrieve a stock and price snapshot for an ASOS product using the required numeric productIds query parameter. Obtain the product ID from products/v2/list. Despite the plural name, the documented parameter type is a number and only a single-product request has been verified; multi-ID encoding and batch limits are not established. Optional currency, lang, sizeSchema and store values should come from countries/list. Use its store code, not a product-listing site identifier. The observed combination was store=US, currency=USD, lang=en-US and sizeSchema=US. The observed HTTP 200 body was a root array containing one item, not an object wrapper. Match entries by productId rather than assuming an array position. For productId=210916181, the confirmed fields were productPrice.current.value=94.99, productPrice.currency=USD, isInStock=true and a variants array with eight entries. Reported variant stockLastUpdatedDate values included 2026-10-23T01:53:27.387Z. These values describe one observation, not a promise of the same price or availability on a later request. The probe metadata did not establish the exact variant identifier, size-label or availability field names. Product-level isInStock does not prove that a chosen size is available. Treat additional illustrative source-example fields as unverified rather than a guaranteed response contract. This endpoint does not establish exact inventory quantities or immediate freshness. Keep the request observation time separate from each reported stockLastUpdatedDate. Restock scheduling, alerts and stored price history must be implemented in your application; this read does not reserve stock or place an order.

Submit only the request you choose 1 required Β· 4 optional
ParameterInValue
query
query
query
query
query

Request cost is temporarily unavailable. No price is assumed.

View pricing
curl -X GET 'https://api.opendata-api.com/api/project/asos/products-v4-get-stock-price?key=<API_KEY>&productIds=<productIds>'
GET /api/project/asos/v2-auto-complete

Get ASOS product search suggestions

Full docs β†’
Details

Retrieve ASOS product-search autocomplete suggestions for the required q query string. Supply a product name, keyword or brand phrase; bikini top is a documented example, while the observed successful request used nike. The optional country, currency, lang, sizeSchema and store inputs use values from countries/list. They describe the requested market and locale context rather than filters for a specific product variant. The verified combination was country=US, currency=USD, lang=en-US, sizeSchema=US and store=US. The observed HTTP 200 body was an object with a suggestionGroups array containing one group. That group had indexName=searchterms and a suggestions array with ten entries. Each observed suggestion exposed searchTerm, the proposed query text, and numberOfResults, its reported catalog-match count. Examples were nike with 1770 results, nike women with 1530 and nike shoes with 719. These counts are observations from that request, not fixed totals, consumer search volume, sales figures or demand rankings. Group and suggestion counts are not guaranteed to remain the same. The unverified source response example also contains a group-level indexTitle field and eight suggestions; indexTitle was not confirmed by the probe metadata and should be treated as illustrative, not guaranteed. This endpoint returns query suggestions rather than product records, product IDs, prices or stock confirmation. A selected searchTerm can be passed into a separate products/v2/list search with the intended locale preserved, but suggestion presence does not guarantee that a subsequent listing request returns products. Fetching suggestions and submitting a product search are separate application actions; navigation, opening help and copying examples should not trigger either request.

Submit only the request you choose 1 required Β· 5 optional
ParameterInValue
query
query
query
query
query
query

Request cost is temporarily unavailable. No price is assumed.

View pricing
curl -X GET 'https://api.opendata-api.com/api/project/asos/v2-auto-complete?key=<API_KEY>&q=<q>'

Catalog reads and availability boundaries

Build fashion discovery and monitoring tools with structured ASOS catalog data. Find products within a storefront, inspect their details and variants, and collect price and availability observations in a consistent market context.

  • Discover country settings and shopping categories before selecting a catalog to browse
  • Browse category product listings with pagination, sorting, and size, brand, color, or price filters
  • Retrieve product descriptions, brand information, images, and size variants by product ID
  • Check current merchandise prices and product or variant availability for stock-watch workflows
  • Suggest search terms with autocomplete and matching catalog-result counts
  • Consult clearly marked deprecated listing, detail, and similarity operations when reviewing older integrations

Keep country, storefront, language, currency, and size schema aligned. Product-level stock does not establish availability for every size. Store your own observations for price history or restock comparisons; this is catalog read access, not order management, inventory reservation, or a guarantee of stock quantities or freshness. Deprecated operations are retained for reference, not verified as working alternatives.

Guides