Saltar al contenido principal

​
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.