# Patherpane Intelligence API

| | |
| --- | --- |
| **AI spec (drop this link)** | https://intelligence.patherpane.com/ai.md |
| This page | https://intelligence.patherpane.com/api.md |
| Swagger | https://intelligence.patherpane.com/docs |
| UI | https://intelligence.patherpane.com/ |
| Guide | https://intelligence.patherpane.com/guide |

Lookups need `X-API-Key`. These Markdown URLs are public and do **not** contain the key.

## One field in

`POST https://intelligence.patherpane.com/v1/lookups`

```json
{ "q": "email, +phone, domain.com, Jane Smith at Acme, @instagram, linkedin.com/in/…, or a handle" }
```

Name + company (Apollo-style):

```json
{ "name": "Jane Smith", "company": "Acme Inc" }
```

Optional `domain` with that pair. Then poll `GET /v1/lookups/{id}` every 2 seconds until `complete`. Create response includes `poll` (`/v1/lookups/{id}`). Partial `profile` is visible while `running`. `GET /v1/lookups` lists recent jobs. Up to 3 jobs run at once so a domain/DNS lookup is not stuck behind a person enrich.

Jobs take 1–4 minutes. Stored 3 days then deleted. 30 new lookups / hour / key.

## Sources (public records, not social spray)

Default pipeline queries **government and company registries**, then filtered web search:

- **US:** SEC EDGAR (CIK, filings, address), USAspending.gov recipients
- **UK:** Companies House companies, officers, persons with significant control
- **India:** MCA director data via Zaubacorp, `.gov.in` / gazette search
- **Global:** OpenCorporates companies + officers
- **Search:** Bing-first dorks for `.gov`, `.gov.uk`, `.gov.in`, MCA, Companies House, EDGAR, PDFs, LinkedIn
- **Person:** name + company → company domain, LinkedIn/gov search, email pattern + Gravatar/Hunter, then the same registries

Username scanners (Maigret, PhoneInfoga, ignorant) and random social-media hits are **not** returned. `profile.socials` is LinkedIn / GitHub / registry URLs. `profile.officers` is founders and directors from those registers.

Reverse-phone still needs a licensed people database for Apollo-class name/job graphs. Add `PDL_API_KEY` (already called if set) or Apollo / Truecaller Business keys.

## Response you care about

`profile.officers[]`, `profile.company` (registry, CIK, UK number, CIN), `profile.mentions[]` (gov + gazette snippets), `profile.raw.ddgs.public_record_urls`, `profile.person`, `emails`, `phones`.