API Reference

API Documentation

RESTful API for programmatic access to the SpecBase product database. Built for AI agents, integrations, and automation.

Authentication

Include your API key in the request headers. API keys are free for basic read access.

X-API-Key: your-api-key-here

During the beta period, API requests work without authentication for read-only endpoints.

Base URL

https://specbase.co/api/v1

All responses are JSON. Successful responses include success: true with data in the data field.

Rate Limits

All API requests are rate-limited to ensure fair usage.

Rate limit60 requests per minute per IP
Page sizeMax 50 results per page
PaginationMax 25 pages per query

Need higher limits? Contact us for enterprise access.

Endpoints

GET/api/v1/products

List and filter products

Parameters: category, manufacturer, q, page, limit, sort

Request

GET /api/v1/products?category=motors&manufacturer=abb&limit=10

Response

{
  "success": true,
  "data": [
    {
      "id": "prod-abb-m3bp-315",
      "model_number": "M3BP 315 SMC 4",
      "name": "ABB M3BP 315 Process Performance Motor",
      "specifications": {
        "horsepower": 250,
        "voltage": "460V",
        "efficiency_class": "IE3"
      },
      "manufacturer": { "name": "ABB", "slug": "abb" }
    }
  ],
  "meta": { "total": 2, "page": 1, "limit": 10 }
}
GET/api/v1/products/:id

Get a single product with full specifications

Parameters: id (path parameter)

Request

GET /api/v1/products/prod-abb-m3bp-315

Response

{
  "success": true,
  "data": {
    "id": "prod-abb-m3bp-315",
    "model_number": "M3BP 315 SMC 4",
    "name": "ABB M3BP 315 Process Performance Motor",
    "specifications": { ... },
    "manufacturer": { ... },
    "category": { ... }
  }
}
GET/api/v1/search

Simple text search across all products

Parameters: q (search query), category, manufacturer, page, limit

Request

GET /api/v1/search?q=50+HP+TEFC+460V+motor&limit=10

Response

{
  "success": true,
  "data": {
    "products": [ ... ],
    "facets": {
      "categories": [{"name": "Motors", "count": 5}],
      "manufacturers": [{"name": "ABB", "count": 2}, ...]
    }
  },
  "meta": { "total": 5 }
}
POST/api/v1/search

AI-optimized structured search with spec filters

Parameters: JSON body: query, category, manufacturer, specs, page, limit

Request

POST /api/v1/search
Content-Type: application/json

{
  "category": "motors",
  "specs": {
    "horsepower_min": 20,
    "horsepower_max": 100,
    "voltage": "460V",
    "enclosure_type": "TEFC"
  },
  "manufacturer": "siemens"
}

Response

{
  "success": true,
  "data": {
    "products": [ ... ],
    "facets": {
      "categories": [{"name": "Motors", "count": 2}],
      "manufacturers": [{"name": "Siemens", "count": 2}]
    },
    "available_spec_filters": [
      "motor_type", "horsepower", "voltage", ...
    ]
  },
  "meta": { "total": 2 }
}
POST/api/v1/crossover

Find crossover/alternative products by model number

Parameters: JSON body: model_number, limit (optional, max 20)

Request

POST /api/v1/crossover
Content-Type: application/json

{
  "model_number": "EM3615T",
  "limit": 5
}

Response

{
  "success": true,
  "data": {
    "source": {
      "id": "prod-baldor-em3615t",
      "model_number": "EM3615T",
      "name": "Baldor EM3615T Motor",
      "specifications": { ... }
    },
    "crossovers": [
      {
        "product": { ... },
        "matchScore": 87,
        "matchedSpecs": ["Horsepower", "Voltage", "Frame Size"],
        "mismatchedSpecs": ["Efficiency"]
      }
    ],
    "total_matches": 3
  }
}
GET/api/v1/categories

List all product categories with product counts

Parameters: None

Request

GET /api/v1/categories

Response

{
  "success": true,
  "data": [
    { "id": "cat-motors", "name": "Motors", "slug": "motors", "product_count": 8 },
    { "id": "cat-gearboxes", "name": "Gearboxes", "slug": "gearboxes", "product_count": 5 }
  ]
}
GET/api/v1/manufacturers

List manufacturers, optionally filtered by category

Parameters: category (optional)

Request

GET /api/v1/manufacturers?category=cat-motors

Response

{
  "success": true,
  "data": [
    { "id": "mfr-abb", "name": "ABB", "slug": "abb", "product_count": 2 },
    { "id": "mfr-siemens", "name": "Siemens", "slug": "siemens", "product_count": 2 }
  ]
}
POST/api/v1/compare

Compare multiple products side by side

Parameters: JSON body: product_ids (array of 2-5 product IDs)

Request

POST /api/v1/compare
Content-Type: application/json

{
  "product_ids": [
    "prod-abb-m3bp-315",
    "prod-siemens-1le1"
  ]
}

Response

{
  "success": true,
  "data": {
    "products": [ ... ],
    "comparison_fields": [
      "motor_type", "horsepower", "voltage", ...
    ]
  }
}
GET/api/v1/openapi

Full OpenAPI 3.1 specification for all endpoints

Parameters: None

Request

GET /api/v1/openapi

Response

{
  "openapi": "3.1.0",
  "info": {
    "title": "SpecBase API",
    "version": "1.0.0",
    ...
  },
  "paths": { ... }
}

AI Integrations

Connect SpecBase directly to AI agents and tools.

MCP

Model Context Protocol Server

SpecBase exposes an MCP server that AI agents (Claude, Cursor, Windsurf, etc.) can connect to directly. The server provides tools for searching products, finding crossovers, and comparing specifications.

Manifest URL

https://specbase.co/.well-known/mcp.json

Server Endpoint

https://specbase.co/api/mcp

Available Tools

search_productsSearch with category, spec, and manufacturer filters
get_productGet full product details by ID
find_crossoverFind alternative products by model number
compare_productsSide-by-side comparison of 2-5 products
list_categoriesAll product categories with counts
list_manufacturersAll manufacturers, filterable by category
GPT

ChatGPT Action

Add SpecBase as a Custom GPT Action to search industrial components directly from ChatGPT.

Plugin Manifest

https://specbase.co/.well-known/ai-plugin.json

OpenAPI Spec

https://specbase.co/api/v1/openapi

To set up: Create a Custom GPT in ChatGPT → Add Action → Import from URL → paste the OpenAPI spec URL above. No authentication required.

Ready to integrate?

Get your free API key and start querying the SpecBase database.

Request API Key