The Companies API LogoThe Companies API Logo
APICasos de usoEmpresas
Iniciar sesiónIniciar sesión
Empezar
Autenticación
Errores
Límites de velocidad
Webhooks
Datapoints (empresa)
Empresas
Enriquecer desde dominio
Enriquecer desde email
Enriquecer desde red social
Contar empresas
Buscar empresas
Buscar por nombre
Buscar por prompt
Buscar similares
Preguntar empresa
Obtener contexto
Encontrar patrones de email
Obtener analíticas
Exportar analíticas
Industrias
Buscar industrias
Encontrar industrias similares
Listas
Obtener listas
Crear lista
Obtener empresas
Alternar empresas
Ubicaciones
Buscar ciudades
Buscar condados
Buscar países
Buscar estados
Buscar continentes
Acciones
Solicitar acción
Obtener acciones
Equipos
Obtener equipo
Tecnologías
Buscar tecnologías
Utilidades
Salud de API
Especificación openapi
Empezar
Autenticación
Errores
Límites de velocidad
Webhooks
Datapoints (empresa)
Empresas
Enriquecer desde dominio
Enriquecer desde email
Enriquecer desde red social
Contar empresas
Buscar empresas
Buscar por nombre
Buscar por prompt
Buscar similares
Preguntar empresa
Obtener contexto
Encontrar patrones de email
Obtener analíticas
Exportar analíticas
Industrias
Buscar industrias
Encontrar industrias similares
Listas
Obtener listas
Crear lista
Obtener empresas
Alternar empresas
Ubicaciones
Buscar ciudades
Buscar condados
Buscar países
Buscar estados
Buscar continentes
Acciones
Solicitar acción
Obtener acciones
Equipos
Obtener equipo
Tecnologías
Buscar tecnologías
Utilidades
Salud de API
Especificación openapi

Recuperar las empresas de tu lista

Recupere empresas guardadas en sus listas.
GET
https://api.thecompaniesapi.com/v2/lists/:listId/companies
Gratis

Las empresas dentro de tus listas se pueden recuperar página por página con page y size.

También puedes ordenarlas con sortKey y sortOrder.

Para filtrar tus empresas, puedes usar el parámetro query.

Regístrate para acceder a todas las características de nuestra API

Obtén tus 500 créditos gratuitos y comienza a enriquecer y buscar empresas.

No se requiere tarjeta de crédito

Parámetros de consulta
pagenumber (opcional)

La página a recuperar (por defecto: 1).

/lists/:listId/companies?page=1

sizenumber (opcional)

El número de empresas a recuperar (entre 1 y 100). Por defecto a 10.

/lists/:listId/companies?size=10

querystring (requerido)

La consulta para filtrar las empresas dentro de tu lista.

Asegúrate de que este parámetro esté convertido a cadena y codificado.

GET
https://api.thecompaniesapi.com/v2/lists/:listId/companies?query=%5B%7B%22attribute%22%3A%22about.industries%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22retail%22%2C%22internet%22%2C%22services%22%5D%7D%2C%7B%22attribute%22%3A%22locations.headquarters.country.code%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22us%22%2C%22fr%22%2C%22gb%22%5D%7D%5D&token=XXXXXX
El endpoint que define tus criterios de búsqueda.
sortFieldsstring (opcional)

Un array de múltiples campos combinados para ordenar los resultados.

…/lists/:listId/companies?sortFields=%5B%7B%22key%22%3A%22meta.score%22%2C%22order%22%3A%22desc%22%7D%5D

Asegúrate de que este parámetro esté convertido a cadena y codificado.

sortKeystring (opcional)

El campo para ordenar los resultados.

…/lists/:listId/companies?sortKey=meta.score

Valores posibles

about.businessType
about.industries
about.industry
about.name
about.totalEmployees
about.yearFounded
analytics.monthlyVisitors
apps
codes.naics
codes.sic
Mostrar 13 más
sortOrderstring (opcional)

El orden para ordenar los resultados.

…/lists/:listId/companies?sortOrder=asc

Valores posibles

asc
desc
Esquema de respuesta
companiesarray

Las empresas que pertenezcan a tu lista.

Explorar todos los puntos de datos
metaobject

La información de metadatos.

Ejemplos de código
Selecciona tu lenguaje favorito:
C#

Go

Java

JavaScript
SDK

PHP

Python

Ruby

Rust

import createClient from '@thecompaniesapi/sdk'

const tca = createClient({ apiToken: 'YOUR_API_TOKEN' })

const response = await tca.fetchCompaniesInList({
  listId: 1234
})

const companies = response.data.companies // Companies that match the list
const meta = response.data.meta // Meta information

Crear una lista de empresas

Cree una lista de empresas con nuestra API.

Agregar o eliminar empresas en su lista

Agregue o elimine empresas en sus listas usando sus nombres de dominio o IDs.

Una imagen de fondo brillante para resaltar el títuloUna imagen de fondo brillante para resaltar el título
© 2025 The Companies API
  • Actualizaciones
  • Términos
  • Privacidad
  • Preguntas frecuentes
  • Estado

Empresas SaaS de rápido crecimiento con equipos remotos