← All docs

Quickstart

Get structured LinkedIn company data in four steps.

1. Create an API key

In the console, go to API keys → Create a key. Copy it — it's shown once. Send it on every request as the X-API-Key header.

2. Submit companies

curl -X POST https://company-search.creative-pandas.ch/api/scraping/jobs/ \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls_input": ["https://www.linkedin.com/company/anthropic/"]}'

The response contains a job_id and one task per URL.

3. Check status

curl https://company-search.creative-pandas.ch/api/scraping/tasks/TASK_ID/ \
  -H "X-API-Key: YOUR_KEY"

status moves from queued → in_progress → complete.

4. Fetch the data

curl https://company-search.creative-pandas.ch/api/scraping/tasks/TASK_ID/extracted_data/ \
  -H "X-API-Key: YOUR_KEY"

Returns the structured JSON described in the data dictionary. Prefer push? Register a webhook and skip polling.

Python

import requests

BASE = "https://company-search.creative-pandas.ch/api/scraping"
H = {"X-API-Key": "YOUR_KEY"}

job = requests.post(f"{BASE}/jobs/", headers=H,
                    json={"urls_input": ["https://www.linkedin.com/company/anthropic/"]}).json()
task_id = job["tasks"][0]["id"]

data = requests.get(f"{BASE}/tasks/{task_id}/extracted_data/", headers=H).json()
print(data["extracted_data"]["about"]["name"])