How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Mirakl Taxonomy API

The Taxonomy API from Mirakl — 2 operation(s) for taxonomy.

Mirakl Taxonomy API is one of 34 APIs that Mirakl publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Taxonomy. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 2 operations across 2 paths, and defines 30 schemas. It is described by OpenAPI 3.2.0.

Requests are made against a single base URL, https://miraklconnect.com/api/channel-platform.

2 operations 2 paths 30 schemas 2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
Base URL
https://your-instance.mirakl.net
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Mirakl Taxonomy API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (Bearer).

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Taxonomy 2
PUT
/v1/taxonomy/channels/{channel_id}/rules
createTaxonomyRule - Create a Taxonomy Rule
createTaxonomyRule 1 param body → 202
PUT
/v1/taxonomy/channels/{channel_id}/product-types
upsertProductType - Create or Update a Product Type
upsertProductType 3 params body → 202401404

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are EmbeddedAttribute (7 properties), ProductType (4 properties), ProductTypeRule (3 properties), RedefineAttributeActionPayload (2 properties). Each schema is shown below with its type and property counts.

ProductTypeRuleConditionEquals
object
A condition that checks if a specific attribute equals a given value
1 property 1 required
ConnectStandardAttribute
string
Equivalent of the attribute in Connect standard taxonomy Enum: "PRODUCTID", "CATEGORY", "BRAND", "TITLE", "DESCRIPTION", "IMAGE", "GTIN", "VARIANTGROUPCODE"
EmbeddedAttribute
object
7 properties 5 required
ProductTypeRule
object
A rule associated with the product type
3 properties 3 required
ProductTypeRuleActionRedefineAttribute
object
An action to redefine an attribute's properties
1 property 1 required
ProductTypeRuleConditionNot
object
A condition that must not be met to trigger the rule
1 property 1 required
ProductTypeRuleActionAll
object
A set of actions to apply when the rule is triggered
1 property 1 required
ProductTypeRuleCondition
Condition to trigger the rule
StoreId
string
Store identifier in the channel
ProductTypeRuleReference
object
A reference to a rule associated with the product type
1 property 1 required
ProductTypeRuleConditionAny
object
A set of conditions where at least one must be met to trigger the rule
1 property 1 required
ProductTypeId
string
Anything that uniquely identifies the product type.
ProductTypeRuleConditionIn
object
A condition that checks if a specific attribute's value is in a given list of
1 property 1 required
ProductAttributeId
string
Anything that uniquely identifies the product attribute.
ProductTypeRuleConditionIsSet
object
A condition that checks if a specific attribute is set
1 property 1 required
ProductType
object
4 properties 2 required
IsSetRuleConditionPayload
object
1 property 1 required
ProductTypeRuleConditionAll
object
A set of conditions that must all be met to trigger the rule
1 property 1 required
Locale
string
The language format can be ISO-639 or ISO-639ISO-3166
TaxonomyRuleRequest
object
Request to create a taxonomy rule
1 property 1 required
InRuleConditionPayloadValue
RequirementLevel
string
Requirement level of the attribute when creating or updating a product Enum: "OPTIONAL", "RECOMMENDED", "REQUIRED"
Localized
object
2 properties 2 required
ProductTypeContext
object
Additional context information about where this product type label is located within the marketplace's data structure. This helps with catalog transformation.
1 property
ProductAttributeType
string
Each type of attributes has a different set of properties Enum: "Text", "Integer", "Decimal", "List", "Media"
EqualsRuleConditionPayloadValue
The value to compare against
InRuleConditionPayload
object
2 properties 2 required
EqualsRuleConditionPayload
object
2 properties 2 required
RedefineAttributeActionPayload
object
2 properties 2 required
AttributeContext
object
Additional context information about where this attribute label is located within the marketplace's data structure. This helps with catalog transformation.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mirakl-taxonomy-api-openapi.yml Raw ↑

Other APIs Mirakl publishes across the network.

Mirakl Carriers API
Mirakl Catalog Configuration API
Mirakl Incidents API
Mirakl Invoicing and Accounting API
Mirakl Messages API
Mirakl Multiple shipments API
Mirakl Offers API
Mirakl Orders API
Mirakl Picklists API
Mirakl Platform Settings API
Mirakl Product Feedback API
Mirakl Products API
Where this information came from

This is an independent, third-party profile of Mirakl Taxonomy API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.