TypeScript — URL Lookup (Recommended)

const API_KEY = process.env.ORGSCAN_API_KEY;
const BASE = "https://api.orgscan.app";
const headers = { "Content-Type": "application/json", "X-API-Key": API_KEY };

// 1. Lookup by URL — returns existing data or starts fetch pipeline
const lookup = await fetch(`${BASE}/api/lookup`, {
  method: "POST", headers,
  body: JSON.stringify({ url: "gasag.de" }),
}).then((r) => r.json());

if (lookup.status === "found") {
  console.log("Already in DB:", lookup.company_id);
} else if (lookup.status === "pending") {
  // 2. Poll until pipeline completes
  let job;
  do {
    await new Promise((r) => setTimeout(r, 5_000));
    job = await fetch(`${BASE}/api/fetch-status/${lookup.job_id}`, { headers })
      .then((r) => r.json());
  } while (job.status !== "completed" && job.status !== "failed");

  console.log("Fetch result:", job.status, job.company_id);
}

Python — URL Lookup with Polling

import os, time, requests

API_KEY = os.environ["ORGSCAN_API_KEY"]
BASE = "https://api.orgscan.app"
H = {"Content-Type": "application/json", "X-API-Key": API_KEY}

# 1. Lookup by URL (optionally pass company_name)
result = requests.post(f"{BASE}/api/lookup", json={
    "url": "gasag.de"
}, headers=H).json()

if result["status"] == "found":
    print("Company ID:", result["company_id"])
elif result["status"] == "pending":
    # 2. Poll until done
    while True:
        time.sleep(5)
        job = requests.get(
            f"{BASE}/api/fetch-status/{result['job_id']}", headers=H
        ).json()
        if job["status"] in ("completed", "failed"):
            print(f"Result: {job['status']}, ID: {job.get('company_id')}")
            break

cURL — Search

curl -X POST https://api.orgscan.app/api/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ORGSCAN_API_KEY" \
  -d '{"query": "Deutsche Bahn", "mode": "all"}' | jq '.'