Oct 21, 2024 • Español · Français · English

People-Search-API: Personen und ihre geschäftlichen E-Mails per Code abfragen

Read time: 2 Minutes, 15 Seconds

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

Fragen Sie die Personen ab, die wir kennen, mit Position, Arbeitgeber und geschäftlicher E-Mail-Adresse, sofern vorhanden, aus Ihrem eigenen Code mit einer einzigen authentifizierten Anfrage.

Dieser Leitfaden behandelt nur die API. Zum Suchen, Ermitteln und Senden in der Web-App siehe Personen finden und Profile & E-Mail-Ermittlung. Falls Sie noch keinen API-Schlüssel haben, erklärt So nutzen Sie die The Stack API, wie Sie einen erhalten.

Der Endpunkt

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

Authentifizieren Sie sich, indem Sie Ihren Schlüssel im Header X-API-KEY senden:

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

Parameter

Parameter	Typ	Beschreibung
`search_query`	Text	Suchbegriffe für Namen, Profil-Überschriften und Biografien, z. B. `head of sales` oder ein vollständiger Name.
`country`	Text, wiederholbar	Englischer Ländername, z. B. `country=Germany&country=Austria`.
`company_name`	Text, wiederholbar	Exakter Name des Arbeitgebers, z. B. `company_name=Acme Analytics`.
`website`	Text, wiederholbar	Exakte Website des Arbeitgebers.
`is_investor`	`true`	Nur Personen, die Hauptansprechpartner eines Investors sind.
`page`	Ganzzahl	Seitennummer, beginnend bei 1.
`per_page`	`10` oder `15`	Ergebnisse pro Seite. Standard: `15`.
`order`	`asc` oder `desc`	Nach letzter Aktualisierung. Standard: `desc`, neueste zuerst.

Wiederholen Sie einen Parameter, um beliebige seiner Werte zuzulassen. Verschiedene Parameter werden kombiniert: country=Germany&company_name=Acme Analytics sind die Personen bei Acme Analytics in Deutschland.

Antwort

 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": "Lena Hoffmann",
      "email": "lena@quarrysystems.de",
      "phone": null,
      "country": "Germany",
      "city": null,
      "company_name": "Quarry Systems",
      "company_website": "https://quarrysystems.de",
      "biography": "Building engineering teams...",
      "primary_position": "Recruiting Manager at Quarry Systems",
      "school_name": null,
      "linkedin_url": "https://www.linkedin.com/in/lena-hoffmann",
      "updated_at": "2026-10-19"
    }
  ],
  "has_more": true,
  "total": 128
}

email ist nur gefüllt, wenn uns bereits eine geschäftliche Adresse der Person vorliegt, sonst null. Neue Adressen werden in der Web-App über die Browser-Erweiterung ermittelt.
has_more gibt an, ob es eine weitere Seite gibt; Sie können also abfragen, bis der Wert false ist.
total ist die Zahl der Personen, die Ihre Filter erfüllen, über alle Seiten hinweg.

Statuscodes

Code	Bedeutung
`200`	Ergebnisse geliefert.
`400`	Ein Parameter hat einen ungültigen Wert (z. B. `page=0` oder `order=up`).
`401`	Der Header `X-API-KEY` fehlt oder der Schlüssel ist ungültig.
`403`	Sie haben alle API-Anfragen Ihres Plans für diesen Zeitraum verbraucht.
`404`	Niemand erfüllt diese Filter.

Jede erfolgreiche Anfrage zählt zu den monatlichen Anfragen Ihres Plans; ein 404 zählt nicht.

Alle Seiten durchlaufen

 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": "ihr_api_schluessel"}
params = {"country": ["Germany", "Austria"], "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

Im Browser ausprobieren

Alle Endpunkte mit ihren Parametern finden Sie in der interaktiven Dokumentation unter thestack.es/api/docs: Klappen Sie Search People auf, klicken Sie auf Try it out, fügen Sie Ihren Schlüssel ein und senden Sie eine Anfrage.