Conversor IAE CNAE Búsqueda API

Búsqueda híbrida (léxica + semántica) sobre los catálogos IAE y CNAE.

GitHub OpenAPI

Operations 1

GET /search Buscar códigos IAE/CNAE #

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/conversoriaecnae-es:conversoriaecnae-es-b-squeda-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

conversoriaecnae-es-b-squeda-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Conversoriaecnae Es Búsqueda API
  version: 1.0.0
  contact:
    name: Conversor IAE CNAE
    email: brian@conversoriaecnae.es
    url: https://www.conversoriaecnae.es/precios
  license:
    name: CC-BY-4.0
    url: https://creativecommons.org/licenses/by/4.0/
  termsOfService: https://www.conversoriaecnae.es/terminos-condiciones
  description: 'Operations tagged Búsqueda across 2 of this provider''s published API definitions: conversoriaecnae-es-openapi.json, conversoriaecnae-es-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.conversoriaecnae.es/api/v1
  description: Producción
security:
- ApiKeyAuth: []
tags:
- name: Búsqueda
  description: Búsqueda híbrida (léxica + semántica) sobre los catálogos IAE y CNAE.
paths:
  /search:
    get:
      operationId: searchCodes
      summary: Buscar códigos IAE/CNAE
      description: Búsqueda híbrida sobre los catálogos IAE y/o CNAE 2025. El parámetro `q` requiere al menos 2 caracteres.
      tags:
      - Búsqueda
      security:
      - ApiKeyAuth: []
      parameters:
      - name: q
        in: query
        required: true
        description: Texto de búsqueda (mínimo 2 caracteres).
        schema:
          type: string
          minLength: 2
          example: albañilería
      - name: type
        in: query
        required: false
        description: Catálogo a consultar.
        schema:
          type: string
          enum:
          - iae
          - cnae
          - both
          default: both
      - name: limit
        in: query
        required: false
        description: Número máximo de resultados (1–50).
        schema:
          type: integer
          minimum: 1
          maximum: 50
          default: 20
      responses:
        '200':
          description: Resultados de búsqueda
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
    servers:
    - url: https://www.conversoriaecnae.es/api/v1
      description: Producción
components:
  responses:
    RateLimited:
      description: Límite de cuota diaria o de ráfaga superado. La cabecera `Retry-After` indica los segundos hasta poder reintentar. El 429 por cuota diaria incluye además `X-RateLimit-Limit`, `X-RateLimit-Remaining` (0), `X-RateLimit-Reset` y `X-Conversor-Plan`.
      headers:
        Retry-After:
          description: 'Segundos hasta el siguiente reintento permitido (ráfaga: 1–12 s hasta el siguiente token, según plan; cuota diaria: hasta medianoche Europe/Madrid).'
          schema:
            type: integer
            example: 3600
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimitError'
    Unauthorized:
      description: Falta la cabecera `X-API-Key` o la clave es inválida/desactivada.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Missing X-API-Key header
    ServerError:
      description: Error interno del servidor.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Internal error
    BadRequest:
      description: Petición inválida (parámetro o cuerpo mal formado).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Invalid slug format
            _meta:
              plan: free
              remaining: 248
  schemas:
    Meta:
      type: object
      description: 'Metadatos del envelope para endpoints con clave: plan actual, cuota restante y días restantes de la prueba (solo plan trial) y nudge de upgrade a Empresa (solo plan Profesional al ≥80% de cuota).'
      required:
      - plan
      - remaining
      properties:
        plan:
          type: string
          example: free
          description: Plan de la clave (free, trial, profesional, empresa, enterprise). `trial` = prueba Profesional de 14 días sin tarjeta; al terminar, la clave pasa a free.
        remaining:
          type: integer
          example: 248
          description: Peticiones restantes de la cuota diaria.
        trial_ends_in_days:
          type: integer
          minimum: 0
          example: 9
          description: Días completos que quedan de la prueba Profesional (redondeo hacia arriba). Presente solo con plan `trial`.
        upgrade_hint:
          type: string
          description: 'Mensaje legible de upgrade a Empresa. Presente solo en plan Profesional al consumir ≥80% de la cuota. Las claves Free ya no reciben este nudge: ven el campo bloqueado (`locked: true`) en `associated_cnae` / `associated_iae`.'
          example: 'Estás usando más del 80% de tu cuota diaria de Profesional. Empresa (79€/mes) amplía a 300.000 consultas/mes: https://www.conversoriaecnae.es/precios.'
        upgrade:
          $ref: '#/components/schemas/UpgradeMeta'
    Error:
      type: object
      description: Cuerpo de error estándar de endpoints con clave.
      required:
      - error
      properties:
        error:
          type: string
          example: IAE code not found
        _meta:
          $ref: '#/components/schemas/Meta'
    UpgradeMeta:
      type: object
      description: Forma estructurada del nudge de upgrade para renderizar UI nativa. Presente solo en plan Profesional al ≥80% de cuota (nudge a Empresa).
      properties:
        hint:
          type: string
        url:
          type: string
          format: uri
          example: https://www.conversoriaecnae.es/precios
        current_plan:
          type: string
          example: free
        recommended_plan:
          type: object
          properties:
            id:
              type: string
              example: profesional
            label:
              type: string
              example: Profesional
            daily_limit:
              type: integer
              example: 2000
            monthly_price_eur:
              type: integer
              example: 29
        daily_limit_after:
          type: integer
          example: 2000
        price_eur_monthly:
          type: integer
          example: 29
    RateLimitError:
      type: object
      required:
      - error
      properties:
        error:
          type: string
          example: Rate limit exceeded
        limit:
          type: integer
          example: 250
        plan:
          type: string
          example: free
        retry_after_seconds:
          type: integer
          example: 3600
        current_plan_label:
          type: string
          example: Free (250 peticiones/día)
        upgrade_url:
          type: string
          format: uri
          example: https://www.conversoriaecnae.es/precios
        recommended_plan:
          type: object
          properties:
            id:
              type: string
              example: profesional
            label:
              type: string
              example: Profesional
            daily_limit:
              type: integer
              example: 2000
            monthly_price_eur:
              type: integer
              example: 29
    SearchResponse:
      type: object
      properties:
        query:
          type: string
          example: albañilería
        type:
          type: string
          enum:
          - iae
          - cnae
          - both
          example: both
        count:
          type: integer
          example: 12
        results:
          type: array
          items:
            $ref: '#/components/schemas/SearchResult'
        _meta:
          $ref: '#/components/schemas/Meta'
    SearchResult:
      type: object
      description: Resultado de búsqueda. Incluye las columnas del RPC `search_*_codes` más un campo `type`.
      additionalProperties: true
      properties:
        type:
          type: string
          enum:
          - iae
          - cnae
          example: iae
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Clave de API con prefijo `cvr_`. Obtén una gratis en POST /signup.
x-refined-from:
- conversoriaecnae-es-openapi.json
- conversoriaecnae-es-openapi.yml