Indicadores Argentina Busqueda API

openapi: 3.2.0
info:
  title: Indicadores Ar Busqueda API
  version: '1.1'
  contact:
    email: contacto@indicadores.ar
    url: https://indicadores.ar/api-empresas
  description: 'Operations tagged Busqueda across 2 of this provider''s published API definitions: indicadores-ar-openapi.json, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://indicadores.ar/v1
security:
- apiKey: []
tags:
- name: Busqueda
paths:
  /busqueda:
    get:
      operationId: busqueda
      summary: Búsqueda de empresas con filtros combinables
      description: 'Búsqueda sobre el padrón completo (~1,3M de empresas). Todos los parámetros son opcionales y se combinan entre sí (AND): texto, forma legal, ubicación, actividad, estado fiscal, rango de capital, los sellos booleanos (importador, exportador, empleador, contratista del Estado, deuda BCRA…) y una zona (un círculo con `cerca` y `radio_km`, un recuadro o un departamento). Devuelve 10 resultados por página con los créditos gratis de alta, hasta la página 3, y 50 para cuentas con packs o plan pago. Para el detalle completo de una empresa usá /empresa con su CUIT.


        Costo: 1 crédito por página.'
      parameters:
      - name: q
        in: query
        description: Búsqueda textual por razón social.
        schema:
          type: string
      - name: forma_legal
        in: query
        description: Forma legal. Acepta la sigla con puntos o en mayúsculas (S.R.L., SA); un valor que no es ninguno de la lista es un 400 `forma_legal_invalida`, nunca una búsqueda sin el filtro.
        schema:
          type: string
          enum:
          - sa
          - srl
          - sas
          - sca
          - scs
          - sociedad_colectiva
          - cooperativa
          - fundacion
          - asociacion_civil
          - mutual
          - ute
          - fideicomiso
          - sucursal_extranjera
          - other
          - sociedad_capital_industria
          - sociedad_estado
          - sociedad_hecho
          - sociedad_seccion_iv
          - federacion
          - camara
          - religiosa
          - agrupacion_colaboracion
          - consorcio_cooperacion
          - consorcio_ph
          - sgr
          - capitalizacion_ahorro
          - sucursal_nacional
          - persona_humana
          - profesional_matriculado
          example: sas
      - name: jurisdiccion
        in: query
        description: 'Provincia o Ciudad Autónoma de Buenos Aires. Acepta las variantes de uso (CABA, Capital Federal, Bs As, sin tildes ni mayúsculas); un valor que no es ninguna de las 24 jurisdicciones es un 400 `jurisdiccion_invalida` con la lista. Valores canónicos: Ciudad Autónoma de Buenos Aires, Buenos Aires, Catamarca, Chaco, Chubut, Córdoba, Corrientes, Entre Ríos, Formosa, Jujuy, La Pampa, La Rioja, Mendoza, Misiones, Neuquén, Río Negro, Salta, San Juan, San Luis, Santa Cruz, Santa Fe, Santiago del Estero, Tierra del Fuego, Tucumán.'
        schema:
          type: string
          example: Córdoba
      - name: ciudad
        in: query
        description: Ciudad o localidad.
        schema:
          type: string
      - name: actividad
        in: query
        description: Código de actividad AFIP. Matchea la actividad principal (`actividad.codigo`) y también cualquiera de las vigentes que la empresa declara ante ARCA (`actividades[].codigo` de la ficha). Hasta 6 dígitos, con o sin los ceros de adelante (011211 y 11211 son el mismo código); otra cosa es un 400 `actividad_invalida`.
        schema:
          type: string
          example: '620100'
      - name: estado_fiscal
        in: query
        description: Estado ante ARCA. Un valor fuera de la lista es un 400 `estado_fiscal_invalido`.
        schema:
          type: string
          enum:
          - activa
          - inactiva
          - baja
          - suspendida
          - unknown
      - name: capital
        in: query
        description: Rango de capital del último balance publicado (excluye empresas sin balance; un valor fuera de la lista es un 400 `capital_invalido`). lt-1m = Menos de $1M, 1m-10m = $1M a $10M, 10m-100m = $10M a $100M, gt-100m = Más de $100M.
        schema:
          type: string
          enum:
          - lt-1m
          - 1m-10m
          - 10m-100m
          - gt-100m
      - name: importador
        in: query
        description: true = solo empresas con el sello "Importadora". Con despachos de importación registrados a su CUIT.
        schema:
          type: boolean
      - name: exportador
        in: query
        description: true = solo empresas con el sello "Exportadora". Con exportaciones registradas o habilitación de exportador.
        schema:
          type: boolean
      - name: empleador
        in: query
        description: 'true = solo empresas con el sello "Empleadora". Declarada empleadora ante ARCA. Cobertura parcial: el dato se conoce para las empresas ya enriquecidas con el padrón fiscal, no para todo el universo.'
        schema:
          type: boolean
      - name: contratista
        in: query
        description: true = solo empresas con el sello "Contratista del Estado". Con contratos u órdenes de compra del Estado adjudicados (no cuenta ofertas sin adjudicación).
        schema:
          type: boolean
      - name: deuda_bcra
        in: query
        description: true = solo empresas con el sello "Con deuda BCRA". Con deuda informada por alguna entidad en la central de deudores del BCRA.
        schema:
          type: boolean
      - name: cheque_rechazado
        in: query
        description: true = solo empresas con el sello "Con cheques rechazados". Con cheques rechazados informados por el BCRA.
        schema:
          type: boolean
      - name: concurso_quiebra
        in: query
        description: true = solo empresas con el sello "En concurso o quiebra". Con concurso preventivo o quiebra publicados en boletines oficiales.
        schema:
          type: boolean
      - name: sancionada
        in: query
        description: true = solo empresas con el sello "Sancionada (UIF/CNV/BCRA)". Con sanciones administrativas publicadas.
        schema:
          type: boolean
      - name: apoc
        in: query
        description: true = solo empresas con el sello "En base APOC". Incluida en la base APOC de ARCA (facturas apócrifas).
        schema:
          type: boolean
      - name: repsal
        in: query
        description: true = solo empresas con el sello "Sanciones laborales (REPSAL)". Con sanciones vigentes en el Registro Público de Empleadores con Sanciones Laborales.
        schema:
          type: boolean
      - name: pep
        in: query
        description: true = solo empresas con el sello "Vinculada a funcionario (PEP)". Con al menos un dirigente identificado como persona expuesta políticamente.
        schema:
          type: boolean
      - name: cerca
        in: query
        description: 'Las empresas dentro de un círculo: latitud y longitud del centro en grados decimales. Se compara contra el domicilio desde el que opera cada sociedad. Va con `radio_km`; no se combina con `recuadro` ni `departamento` (400 `zona_duplicada`).'
        schema:
          type: string
          example: -34.6037,-58.3816
      - name: radio_km
        in: query
        description: 'Radio del círculo de `cerca`, en kilómetros: mayor que 0 y hasta 50. Por defecto 1.'
        schema:
          type: string
          example: '2.5'
      - name: recuadro
        in: query
        description: 'Las empresas dentro de un recuadro: oeste,sur,este,norte en grados decimales, de hasta 25 grados² (fuera de eso, 400 `recuadro_invalido`).'
        schema:
          type: string
          example: -58.53,-34.71,-58.33,-34.53
      - name: departamento
        in: query
        description: 'Las empresas de un departamento o partido: el código INDEC de 5 dígitos (el mismo que devuelve `geo.departamento_id` en /empresa con `campos=geo`).'
        schema:
          type: string
          example: '06441'
      - name: pagina
        in: query
        description: Página (1-400). Fuera de rango se ajusta al máximo, no da error. Con sólo los créditos gratis de bienvenida, de la 4 en adelante es 402 `pagina_requiere_creditos_comprados`, sin cobro.
        schema:
          type: integer
          default: 1
          maximum: 400
      responses:
        '200':
          description: Búsqueda de empresas con filtros combinables.
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                    description: Total real de resultados del filtro, aunque no sea todo navegable.
                  pagina:
                    type: integer
                  por_pagina:
                    type: integer
                  total_paginas:
                    type: integer
                  total_exacto:
                    type: boolean
                    description: 'false si el conteo no terminó a tiempo: `total` y `total_paginas` son entonces un piso, no el total. Seguí paginando mientras la página venga llena; repetir el pedido unos segundos después suele traer el total real.'
                  resultados:
                    type: array
                    items:
                      type: object
                      properties:
                        cuit:
                          type: string
                        razon_social:
                          type: string
                        forma_legal:
                          type:
                          - string
                          - 'null'
                        jurisdiccion:
                          type:
                          - string
                          - 'null'
                        ciudad:
                          type:
                          - string
                          - 'null'
                        actividad:
                          type: object
                          properties:
                            codigo:
                              type:
                              - string
                              - 'null'
                            nombre:
                              type:
                              - string
                              - 'null'
                        fecha_constitucion:
                          type:
                          - string
                          - 'null'
                          format: date
                        capital_ultimo_balance:
                          type:
                          - string
                          - 'null'
                        estado_fiscal:
                          type: string
        '400':
          $ref: '#/components/responses/ParametroInvalido'
        '401':
          $ref: '#/components/responses/NoAutorizado'
        '402':
          $ref: '#/components/responses/SinCreditos'
        '429':
          $ref: '#/components/responses/RateLimit'
        '500':
          $ref: '#/components/responses/ErrorInterno'
        '503':
          $ref: '#/components/responses/NoDisponible'
      tags:
      - Busqueda
    servers:
    - url: https://indicadores.ar/v1
components:
  responses:
    RateLimit:
      description: limite_de_requests_excedido (por minuto), limite_diario_gratuito_excedido (endpoints gratis) o limite_diario_autoservicio_excedido (cupo diario de créditos por cuenta).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NoAutorizado:
      description: api_key_faltante, api_key_malformada (la key llegó cortada o con otro formato) o api_key_invalida (no existe o fue revocada).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    SinCreditos:
      description: Créditos insuficientes.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ParametroInvalido:
      description: Parámetro inválido.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ErrorInterno:
      description: error_interno. Reintentar; no se cobra.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NoDisponible:
      description: servicio_no_disponible (transitorio, con Retry-After) o padron_no_disponible (el CUIT no está en nuestro padrón y el padrón fiscal no respondió a tiempo) o consulta_demorada (la búsqueda superó su tope de tiempo). Reintentar; no se cobra.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
  securitySchemes:
    apiKey:
      type: apiKey
      name: api-key
      in: header
      description: API key creada en https://indicadores.ar/api-empresas
x-refined-from:
- indicadores-ar-openapi.json
- openapi.json