API Reference

Company APIs

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 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.

POST Company Search Find companies by industry, location, and website keyword. /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 LinkedIn 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 LinkedIn company 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": [
      "[email protected]"
    ],
    "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.