commonspecs API

Bearer-token REST API for resolving, searching and comparing products and services in the commonspecs specifications database, with endpoints such as /v1/get_product, /v1/search_products and /v1/compare_products. The same database is exposed as a remote MCP server at https://api.commonspecs.com/mcp.

GitHub OpenAPI

Operations 1

POST /v1/get_product POST /v1/get_product #

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/commonspecs-com:commonspecs-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

commonspecs-com-openapi-generated.yml Raw ↑
openapi: 3.1.0
info:
  title: commonspecs API
  version: '2026-11-04'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-04: 1 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; commonspecs has published no machine-readable contract that the
    pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 1
    documentation: 0
    pages-with-code: 2
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-04'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://commonspecs.com/docs/api
  - https://commonspecs.com/pl/docs/api
servers:
- url: https://api.commonspecs.com
paths:
  /v1/get_product:
    post:
      operationId: post_v1_get_product
      tags:
      - Get Product
      summary: POST /v1/get_product
      x-source: https://commonspecs.com/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1GetProductRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST https://api.commonspecs.com/v1/get_product  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json"  -d
          ''{"ean":"<EAN/GTIN>"}'' POST /v1/search_products query searches by brand, item name or category name — products and services alike.
          category browses one category by its identifier. Category identifiers come back in matched_categories (a hit) or did_you_mean (a miss).
          fi'
components:
  schemas:
    PostV1GetProductRequest:
      type: object
      properties:
        ean:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Get Product