# Company APIs

> Company intelligence resolved from a domain - firmographics, employees, funding history, buying intent, and product signals.

- **Auth:** `X-API-Key` + `X-API-Secret` headers
- **Mode:** Asynchronous - submit returns `202 Accepted` + `request_id`; poll the submit path or use a `callback_url` webhook.
- **HTML version:** https://api.nyne.ai/documentation/company

The Company APIs resolve a company from a website domain (or an email, phone, or LinkedIn company URL) and return structured intelligence about it: the firmographic record, the people who work there, what it sells and runs, what it needs, and who funds it.

Every endpoint is an asynchronous `POST`: the submit returns `202 Accepted` with a `request_id`, and you poll the same path - `GET <path>?request_id=…` - until `status` is `completed`, or supply a `callback_url` to receive the result by webhook instead.

Credits are charged only on meaningful results - when no company matches your identifiers, nothing is charged.

## Endpoints

### Find companies

Build target lists from firmographic filters, or rank ICP candidates by demonstrated buying intent.

- **[Company Search](https://api.nyne.ai/documentation/company/search.md)** - `POST /company/search` - Find companies by industry, location, and website keyword.
- **[Company Discovery](https://api.nyne.ai/documentation/company/discovery.md)** - `POST /company/discovery` - Discover companies from the open web with natural-language queries and match conditions.
- **[Company Intent](https://api.nyne.ai/documentation/company/intent.md)** - `POST /company/intent` - Find and rank ICP candidates from demonstrated buying-intent signals.

### Profiles & people

The full company record - and the public profiles of the people behind it.

- **[Company Enrichment](https://api.nyne.ai/documentation/company/enrichment.md)** - `POST /company/enrichment` - Resolve a full company profile from a domain, email, phone, or LinkedIn URL.
- **[Company Employees](https://api.nyne.ai/documentation/company/employees.md)** - `POST /company/employees` - Retrieve public employee profiles for a company.

### Signals & research

Answer specific questions about a company: what it sells, what its site runs, what it needs, who funds it, and who engages with it.

- **[CheckSeller](https://api.nyne.ai/documentation/company/checkseller.md)** - `POST /company/checkseller` - Verify whether a company sells a given product or service.
- **[CheckFeature](https://api.nyne.ai/documentation/company/checkfeature.md)** - `POST /company/checkfeature` - Detect whether a company’s site has a given feature, technology, or capability.
- **[Company Needs](https://api.nyne.ai/documentation/company/needs.md)** - `POST /company/needs` - Summarize pain points / challenges from a company’s official filings.
- **[Company Funding](https://api.nyne.ai/documentation/company/funding.md)** - `POST /company/funding` - Retrieve verified funding-round and acquisition history for a company.
- **[Company Funders](https://api.nyne.ai/documentation/company/funders.md)** - `POST /company/funders` - Look up an investor / fund profile (partners, thesis, check size, recent deals).
- **[Competitor Engagements](https://api.nyne.ai/documentation/company/competitor.md)** - `POST /company/competitor-engagements` - Find people who engaged with a company page, with profile URLs and post context.

## Worked example

The flagship endpoint, [Company Enrichment](https://api.nyne.ai/documentation/company/enrichment), shows the request/poll shape every Company API shares. Submit a domain or LinkedIn company URL, get a `request_id` back immediately, then poll the same path for the full company record.

### 1. Submit - `POST /company/enrichment`

```bash
curl -X POST https://api.nyne.ai/company/enrichment \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "social_media_url": "https://www.linkedin.com/company/tesla-motors/"
  }'
```

The call returns `202 Accepted` immediately:

```json
{
  "request_id": "dfd84d2d1f065a9b4e7fbc3df6aabbb6_1700000123_8123",
  "status": "queued"
}
```

### 2. Poll until completed

```bash
curl "https://api.nyne.ai/company/enrichment?request_id=<request_id>" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"
```

When `status` is `completed`, the same response carries the result:

```json
{
  "request_id": "dfd84d2d1f065a9b4e7fbc3df6aabbb6_1700000123_8123",
  "status": "completed",
  "completed": true,
  "result": {
    "company_name": "Tesla, Inc.",
    "website": "https://www.tesla.com",
    "description": "Designs and manufactures electric vehicles and energy storage systems.",
    "linkedin_url": "https://www.linkedin.com/company/tesla-motors/",
    "industry": "Automotive",
    "specialties": [
      "Electric Vehicles",
      "Energy Storage"
    ],
    "headcount_range": "10,001+",
    "locations": [
      {
        "city": "Austin",
        "state": "Texas",
        "country": "United States"
      },
      {
        "city": "Fremont",
        "state": "California",
        "country": "United States"
      }
    ],
    "funding": {
      "last_round": "Post-IPO",
      "funding_total": "20.2B"
    },
    "sic_codes": [
      "3711"
    ],
    "naics_codes": [
      "336111"
    ],
    "emails": [
      "press@tesla.com"
    ],
    "phone_numbers": [
      "+1-512-516-8177"
    ]
  },
  "completed_on": "2026-01-15T10:35:00Z"
}
```

## Authentication & credits

All `/person/*` and `/company/*` endpoints authenticate with an API key and secret sent as HTTP headers on every request: `X-API-Key` and `X-API-Secret`. Create keys from your Nyne dashboard and keep the secret server-side. Rate limits: 100 requests/minute, 1,000 requests/hour. Full guide: https://api.nyne.ai/documentation/authentication.md

Credits are charged only on meaningful results - empty results never burn credits. Each endpoint page lists its exact credit costs.

---

All documentation pages are available as Markdown by appending `.md` to their URL. Index: https://api.nyne.ai/llms.txt