Oct 21, 2024 • Français · English · Deutsch

API de búsqueda de personas: encuentra personas y sus correos desde tu código

Read time: 2 Minutes, 22 Seconds

2026-10-19 [Initally Posted on: 2024-10-21]

Consulta las personas que tenemos, con su cargo, su empresa y su correo profesional cuando lo tenemos, desde tu propio código y con una sola petición autenticada.

Esta guía trata solo de la API. Para buscar, revelar y enviar desde la aplicación web, consulta Buscar personas y Personas y Revelaciones. Si aún no tienes una clave de API, la guía de inicio de la API explica cómo conseguirla.

El endpoint

GET https://thestack.es/api/v1/search/people

Autentícate enviando tu clave en la cabecera X-API-KEY:

1
2
3
4
curl -G "https://thestack.es/api/v1/search/people" \
     -H "X-API-KEY: {tu_clave_de_api}" \
     --data-urlencode "search_query=chief financial officer" \
     --data-urlencode "country=Spain"

Parámetros

Parámetro	Tipo	Descripción
`search_query`	texto	Palabras clave que se buscan en nombres, titulares y biografías, por ejemplo `head of sales` o un nombre completo.
`country`	texto, repetible	Nombre del país en inglés, por ejemplo `country=Spain&country=Portugal`.
`company_name`	texto, repetible	Nombre exacto de la empresa, por ejemplo `company_name=Acme Analytics`.
`website`	texto, repetible	Web exacta de la empresa.
`is_investor`	`true`	Solo personas que son el contacto principal de un inversor.
`page`	entero	Número de página, empezando por 1.
`per_page`	`10` o `15`	Resultados por página. Por defecto, `15`.
`order`	`asc` o `desc`	Por fecha de actualización. Por defecto, `desc` (lo más reciente primero).

Repite un parámetro para aceptar cualquiera de sus valores. Los parámetros distintos se combinan: country=Spain&company_name=Acme Analytics son las personas de Acme Analytics en España.

Respuesta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "data": [
    {
      "id": "ACoAAB1x...",
      "name": "Lucía Navarro",
      "email": "lucia@northwindlabs.io",
      "phone": null,
      "country": "Spain",
      "city": null,
      "company_name": "Northwind Labs",
      "company_website": "https://northwindlabs.io",
      "biography": "Building developer tooling...",
      "primary_position": "Head of Engineering at Northwind Labs",
      "school_name": null,
      "linkedin_url": "https://www.linkedin.com/in/lucia-navarro",
      "updated_at": "2026-10-19"
    }
  ],
  "has_more": true,
  "total": 128
}

email solo viene relleno cuando ya tenemos un correo profesional de esa persona; si no, es null. Las nuevas direcciones se revelan desde la aplicación web, a través de la extensión del navegador.
has_more indica si hay otra página, así que puedes seguir pidiendo hasta que sea false.
total es el número de personas que cumplen tus filtros, sumando todas las páginas.

Códigos de estado

Código	Significado
`200`	Hay resultados.
`400`	Algún parámetro tiene un valor no válido (por ejemplo `page=0` u `order=up`).
`401`	Falta la cabecera `X-API-KEY` o la clave no es válida.
`403`	Has agotado las peticiones de API de tu plan en este ciclo.
`404`	Nadie cumple esos filtros.

Cada petición correcta cuenta para las peticiones mensuales de tu plan; un 404 no cuenta.

Recorrer todas las páginas

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
import requests

url = "https://thestack.es/api/v1/search/people"
headers = {"X-API-KEY": "tu_clave_de_api"}
params = {"country": ["Spain", "Portugal"], "search_query": "recruiter", "per_page": 15}

page = 1
while True:
    response = requests.get(url, headers=headers, params={**params, "page": page})
    if response.status_code == 404:
        break
    response.raise_for_status()
    body = response.json()
    for person in body["data"]:
        print(person["name"], person["email"])
    if not body["has_more"]:
        break
    page += 1

Pruébalo en el navegador

Todos los endpoints, con sus parámetros, están en la documentación interactiva en thestack.es/api/docs: despliega Search People, pulsa Try it out, pega tu clave y envía una petición.