CNC Compass Search API
The Search API from CNC Compass — 1 operation(s) for search.
The Search API from CNC Compass — 1 operation(s) for search.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/cnccompass-com:cnccompass-com-search-api"
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.
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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Cnccompass Com Search API
version: 1.2.0
license:
name: Data policy
url: /.well-known/ai-access.json
description: 'Operations tagged Search across 2 of this provider''s published API definitions: cnccompass-com-openapi.json, cnccompass-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://cnccompass.com
description: CNC Compass
tags:
- name: Search
paths:
/api/search:
get:
operationId: searchSuppliersGet
summary: Search suppliers (query string)
description: Same search as POST for clients that prefer a URL. `query` is accepted as an alias of `q`.
parameters:
- name: q
in: query
required: true
description: 'A CNC sourcing brief in natural language: material, process, quantity, tolerance, finish, or location. Example: ''500 black anodized 6061 aluminum housings, CNC milling, ±0.01 mm bores''.'
schema:
type: string
minLength: 3
maxLength: 5000
- name: limit
in: query
required: false
description: Records per page.
schema:
type: integer
minimum: 1
maximum: 20
default: 5
- name: offset
in: query
required: false
description: Records to skip.
schema:
type: integer
minimum: 0
maximum: 1000
default: 0
- name: material
in: query
required: false
description: 'Overrides the material parsed from the query. Matched against the facet vocabulary; an unmatched value is ignored and named in retrieval.ignored_fields. Example: aluminum 6061.'
schema:
type: string
maxLength: 80
- name: process
in: query
required: false
description: 'Overrides the process parsed from the query. Matched against the facet vocabulary; an unmatched value is ignored and named in retrieval.ignored_fields. Example: CNC turning.'
schema:
type: string
maxLength: 80
- name: finish
in: query
required: false
description: 'Overrides the finish parsed from the query. Matched against the facet vocabulary; an unmatched value is ignored and named in retrieval.ignored_fields. Example: anodizing.'
schema:
type: string
maxLength: 80
- name: location
in: query
required: false
description: 'Overrides the location parsed from the query. Matched against the facet vocabulary; an unmatched value is ignored and named in retrieval.ignored_fields. Example: Dongguan.'
schema:
type: string
maxLength: 80
responses:
'200':
description: Ranked supplier records for the brief.
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResponse'
'400':
description: Missing or invalid query, limit, or offset.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'413':
description: Request body larger than 16 KB.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'415':
description: POST body is not JSON.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: Rate limit reached for this IP address or API key.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'503':
description: Search service not configured or unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- apiKey: []
- {}
tags:
- Search
post:
operationId: searchSuppliers
summary: Search suppliers (JSON body)
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SearchRequest'
responses:
'200':
description: Ranked supplier records for the brief.
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResponse'
'400':
description: Missing or invalid query, limit, or offset.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'413':
description: Request body larger than 16 KB.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'415':
description: POST body is not JSON.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: Rate limit reached for this IP address or API key.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'503':
description: Search service not configured or unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- apiKey: []
- {}
tags:
- Search
servers:
- url: https://cnccompass.com
description: CNC Compass
components:
schemas:
SearchResponse:
properties:
answer:
title: Answer
type: string
brief:
$ref: '#/components/schemas/SearchBrief'
missing:
items:
type: string
title: Missing
type: array
follow_up_question:
anyOf:
- type: string
- type: 'null'
default: null
title: Follow Up Question
suppliers:
items:
$ref: '#/components/schemas/SupplierHit'
title: Suppliers
type: array
filters:
items:
$ref: '#/components/schemas/AppliedFilter'
title: Filters
type: array
offset:
default: 0
title: Offset
type: integer
limit:
default: 5
title: Limit
type: integer
has_more:
default: false
title: Has More
type: boolean
total_records:
default: 0
title: Total Records
type: integer
index_records:
default: 0
title: Index Records
type: integer
retrieval:
additionalProperties:
anyOf:
- type: string
- type: integer
title: Retrieval
type: object
required:
- answer
- brief
title: SearchResponse
type: object
SearchBrief:
properties:
material:
anyOf:
- type: string
- type: 'null'
default: null
title: Material
process:
anyOf:
- type: string
- type: 'null'
default: null
title: Process
finish:
anyOf:
- type: string
- type: 'null'
default: null
title: Finish
tolerance:
anyOf:
- type: string
- type: 'null'
default: null
title: Tolerance
quantity:
anyOf:
- type: integer
- type: 'null'
default: null
title: Quantity
location:
anyOf:
- type: string
- type: 'null'
default: null
title: Location
certification:
anyOf:
- type: string
- type: 'null'
default: null
title: Certification
title: SearchBrief
type: object
ErrorResponse:
type: object
title: ErrorResponse
required:
- ok
- error
properties:
ok:
type: boolean
const: false
error:
type: string
description: Human-readable reason the request was rejected.
Evidence:
properties:
label:
title: Label
type: string
quote:
title: Quote
type: string
source_url:
default: ''
title: Source Url
type: string
required:
- label
- quote
title: Evidence
type: object
SupplierHit:
properties:
slug:
title: Slug
type: string
name:
title: Name
type: string
location:
default: ''
title: Location
type: string
score:
title: Score
type: number
match_reasons:
items:
type: string
title: Match Reasons
type: array
matched_fields:
items:
type: string
title: Matched Fields
type: array
website_url:
default: ''
title: Website Url
type: string
website_kind:
default: ''
title: Website Kind
type: string
factory_verification:
default: ''
title: Factory Verification
type: string
inquiry_url:
default: ''
title: Inquiry Url
type: string
evidence:
items:
$ref: '#/components/schemas/Evidence'
title: Evidence
type: array
required:
- slug
- name
- score
title: SupplierHit
type: object
AppliedFilter:
description: One brief field used to filter records, with how many index records declare it.
properties:
field:
title: Field
type: string
label:
title: Label
type: string
keys:
items:
type: string
title: Keys
type: array
records:
default: 0
title: Records
type: integer
required:
- field
- label
title: AppliedFilter
type: object
SearchRequest:
properties:
query:
maxLength: 5000
minLength: 3
title: Query
type: string
description: 'A CNC sourcing brief in natural language: material, process, quantity, tolerance, finish, or location. Example: ''500 black anodized 6061 aluminum housings, CNC milling, ±0.01 mm bores''.'
limit:
default: 5
maximum: 20
minimum: 1
title: Limit
type: integer
description: Records per page.
offset:
default: 0
maximum: 1000
minimum: 0
title: Offset
type: integer
description: Records to skip. Resend the same query with the previous offset plus page length.
material:
anyOf:
- maxLength: 80
type: string
- type: 'null'
default: null
description: 'Optional. Overrides the material parsed from the query; matched against the facet vocabulary, an unmatched value is ignored and named in retrieval.ignored_fields. Example: aluminum 6061.'
title: Material
process:
anyOf:
- maxLength: 80
type: string
- type: 'null'
default: null
description: 'Optional. Overrides the process parsed from the query; matched against the facet vocabulary, an unmatched value is ignored and named in retrieval.ignored_fields. Example: CNC turning.'
title: Process
finish:
anyOf:
- maxLength: 80
type: string
- type: 'null'
default: null
description: 'Optional. Overrides the finish parsed from the query; matched against the facet vocabulary, an unmatched value is ignored and named in retrieval.ignored_fields. Example: anodizing.'
title: Finish
location:
anyOf:
- maxLength: 80
type: string
- type: 'null'
default: null
description: 'Optional. Overrides the location parsed from the query; matched against the facet vocabulary, an unmatched value is ignored and named in retrieval.ignored_fields. Example: Dongguan.'
title: Location
certification:
anyOf:
- maxLength: 80
type: string
- type: 'null'
default: null
description: 'Optional structured value that overrides what the query says for this field. Only holders are returned. Example: ISO 13485.'
title: Certification
required:
- query
title: SearchRequest
type: object
securitySchemes:
apiKey:
type: apiKey
in: header
name: X-Api-Key
description: Optional. Raises the anonymous per-IP quota.
x-refined-from:
- cnccompass-com-openapi.json
- cnccompass-com-openapi.yml