Ambolt NACE API

openapi: 3.2.0
info:
  title: Ambolt data tools NACE API
  version: 0.1.1
  description: Pay-per-call data endpoints using the x402 protocol (USDC on Base, Polygon and Solana). Failed calls are not charged.
  x-guidance: 'Call GET /v1/<tool> with the documented query parameters. Without payment the response is 402 with the price and payment requirements; an x402 client pays in USDC and retries. Add free=1 for one free call per tool and IP per day. Company, tender, document, rates, on-chain and web tools; every response carries source and date. The same tools are available as MCP tools at /mcp (free, 30 requests a minute) and as Apify Actors. Company-level data only: no personal data.'
  contact:
    email: hello@ambolt.dev
    url: https://ambolt.dev
servers:
- url: https://api.ambolt.dev
security: []
tags:
- name: NACE
paths:
  /v1/industry-code-lookup:
    get:
      operationId: industry_code_lookup
      summary: 'NACE Code Lookup and Crosswalk: Rev. 2 to 2.1, ISIC'
      description: 'Look up an industry code in NACE Rev. 2.1, NACE Rev. 2 or UK SIC 2007: label in any of 24 EU languages, section, division and group, what the class includes and excludes, the matching codes in the other revision (with a flag when one old class is split across new ones) and ISIC Rev. 4. Search by code or by words. Official EU Vocabularies data, CC BY 4.0.'
      tags:
      - NACE
      parameters:
      - name: code
        in: query
        required: false
        schema:
          type: string
          maxLength: 12
          description: A NACE code such as 62.10, 6210, 62.1, 62 or J, or a five-digit UK SIC 2007 code such as 62012.
        description: A NACE code such as 62.10, 6210, 62.1, 62 or J, or a five-digit UK SIC 2007 code such as 62012.
      - name: query
        in: query
        required: false
        schema:
          type: string
          maxLength: 120
          description: Words to search for instead of a code, in any EU language (for example software or Programmierung).
        description: Words to search for instead of a code, in any EU language (for example software or Programmierung).
      - name: codes
        in: query
        required: false
        schema:
          type: array
          maxItems: 100
          items:
            type: string
            maxLength: 12
          description: Up to 100 codes in one run (Apify Actor only). Each code that is found is one billable result.
        description: Up to 100 codes in one run (Apify Actor only). Each code that is found is one billable result.
      - name: scheme
        in: query
        required: false
        schema:
          type: string
          enum:
          - nace-2.1
          - nace-2
          - uk-sic-2007
          default: nace-2.1
          description: Which classification the code or search belongs to. UK SIC 2007 codes have five digits and map to NACE Rev. 2.
        description: Which classification the code or search belongs to. UK SIC 2007 codes have five digits and map to NACE Rev. 2.
      - name: language
        in: query
        required: false
        schema:
          type: string
          enum:
          - bg
          - cs
          - da
          - de
          - el
          - en
          - es
          - et
          - fi
          - fr
          - ga
          - hr
          - hu
          - it
          - lt
          - lv
          - mt
          - nl
          - pl
          - pt
          - ro
          - sk
          - sl
          - sv
          - all
          default: en
          description: Label language (ISO 639-1 code of an EU language), or all for every language.
        description: Label language (ISO 639-1 code of an EU language), or all for every language.
      - name: includeNotes
        in: query
        required: false
        schema:
          type: boolean
          default: false
          description: Add the explanatory notes (what the class includes and excludes, in English).
        description: Add the explanatory notes (what the class includes and excludes, in English).
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 50
          default: 10
          description: Maximum search results for a words query.
        description: Maximum search results for a words query.
      - name: free
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
        description: Set to 1 for one free call per tool and IP address per day (no payment).
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.003000'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Result (JSON). Every result names its source and the time it was read.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid input; not charged.
        '402':
          description: 'Payment required: 0.003 USD in USDC (x402 v2).'