> ## Documentation Index
> Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 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)
* `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
```json theme={null}
{
"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
```json theme={null}
{
"ok": false,
"errors": [
{
"code": "auth_failed",
"id": "unauthorized",
"value": "Invalid or missing authentication token"
}
]
}
```
### Respuesta 404 No encontrada
```json theme={null}
{
"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
```json theme={null}
{
"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.