CNC Compass Search API

The Search API from CNC Compass — 1 operation(s) for search.

GitHub OpenAPI

Operations 2

GET /api/search Search suppliers (query string) #
POST /api/search Search suppliers (JSON body) #

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/cnccompass-com:cnccompass-com-search-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. See our Privacy Policy and Terms.

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

OpenAPI Specification

cnccompass-com-search-api-openapi.yml Raw ↑
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