Canto Product Catalog Products API
The product_catalog_products API from Canto — 2 operation(s) for product_catalog_products.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/canto:canto-product-catalog-products-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Canto PIM Product Catalog Products API
description: Canto APIs enable seamless synchronization between the PIM + DAM and external systems that rely on accurate, up-to-date product content.
version: v1.0.1
servers:
- url: https://{tenantSubdomain}.{region}/api/v1/pim/
variables:
tenantSubdomain:
default: demo
region:
enum:
- canto.com
- canto.global
- canto.de
- au.canto.com
- ca.canto.com
default: canto.com
security:
- bearerAuth: []
tags:
- name: product_catalog_products
paths:
/product_catalogs/{product_catalog_id}/products:
get:
tags:
- product_catalog_products
summary: Get Product Catalog Products
description: Retrieve all products within a specific catalog
operationId: get_api_v1_product_catalogs_product_catalog_id_products
parameters:
- name: product_catalog_id
in: path
required: true
schema:
type: number
responses:
'200':
description: Successfully fetched Products
headers:
page-items:
description: Number of items per page
schema:
type: integer
link:
description: Standard link header defined in RFC 8228. Contains links for first, last, next, and prev pages with respective `rel` attributes
schema:
type: string
current-page:
description: Current page number
schema:
type: integer
total-count:
description: Total number of items
schema:
type: integer
total-pages:
description: Total number of pages
schema:
type: integer
content:
'*/*':
schema:
type: object
properties:
products:
type: array
description: Array of Products in this Catalog, paginated
items:
type: string
additionalProperties: false
'400':
description: The request parameters were invalid
content: {}
'401':
description: User is not permitted to use the API or Authentication is invalid
content: {}
'404':
description: Product Catalog ID not found
content: {}
'500':
description: Something went wrong
content: {}
post:
tags:
- product_catalog_products
summary: Add Product to Product Catalog
description: Add a single product to a specific catalog
operationId: post_api_v1_product_catalogs_product_catalog_id_products
parameters:
- name: product_catalog_id
in: path
required: true
schema:
type: number
requestBody:
content:
application/json:
schema:
required:
- product_id
type: object
properties:
product_id:
type: integer
description: Product ID to add to the catalog
example: 1
example:
product_id: 1
required: true
responses:
'200':
description: Successfully added the product to the catalog
headers:
page-items:
description: Number of items per page
schema:
type: integer
link:
description: Standard link header defined in RFC 8228. Contains links for first, last, next, and prev pages with respective `rel` attributes
schema:
type: string
current-page:
description: Current page number
schema:
type: integer
total-count:
description: Total number of items
schema:
type: integer
total-pages:
description: Total number of pages
schema:
type: integer
content:
'*/*':
schema:
type: object
properties:
products:
type: array
description: Array of Products in this Catalog, paginated
items:
type: string
additionalProperties: false
'400':
description: The request parameters were invalid
content: {}
'401':
description: User is not permitted to use the API or Authentication is invalid
content: {}
'404':
description: Product or Product Catalog ID not found
content: {}
'422':
description: There was an error adding the product to the catalog
content: {}
'500':
description: Something went wrong
content: {}
/product_catalogs/{product_catalog_id}/products/{id}:
get:
tags:
- product_catalog_products
summary: Get Product Catalog Product
description: Get a specific product from a catalog by ID
operationId: get_api_v1_product_catalogs_product_catalog_id_products_id
parameters:
- name: product_catalog_id
in: path
required: true
schema:
type: number
- name: id
in: path
required: true
schema:
type: number
- name: include_share_link
in: query
description: 'Include Share Link URL in response TODO: still defining'
schema:
type: boolean
responses:
'200':
description: Successfully fetched Product
content:
'*/*':
schema:
required:
- created_at
- id
- product_assets
- product_custom_attributes
- updated_at
- user_id
- variants
type: object
properties:
id:
type: number
description: Product ID
product_category_id:
type: number
description: Product Category ID
product_type_id:
type: number
description: Product Type ID
has_variants:
type: boolean
description: Whether there are variants associated with this product
dimension1_id:
type: number
description: Primary Dimension ID
dimension2_id:
type: number
description: Secondary Dimension ID
dimension3_id:
type: number
description: Tertiary Dimension ID
created_at:
type: string
description: Created At
updated_at:
type: string
description: Updated At
user_id:
type: string
description: User ID of the Product creator
product_custom_attributes:
type: array
description: Array of product attributes' data. On Products Index, this is only General Attributes data
items:
type: string
variants:
type: array
description: Array of Product's Variants
items:
type: string
product_assets:
type: array
description: Array of product assets
items:
type: string
additionalProperties: false
'400':
description: The request parameters were invalid
content: {}
'401':
description: User is not permitted to use the API or Authentication is invalid
content: {}
'404':
description: Product Catalog or Product ID not found
content: {}
'500':
description: Something went wrong
content: {}
delete:
tags:
- product_catalog_products
summary: Remove Product from Product Catalog
description: Remove a specific product from a catalog by ID
operationId: delete_api_v1_product_catalogs_product_catalog_id_products_id
parameters:
- name: product_catalog_id
in: path
required: true
schema:
type: number
- name: id
in: path
required: true
description: Product ID
schema:
type: number
responses:
'204':
description: Successfully removed the product from the catalog
content: {}
'400':
description: The request parameters were invalid
content: {}
'401':
description: User is not permitted to use the API or Authentication is invalid
content: {}
'404':
description: Product or Product Catalog ID not found
content: {}
'422':
description: There was an error removing the product from the catalog
content: {}
'500':
description: Something went wrong
content: {}
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: AccessToken
x-original-swagger-version: '2.0'