Descripción general

Guía completa para buscar y obtener logotipos de empresas, fondos y criptomonedas utilizando diversos identificadores

​

Introducción

La API de logos de Benzinga proporciona acceso a logotipos de alta calidad para compañías, fondos y criptomonedas. Puedes buscar logotipos utilizando múltiples tipos de identificadores, incluidos símbolos, números CIK, códigos ISIN, CUSIP, FIGI y más.

​

Endpoints disponibles

​

/logos/search

Busca logotipos usando distintos identificadores. Devuelve URLs de logotipos, detalles de los valores y metadatos.

​

/logos/sync

Endpoint de sincronización en lote para obtener varios logotipos con soporte de paginación.

​

Filtros de búsqueda

La API permite realizar búsquedas flexibles mediante dos parámetros principales:

• search_keys - El valor del identificador que quieres buscar
• search_keys_type - El tipo de identificador (opcional; el valor predeterminado es symbol)

​

1. Filtrar por símbolo

Busca logotipos utilizando símbolos de ticker bursátiles.

Parámetros:

• search_keys: Símbolo (p. ej., AAPL, TSLA, MSFT)
• search_keys_type: symbol (opcional, este es el valor predeterminado)

Ejemplo:

GET /api/v2/logos/search?search_keys=AAPL&search_keys_type=symbol&fields=logo_light,logo_dark

​

2. Filtrar por CIK

Busca usando la Central Index Key (CIK) de la SEC. Admite valores con y sin ceros a la izquierda.

Parámetros:

• search_keys: número de CIK (por ejemplo, 320193 o 0000320193)
• search_keys_type: cik

Ejemplo:

GET /api/v2/logos/search?search_keys=320193&search_keys_type=cik&fields=logo_light,logo_dark

Ejemplo con CIK con ceros a la izquierda:

GET /api/v2/logos/search?search_keys=0000320193&search_keys_type=cik&fields=logo_light,logo_dark

​

3. Filtrar por ISIN

Busca utilizando el Número Internacional de Identificación de Valores (ISIN).

Parámetros:

• search_keys: código ISIN (por ejemplo, US0378331005)
• search_keys_type: isin

Ejemplo:

GET /api/v2/logos/search?search_keys=US0378331005&search_keys_type=isin&fields=logo_light,logo_dark

​

4. Filtrar por clase de acción FIGI

Busca usando el Identificador Global de Instrumentos Financieros (FIGI) de Bloomberg para clases de acciones.

Parámetros:

• search_keys: ID de clase de acción FIGI (por ejemplo, BBG001SQKGD7)
• search_keys_type: figi_share_class

Ejemplo:

GET /api/v2/logos/search?search_keys=BBG001SQKGD7&search_keys_type=figi_share_class&fields=logo_light,logo_dark

​

5. Filtrar por CUSIP

Busque usando el número CUSIP (Committee on Uniform Securities Identification Procedures).

Parámetros:

• search_keys: número CUSIP (por ejemplo, 88160R101)
• search_keys_type: cusip

Ejemplo:

GET /api/v2/logos/search?search_keys=88160R101&search_keys_type=cusip&fields=logo_light,logo_dark

​

6. Filtrar por símbolo con moneda y país

Especifique los símbolos con códigos de país o moneda usando dos puntos (:) o punto (.) como delimitador.

Parámetros:

• search_keys: símbolo con calificador (por ejemplo, AAPL:US, AAPL:USD, AAPL.US)
• search_keys_type: symbol

Ejemplos:

GET /api/v2/logos/search?search_keys=AAPL:US&search_keys_type=symbol&fields=logo_light,logo_dark
GET /api/v2/logos/search?search_keys=AAPL:USD&search_keys_type=symbol&fields=logo_light,logo_dark
GET /api/v2/logos/search?search_keys=AAPL.US&search_keys_type=symbol&fields=logo_light,logo_dark

​

7. Filtrar por Exchange y símbolo

Realiza búsquedas combinando el código de exchange con el símbolo. Admite formatos tanto de estilo Bloomberg (legado) como de estilo LSEG.

Mapeo estilo Bloomberg (legado):

• search_keys: Exchange y símbolo (p. ej., NASDAQ:AAPL)
• search_keys_type: symbol

Código LSEG de 3 caracteres (actual):

• search_keys: Código de exchange y símbolo (p. ej., NSQ:AAPL)
• search_keys_type: symbol

Ejemplos:

GET /api/v2/logos/search?search_keys=NASDAQ:AAPL&search_keys_type=symbol&fields=logo_light,logo_dark
GET /api/v2/logos/search?search_keys=NSQ:AAPL&search_keys_type=symbol&fields=logo_light,logo_dark

​

8. Filtrar por ISO MIC y símbolo

Buscar mediante el código MIC (ISO Market Identifier Code) combinado con el símbolo.

Parámetros:

• search_keys: código MIC y símbolo (por ejemplo, XYNS:AAPL)
• search_keys_type: symbol

Ejemplo:

GET /api/v2/logos/search?search_keys=XYNS:AAPL&search_keys_type=symbol&fields=logo_light,logo_dark

​

9. Filtros de logotipos de criptomonedas

Busca logotipos de criptomonedas utilizando diversos formatos. La API reconoce automáticamente los formatos de criptomonedas incluso cuando no se especifica search_keys_type.

Formatos compatibles:

• CRYPTO:BTC
• CRYPTO/BTC
• $BTC
• BTC/USD

Ejemplos:

GET /api/v2/logos/search?search_keys=CRYPTO:BTC&fields=logo_light,logo_dark
GET /api/v2/logos/search?search_keys=CRYPTO/BTC&fields=logo_light,logo_dark
GET /api/v2/logos/search?search_keys=$BTC&fields=logo_light,logo_dark
GET /api/v2/logos/search?search_keys=BTC/USD&fields=logo_light,logo_dark

​

Campos disponibles

Puede solicitar tipos específicos de logotipos usando el parámetro fields. Los campos disponibles incluyen:

• logo_light - Logotipo para tema claro (PNG)
• logo_dark - Logotipo para tema oscuro (PNG)
• logo_vector_light - Logotipo vectorial para tema claro (SVG)
• logo_vector_dark - Logotipo vectorial para tema oscuro (SVG)
• mark_light - Marca/ícono para tema claro (PNG)
• mark_dark - Marca/ícono para tema oscuro (PNG)
• mark_vector_light - Marca vectorial para tema claro (SVG)
• mark_vector_dark - Marca vectorial para tema oscuro (SVG)
• mark_composite_light - Marca compuesta para tema claro (PNG)
• mark_composite_dark - Marca compuesta para tema oscuro (PNG)
• mark_vector_composite_light - Marca vectorial compuesta para tema claro (SVG)
• mark_vector_composite_dark - Marca vectorial compuesta para tema oscuro (SVG)

Ejemplo de solicitud de varios campos:

GET /api/v2/logos/search?search_keys=TSLA&fields=logo_light,logo_dark,mark_vector_composite_light

​

Parámetros adicionales

​

Personalización de la imagen

• scale - Escala la imagen (por ejemplo, 100x100, 300x300)
• max_width - Ancho máximo de la imagen devuelta
• composite_radius - Radio de borde para las imágenes compuestas (entero, rango 0-50)
• composite_auto - Genera imágenes compuestas automáticamente (booleano)

​

Paginación (solo para sincronización masiva)

• page - Número de página (entero)
• pagesize - Número de resultados por página (entero)
• updated_since - Filtrar por marca de tiempo de actualización (formato ISO 8601)

​

Detalles de valores

• securities - Incluir información detallada de los valores en la respuesta (booleano)

​

Ejemplos de respuesta

​

200 Respuesta exitosa

{
  "ok": true,
  "data": [
    {
      "id": "efc3943a-ddac-4f59-a2cc-47a67583068b",
      "search_key": "TSLA",
      "securities": [
        {
          "symbol": "TSLA",
          "name": "TESLA INC",
          "cik": "1318605",
          "exchange": "NASDAQ",
          "mic_code": "XNAS",
          "exchange_name": "NASDAQ Global Select Consolidated",
          "cusip": "88160R101",
          "isin": "US88160R1014",
          "country": "US",
          "figi_share_class": "BBG001SQKGD7",
          "figi": "BBG000N9MNX3",
          "security_type": "Common Stock"
        }
      ],
      "files": {
        "logo_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/logo_dark__53646042d4c8b507c7eddb70110ee334.png?x-bz-cred=...",
        "logo_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/logo_light__6895726d0ff148e46c238f91d033e72a.png?x-bz-cred=..."
      },
      "created_at": "2022-05-18T05:19:45.008547Z",
      "updated_at": "2025-02-05T09:43:14.303261Z"
    }
  ]
}

​

401 Respuesta no autorizada

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}

​

Respuesta 404 No encontrada

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No se encontraron logos para la clave de búsqueda especificada"
    }
  ]
}

​

Respuesta 500 de error interno del servidor

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "Ocurrió un error inesperado al procesar su solicitud"
    }
  ]
}

​

Autenticación

Todos los endpoints de la API de Logos requieren autenticación mediante una clave de API. Incluye tu token como parámetro de consulta:

?token=YOUR_API_KEY

​

Mejores prácticas

1. Especifica search_keys_type - Aunque la API usa symbol de forma predeterminada, especificar el tipo explícitamente mejora la claridad y el rendimiento
2. Solicita solo los campos necesarios - Solicita únicamente los tipos de logotipo que necesitas para minimizar el tamaño de la respuesta y mejorar el rendimiento
3. Usa bulk-sync para conjuntos de datos grandes - Al recuperar múltiples logotipos, utiliza el endpoint /logos/bulk-sync con paginación
4. Almacena respuestas en caché - Las URL de logotipos incluyen marcas de tiempo de expiración; usa la caché adecuadamente para reducir las llamadas a la API
5. Maneja errores de forma adecuada - Verifica siempre el campo ok en las respuestas y maneja los casos de error de manera apropiada

​

Límites de solicitudes

Consulta tu plan de suscripción a la API para conocer los detalles de los límites de solicitudes. Contacta al soporte si necesitas límites más altos para tu aplicación.

​

Soporte

Para obtener ayuda adicional o si tiene preguntas sobre la API de Logos, póngase en contacto con el soporte de la API de Benzinga o consulte la documentación detallada de los endpoints.