API Reference

Company Data API Reference

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

11 endpoints X-API-Key + X-API-Secret Async - poll or webhook

The Company APIs resolve a company from a website domain (or an email, phone, or company social 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.

POST Company Search Find companies from a natural-language query. /company/search POST Company Discovery Discover companies from the open web with natural-language queries and match conditions. /company/discovery POST Company Intent Find and rank ICP candidates from demonstrated buying-intent signals. /company/intent

Profiles & people

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

POST Company Enrichment Resolve a full company profile from a domain, email, phone, or company social URL. /company/enrichment POST Company Employees Retrieve public employee profiles for a company. /company/employees

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.

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

Worked example

The flagship endpoint, Company Enrichment, shows the request/poll shape every Company API shares. Submit a domain or company social URL, get a request_id back immediately, then poll the same path for the full company record.

1. Submit - `POST /company/enrichment`

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:

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

2. Poll until completed

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:

{
  "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"
}

Skip polling with a webhook

Every async endpoint accepts a callback_url - the completed result is POSTed there when the job finishes, so you never poll at all.

Authentication & credits

Every endpoint here authenticates with an API key + secret sent as HTTP headers (X-API-Key · X-API-Secret) - create them from your dashboard and see the Authentication guide for rate limits and IP locking. Each endpoint page lists its exact credit costs.

Credits are charged on results

Empty results never burn credits. Per-result options (verified emails, phone numbers, AI scoring) carry their own line items - check the Credit usage table on each endpoint page.

FAQ

Which Company API should I start with?

Use Company Enrichment when you already have a domain or company URL, Company Search when you need a filtered account list, and Company Discovery when the criteria are more research-oriented or natural-language.

What company data can the APIs return?

The Company APIs can return firmographics, employees, funding history, investor context, website and product signals, technographics, buyer-intent signals, and competitor engagement context.

How are Company API results delivered?

Company endpoints are asynchronous: POST the request, keep the request_id, then poll the same path or provide a callback_url for webhook delivery when the job completes.