Skip to main content
The URL Resolution API is used to resolve a storefront URL (especially SEO URLs) to the matching shop content. This lets the frontend build its routing on speaking URLs and obtain the result of whether the URL belongs to, for example, a product or a category — including the required internal IDs. The detail data can then be specifically retrieved via the Catalog API. A typical flow is: the storefront submits a URL such as /herren/schuhe/sneaker, the API returns the target type (e.g. category) and the corresponding category ID, and afterwards the contents are loaded via the Catalog API.

​
Supported methods

List of all supported methods.

​
SEO URLs

​
GET urls/identify

The following call can be used to determine where an SEO URL leads in the shop (product, category, content page, or start page).
The response contains the type of URL and — depending on the type — a resource (e.g. an ID or a path).
The API distinguishes between the following types

​
Examples

Successful identification (main URL) The URL points directly to a product. The type and the corresponding ID are specified in the response.
Example response

​
Successful identification with redirect

Obsolete URLs are recognized and redirected to the current URL. In addition to the ID, a redirect is also delivered.
Example response

​
Category

If the URL leads to a category, the response contains a category ID.
Example response

​
Start page

If the URL leads to the start page, there is no additional (ID) resource in the response.
Example response

​
Invalid URL

If the URL is not known to the system, the API responds with a “404 Not Found”.
Example response

​
GET urls/product

The following call can be used to determine the SEO URL of a product based on the product ID.

​
Parameter overview

​
Example response

  • If the product was not found, the request returns 404 Not Found.
  • On success, the request returns 200 OK including the output of the product’s SEO URL mentioned in the example in the body.

​
GET urls/category

The following call can be used to determine the SEO URL of a category based on the category ID.

​
Parameter overview

​
Example response

  • If the category was not found, the request returns 404 Not Found.
  • On success, the request returns 200 OK including the output of the category’s SEO URL mentioned in the example in the body.