Insider

Insider Catalog APIs API

The Catalog APIs API from Insider — 5 operation(s) for catalog apis.

GitHub OpenAPI

Operations 5

POST /v2/ingest Add New Products in a Flat Format #
POST /v2/ingest/nested Add New Products in a Nested Format #
POST /v2/locales/batch Create Locale Configurations #
POST /v2/update Update Existing Products in a Flat Format #
POST /v2/update/nested Update Existing Products in a Nested Format #

Documentation

📖
Documentation
https://academy.insiderone.com/docs/ucd-user-data-apis-overview
📖
APIReference
https://developers.insiderone.com/
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/insider/refs/heads/main/authentication/insider-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/insider/refs/heads/main/rate-limits/insider-rate-limits.yml
📖
Documentation
https://academy.insiderone.com/docs/data-collection-consent-apis
📖
Documentation
https://academy.insiderone.com/docs/email-apis-overview
📖
Documentation
https://academy.insiderone.com/docs/transactional-sms-overview
📖
Documentation
https://academy.insiderone.com/docs/whatsapp-transactional-api
📖
Documentation
https://academy.insiderone.com/docs/web-push-apis-overview
📖
Documentation
https://academy.insiderone.com/docs/app-push-apis-overview
📖
Documentation
https://academy.insiderone.com/docs/mobile-app-analytics-apis
📖
Documentation
https://academy.insiderone.com/docs/mobile-app-integration-guide-1
📖
Documentation
https://academy.insiderone.com/docs/otp-for-sms
📖
Documentation
https://academy.insiderone.com/docs/product-catalog-api-introduction
📖
Documentation
https://academy.insiderone.com/docs/recommendation-api
📖
Documentation
https://academy.insiderone.com/docs/eureka-search-api-overview
📖
Documentation
https://academy.insiderone.com/docs/eureka-event-collection-api-implementation
📖
Documentation
https://academy.insiderone.com/docs/email-analytics-api
📖
Documentation
https://academy.insiderone.com/docs/architect-analytics-api
📖
Documentation
https://academy.insiderone.com/docs/transactional-journeys-on-api-call-starter

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/insider/refs/heads/main/openapi/insider-catalog-apis-api-openapi.yml

Other Resources

🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/insider/refs/heads/main/errors/insider-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/insider/refs/heads/main/conventions/insider-conventions.yml
🔗
Postman
https://raw.githubusercontent.com/api-evangelist/insider/refs/heads/main/postman/insider-one-apis.postman_collection.json
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/insider/refs/heads/main/data-model/insider-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/insider/refs/heads/main/asyncapi/insider-whatsapp-webhooks.yml
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/insider/refs/heads/main/scopes/insider-scopes.yml

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/insider-catalog-apis-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

insider-catalog-apis-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Insider One Catalog Catalog APIs API
  version: 1.0.0
  description: 'Product catalog ingestion and update in flat and nested formats, plus locale configuration.


    Derived by API Evangelist from Insider One''s own public Postman collection ("Insider One APIs", published at https://developers.insiderone.com/). Paths, methods, headers, query parameters and request/response examples are verbatim from that collection; nothing is invented. The 429 response is documented for all Insider One APIs on https://academy.insiderone.com/docs/api-rate-limits-1 .'
  contact:
    name: Insider One Support
    email: support@useinsider.com
    url: https://academy.insiderone.com/docs/insider-one-apis-1
  termsOfService: https://insiderone.com/terms-of-use/
servers:
- url: https://catalog.api.useinsider.com
tags:
- name: Catalog APIs
paths:
  /v2/ingest:
    post:
      operationId: addNewProductsInAFlatFormat
      summary: Add New Products in a Flat Format
      tags:
      - Catalog APIs
      description: The Catalog API allows you to insert new products in a flat format into your product catalog.
      security:
      - PartnerName: []
      - RequestToken: []
      requestBody:
        content:
          application/json:
            example:
            - item_id: velocity-runner-pro-white
              locale: en_US
              name: Velocity Runner Pro - White
              url: https://www.example-insiderone.com/shoes/velocity-runner-pro-white
              image_url: https://cdn.example-insiderone.com/images/velocity-runner-pro-white.jpg
              category:
              - Shoes
              - Running
              - Velox
              brand: Velox
              color: White
              groupcode: velocity-runner-pro
              price:
                USD: 129.99
              original_price:
                USD: 149.99
              in_stock: 1
              stock_count: 50
            - item_id: velocity-runner-pro-white
              locale: en_US:newyork
              name: Velocity Runner Pro - White
              url: https://www.example-insiderone.com/shoes/velocity-runner-pro-white
              image_url: https://cdn.example-insiderone.com/images/velocity-runner-pro-white.jpg
              category:
              - Shoes
              - Running
              - Velox
              brand: Velox
              color: White
              groupcode: velocity-runner-pro
              price:
                USD: 119.99
              original_price:
                USD: 149.99
              in_stock: 1
              stock_count: 12
            - item_id: velocity-runner-pro-white
              locale: en_US:losangeles
              name: Velocity Runner Pro - White
              url: https://www.example-insiderone.com/shoes/velocity-runner-pro-white
              image_url: https://cdn.example-insiderone.com/images/velocity-runner-pro-white.jpg
              category:
              - Shoes
              - Running
              - Velox
              brand: Velox
              color: White
              groupcode: velocity-runner-pro
              price:
                USD: 129.99
              original_price:
                USD: 149.99
              in_stock: 0
              stock_count: 0
            - item_id: velocity-runner-pro-white
              locale: pt_BR
              name: Velocity Runner Pro - Branco
              url: https://www.example-insiderone.com/shoes/velocity-runner-pro-white
              image_url: https://cdn.example-insiderone.com/images/velocity-runner-pro-white.jpg
              category:
              - Calçados
              - Corrida
              - Velox
              brand: Velox
              color: White
              groupcode: velocity-runner-pro
              price:
                BRL: 899.9
              original_price:
                BRL: 999.9
              in_stock: 1
              stock_count: 30
      responses:
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /v2/ingest/nested:
    post:
      operationId: addNewProductsInANestedFormat
      summary: Add New Products in a Nested Format
      tags:
      - Catalog APIs
      description: The Catalog API allows you to insert new items into your product catalog in a nested format.
      security:
      - PartnerName: []
      - RequestToken: []
      requestBody:
        content:
          application/json:
            example:
            - item_id: velocity-runner-pro-white
              base:
                url: https://www.example-insiderone.com/shoes/velocity-runner-pro-white
                image_url: https://cdn.example-insiderone.com/images/velocity-runner-pro-white.jpg
                brand: Velox
                groupcode: velocity-runner-pro
                color: White
              locales:
                en_US:
                  name: Velocity Runner Pro - White
                  category:
                  - Shoes
                  - Running
                  - Velox
                  price:
                    USD: 129.99
                  original_price:
                    USD: 149.99
                  stores:
                    main:
                      in_stock: 1
                      stock_count: 50
                    newyork:
                      price:
                        USD: 119.99
                      in_stock: 1
                      stock_count: 12
                    losangeles:
                      in_stock: 0
                      stock_count: 0
                pt_BR:
                  name: Velocity Runner Pro - Branco
                  category:
                  - Calçados
                  - Corrida
                  - Velox
                  price:
                    BRL: 899.9
                  original_price:
                    BRL: 999.9
                  stores:
                    main:
                      in_stock: 1
                      stock_count: 30
      responses:
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /v2/locales/batch:
    post:
      operationId: createLocaleConfigurations
      summary: Create Locale Configurations
      tags:
      - Catalog APIs
      description: 'The Catalog API allows you to create locale configurations. For larger or more complex setups, the Create Locale endpoint enables faster and more scalable locale management.


        Refer to Locales for further information.


        Endpoint and Headers

        POST https://catalog.api.useinsider.com/v2/locales/batch


        Header

        Sample Value

        Description


        X-PARTNER-NAME

        myParterName

        This is your partner name. Navigate to InOne > Inone Settings > Account Settings to copy your partner name. The partner name should be lowercase.


        X-REQUEST-TOKEN

        1a2b3c4d5e6f

        This key is required to authorize your request. Refer to API Authentication Tokens to generate your Catalog API token.


        Sample Request

        The sample below displays a request to create locale configurations:


        curl --request POST \

        --url https://catalog.api.useinsider.com/v2/locales/batch \

        --header ''Content-Type: application/json'' \

        --header ''X-PARTNER-NAME: your-partner-name'' \

        --header ''X-REQUEST-TOKEN: your-api-token'' \

        --data ''[

        {

        "language_and_country_code": "tr_TR",

        "store_id": "Ankara"

        },

        {

        "language_and_country_code": "en_US",

        "store_id": "Portland"

        }

        ]''


        Sample Response

        {

        "success": true,

        "created_locale_count": 2

        }


        Limitations

        For all the limits applied, refer to Limitations.'
      security:
      - PartnerName: []
      - RequestToken: []
      requestBody:
        content:
          text/plain:
            example: "'[\n    {\n        \"language_and_country_code\": \"tr_TR\",\n        \"store_id\": \"Ankara\"\n    },\n    {\n        \"language_and_country_code\": \"en_US\",\n        \"store_id\": \"Portland\"\n    }\n]'"
      responses:
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /v2/update:
    post:
      operationId: updateExistingProductsInAFlatFormat
      summary: Update Existing Products in a Flat Format
      tags:
      - Catalog APIs
      description: The Catalog API allows you to update existing products in your product catalog.
      security:
      - PartnerName: []
      - RequestToken: []
      requestBody:
        content:
          application/json:
            example:
            - item_id: velocity-runner-pro-white
              locale: en_US
              price:
                USD: 109.99
              in_stock: 0
      responses:
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /v2/update/nested:
    post:
      operationId: updateExistingProductsInANestedFormat
      summary: Update Existing Products in a Nested Format
      tags:
      - Catalog APIs
      description: The Catalog API allows you to update existing products in your product catalog using a nested format.
      security:
      - PartnerName: []
      - RequestToken: []
      requestBody:
        content:
          application/json:
            example:
            - item_id: velocity-runner-pro-white
              locales:
                en_US:
                  price:
                    USD: 109.99
                  stores:
                    newyork:
                      in_stock: 0
                      stock_count: 0
      responses:
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  responses:
    TooManyRequests:
      description: Too Many Requests. The published per-endpoint rate limit was exceeded; back off and retry, honouring Retry-After when present.
      content:
        application/json:
          example:
            message: Too Many Requests
            status: 429
  securitySchemes:
    PartnerName:
      type: apiKey
      in: header
      name: X-PARTNER-NAME
      description: Insider One partner (account) name, lowercase.
    RequestToken:
      type: apiKey
      in: header
      name: X-REQUEST-TOKEN
      description: Insider One API key (request token) generated in the InOne panel.
externalDocs:
  description: Insider One API reference
  url: https://academy.insiderone.com/docs/api-reference-welcome
x-provenance:
  generated: '2026-08-13'
  method: derived
  source: postman/insider-one-apis.postman_collection.json
  source_url: https://documenter.gw.postman.com/api/collections/24851117/2sB3dSR9bM
  publisher_page: https://developers.insiderone.com/
  note: Insider One publishes a single public Postman collection covering every REST API. This document is the subset of that collection served from catalog.api.useinsider.com.