API Documentation

BETA

Query verified product data across industries

Overview

The Notched API provides access to manufacturer-verified product data with full provenance tracking. Every response includes data source, verification timestamps, and consent documentation.

Base URL: https://api.notched.ai/v1

Authentication

All API requests require an API key passed in the header:

Authorization: Bearer YOUR_API_KEY

API keys are issued upon approval. Request access to get started.

Endpoints

GET /products

Search and filter products across all verticals

GET /products/{nid}

Retrieve a single product by Notched ID

GET /manufacturers

List verified manufacturers in the registry

GET /verticals

List available product verticals and schemas

Query Parameters

Parameter	Type	Description
`vertical`	string	Filter by vertical (e.g., sewing-patterns, cosmetics)
`manufacturer`	string	Filter by manufacturer slug
`q`	string	Semantic search query
`limit`	integer	Results per page (default: 20, max: 100)
`offset`	integer	Pagination offset

Example Request

curl -X GET "https://api.notched.ai/v1/products?vertical=sewing-patterns&q=wrap+dress" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "data": [
    {
      "nid": "SINCLAIR-JOLENE-WRAP",
      "manufacturer": {
        "name": "Sinclair Patterns",
        "verified": true
      },
      "basic": {
        "name": "Jolene Wrap Dress",
        "category": "sewing-patterns",
        "type": "dress"
      },
      "specifications": {
        "skill_level": "intermediate",
        "sizes": ["00", "02", "04", "06", "08", "10", "12", "14"],
        "fabric_type": ["knit", "woven"]
      },
      "provenance": {
        "source": "manufacturer_direct",
        "last_verified": "2026-01-10T12:00:00Z"
      }
    }
  ],
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0
  }
}

Rate Limits

Beta access includes:

Requests per minute 60

Requests per day 10,000

Higher limits available for production integrations. Contact us to discuss your needs.

Verticals Available

Vertical	Status	Products
Sewing Patterns	Live	271+
Cosmetics	Coming soon	-
Cycling	Coming soon	-

Ready to integrate?

Request API access and start querying verified product data.

Request API Access