Sendcloud

Sendcloud Products API

Get insights about products

GitHub OpenAPI

Operations 2

GET /insights/products/series Retrieve product-insights series #
GET /insights/products/buckets Retrieve product-insights buckets #

Documentation

📖
Documentation
https://sendcloud.dev/api/v3/shipments/
📖
APIReference
https://sendcloud.dev/api/v3/shipments/create-and-announce-a-shipment-synchronously
📖
Documentation
https://sendcloud.dev/api/v3/orders/
📖
Documentation
https://sendcloud.dev/api/v3/ship-an-order/
📖
Documentation
https://sendcloud.dev/api/v3/returns/
📖
Documentation
https://sendcloud.dev/api/v3/service-points/
📖
Documentation
https://sendcloud.dev/api/v3/parcel-tracking/
📖
Documentation
https://sendcloud.dev/api/v3/parcel-documents/
📖
Documentation
https://sendcloud.dev/api/v3/webhooks/
📖
Documentation
https://sendcloud.dev/api/v3/event-subscriptions/
📖
Documentation
https://sendcloud.dev/api/v3/integrations/
📖
Documentation
https://sendcloud.dev/api/v3/analytics/
📖
Documentation
https://sendcloud.dev/api/v3/reporting/
📖
Documentation
https://sendcloud.dev/api/v2/parcels/
📖
Documentation
https://sendcloud.dev/api/v2/labels/
📖
Documentation
https://sendcloud.dev/api/v2/tracking/
📖
Documentation
https://sendcloud.dev/api/v2/webhooks/
📖
Documentation
https://sendcloud.dev/api/v2/integrations/
📖
Documentation
https://sendcloud.dev/api/v2/analytics/
📖
Documentation
https://sendcloud.dev/api/v2/reporting/
📖
Documentation
https://sendcloud.dev/api/v2/parcel-documents/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/openapi/sendcloud-products-api-openapi.yml

Schemas & Data

📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-structure/sendcloud-shipment-structure.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-order-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-return-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-deliveryoption-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-structure/sendcloud-return-structure.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-servicepoint-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-servicepointdetail-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-servicepointaddress-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-parceltrackingresponse-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-parceltrackingcreaterequest-schema.json

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/examples/sendcloud-announce-shipment-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/examples/sendcloud-create-return-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/examples/sendcloud-list-service-points-example.json

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/sendcloud-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

sendcloud-products-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Analytics Products API
  version: 2.0.0
  description: The Analytics API lets you query for insights about parcels, products and transit times.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  contact:
    name: Sendcloud API Support
    url: https://www.sendcloud.dev
    email: contact@sendcloud.com
servers:
- url: https://panel.sendcloud.sc/api/v2
  description: Sendcloud Production
tags:
- name: Products
  description: Get insights about products
paths:
  /insights/products/series:
    get:
      summary: Retrieve product-insights series
      tags:
      - Products
      x-mint:
        href: /api/v2/analytics/retrieve-product-insights-series
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Series'
              examples:
                Series:
                  summary: Series
                  value:
                    series:
                    - value: 358
                      start_date: '2017-12-10'
                      end_date: '2020-12-10'
                      missing_data:
                      - start_date: '2018-12-10'
                        end_date: '2019-12-10'
                        reason_code: not-available
                      - start_date: '2019-12-10'
                        end_date: '2020-12-10'
                        reason_code: partly-available
                    - value: 188
                      start_date: '2021-12-10'
                      end_date: '2022-12-10'
                      missing_data:
                      - start_date: '2021-12-10'
                        end_date: '2022-12-10'
                        reason_code: missing-filter-property
        '422':
          description: Unprocessable Entity (WebDAV)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
              examples:
                BadRequest:
                  summary: Bad request
                  value:
                    detail:
                    - loc:
                      - query
                      - start_date
                      msg: field required
                      type: value_error.missing
      operationId: sc-public-v2-analytics-get-products_series
      description: Returns data about products as a series, e.g. the number of products per day/month/year over a specified period.
      security: []
      parameters:
      - schema:
          type: string
          format: date
        in: query
        name: start_date
        required: true
        description: period start date
      - schema:
          type: string
          format: date
        in: query
        name: end_date
        required: true
        description: period end date
      - schema:
          type: string
          example: postnl
        in: query
        name: carrier_code
        description: filter by carrier
      - schema:
          type: string
          example: DE
        in: query
        name: from_country
        description: origin country
      - schema:
          type: string
          example: NL
        in: query
        name: to_country
        description: destination country
      - schema:
          type: array
          items:
            type: integer
            example: 124523
        allowEmptyValue: true
        in: query
        name: integration_id
        description: integrations
      - schema:
          type: string
          enum:
          - days
          - months
          - years
        in: query
        name: granularity
        description: the size of one point
        required: true
      - schema:
          type: string
          enum:
          - incoming
          - outgoing
        in: query
        name: direction
        description: incoming or outgoing
      - schema:
          type: array
          items:
            type: integer
        in: query
        name: brand_id
        description: filtering by brand id
        allowEmptyValue: true
      - schema:
          type: array
          items:
            type: string
        in: query
        name: product_name
        description: filtering by product name
      - schema:
          type: array
          items:
            type: string
        in: query
        name: product_sku
        description: filtering by product sku
  /insights/products/buckets:
    get:
      summary: Retrieve product-insights buckets
      tags:
      - Products
      x-mint:
        href: /api/v2/analytics/retrieve-product-insights-buckets
      description: Returns data about products as buckets. Buckets should be grouped by any category, for example by country.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Buckets'
              examples:
                Buckets:
                  summary: Buckets
                  value:
                    buckets:
                    - key: UK
                      value: 10
                      percentage: 12.24
                      missing_data:
                      - start_date: '2018-12-10'
                        end_date: '2019-12-10'
                        reason_code: partly-available
                    - key: DE
                      value: 8
                      percentage: 9.85
                      missing_data:
                      - start_date: '2018-12-10'
                        end_date: '2019-12-10'
                        reason_code: partly-available
        '422':
          description: Unprocessable Entity (WebDAV)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
              examples:
                BadRequest:
                  summary: Unprocessable Entity (WebDAV)
                  value:
                    detail:
                    - loc:
                      - query
                      - start_date
                      msg: field required
                      type: value_error.missing
      operationId: sc-public-v2-analytics-get-products_buckets
      parameters:
      - schema:
          type: string
          format: date
        in: query
        name: start_date
        description: period start date (announced)
        required: true
      - schema:
          type: string
          format: date
        in: query
        name: end_date
        description: period end date (announced)
        required: true
      - schema:
          type: string
          example: postnl
        in: query
        name: carrier_code
        description: filter by carriers
      - schema:
          type: string
          example: DE
        in: query
        name: from_country
        description: origin country code
      - schema:
          type: string
          example: NL
        in: query
        name: to_country
        description: destination country code
      - schema:
          type: array
          items:
            type: integer
            example: 124523
        allowEmptyValue: true
        in: query
        name: integration_id
        description: integrations
      - schema:
          type: string
          enum:
          - integration
          - description
          - return_reason
          - brand
        in: query
        name: group_by
        description: group by category
        required: true
      - schema:
          type: string
          minLength: 0
          example: '5'
        in: query
        name: size
        description: number of the buckets
      - schema:
          type: string
          enum:
          - incoming
          - outgoing
        in: query
        name: direction
        description: incoming or outgoing
      - schema:
          type: array
          items:
            type: integer
        in: query
        name: brand_id
        description: filtering by brand id
        allowEmptyValue: true
      - schema:
          type: array
          items:
            type: string
        in: query
        name: product_name
        description: filtering by product name
      - schema:
          type: array
          items:
            type: string
        in: query
        name: product_sku
        description: filtering by product sku
      security: []
components:
  schemas:
    ErrorItem:
      title: Error Item Object
      type: object
      properties:
        loc:
          title: Location
          type: array
          items:
            type: string
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
      - loc
      - msg
      - type
    Buckets:
      type: object
      title: Analytics Buckets Object
      description: Parcel/Products data grouped into buckets.
      properties:
        buckets:
          type: array
          items:
            type: object
            properties:
              key:
                type: string
                description: bucket key
              value:
                type: integer
                minimum: 0
                description: Number of parcels/products in bucket
              percentage:
                type: number
                minimum: 0
                description: Percent of all parcels/products this bucket has
              missing_data:
                type: array
                description: Periods when data is missing
                items:
                  type: object
                  properties:
                    start_date:
                      type: string
                      format: date
                    end_date:
                      type: string
                      format: date
                    reason_code:
                      type: string
                      enum:
                      - missing-grouping-property
                      - missing-filter-property
                      - not-available
                      - partly-available
            required:
            - key
            - value
            - percentage
            - missing_data
      required:
      - buckets
    Errors:
      title: Errors Object
      type: object
      properties:
        detail:
          title: Detail
          type: array
          items:
            $ref: '#/components/schemas/ErrorItem'
    Series:
      type: object
      title: Analytics Series Object
      description: Parcels/Products data represented in series
      properties:
        series:
          type: array
          items:
            type: object
            properties:
              value:
                type: integer
                example: 0
                minimum: 0
                description: Number of parcels/products for the period
              start_date:
                type: string
                format: date
              end_date:
                type: string
                format: date
              missing_data:
                type: array
                items:
                  type: object
                  description: Periods when data is missing
                  properties:
                    start_date:
                      type: string
                      format: date
                    end_date:
                      type: string
                      format: date
                    reason_code:
                      type: string
                      enum:
                      - missing-grouping-property
                      - missing-filter-property
                      - not-available
                      - partly-available
            required:
            - value
            - start_date
            - end_date
            - missing_data
      required:
      - series
  securitySchemes:
    HTTPBasicAuth:
      type: http
      description: Basic Authentication using API key and secrets is currently the main authentication mechanism.
      scheme: basic
    OAuth2ClientCreds:
      type: oauth2
      description: OAuth2 is a standardized protocol for authorization that allows users to share their private resources stored on one site with another site without having to provide their credentials. OAuth2 Client Credentials Grant workflow. This workflow is typically used for server-to-server interactions that require authorization to access specific resources.
      flows:
        clientCredentials:
          tokenUrl: https://account.sendcloud.com/oauth2/token/
          scopes:
            api: Default OAuth scope required to access Sendcloud API.