Mapp Fashion’s API provides access to personalization features for fashion and apparel use cases. It allows you to retrieve product recommendations, including related items and curated suggestions, as well as product data for integration into your shop or application.
Recommendations can be generated based on specific items, user profiles, or predefined contexts.
When to Use This API
The Mapp Fashion API is typically used after the core Mapp Fashion integration is in place, including:
Product data feeds
Tracking implementation
Enrichment and recommendation model setup
The API provides access to recommendation results and product data but does not replace the underlying data integration.
For a complete overview of data flows, setup, and system architecture, refer to the Mapp Fashion Integration Overview and related documentation.
Terminology Note
Some request parameters, headers, or response fields may still use the term dressipi. This reflects legacy naming within the API and does not indicate a separate product.
All references to dressipi in the API correspond to Mapp Fashion.
What can I do with the Mapp Fashion API?
Fetch related products or outfit recommendations
Request personalized suggestions for users, including facetted and themed types
Retrieve product details
Handle authentication using JWTs for secure server-side communication
API Structure
The API is divided into the following sections:
Get related outfit or item recommendations and product information.
Access personalized suggestions for users, including facetted and themed options.
Manage access tokens for authenticated requests using JSON Web Tokens (JWT).
Recommendation Context
Recommendation results depend on the context parameters provided in the request.
If no explicit context (for example, department) is defined, recommendations are generated based on default catalog settings.
For shops with multiple departments (such as menswear, womenswear, or kidswear), it is recommended to always provide the appropriate context to ensure relevant results—especially for general placements such as homepages or basket pages.
Getting Started
To work with the Mapp Fashion API, follow these steps:
Understand authentication, request structure, and core concepts in Core Concepts & Setup
Learn how to choose the right endpoint for your use case in Recommendation Strategy
The API documentation also includes:
Detailed endpoint references
Parameter definitions and usage
Example requests and responses
Each endpoint page provides:
A description of the endpoint and its purpose
Authentication requirements
Definitions for path and query parameters
Example response codes and curl command samples
Some parameter values (for example, identifier_type) may depend on your integration setup. Refer to the Basics section or validate your configuration accordingly.
Access the Full Mapp Fashion Documentation
For additional information beyond the API, including use cases, technical background, and integration guides, refer to the full Mapp Fashion documentation.