Nyne.ai API Login
Company APIs

Company Enrichment API

Submit one or more identifiers for a company - domain, email, phone, or a company social_media_url - and receive a firmographic profile with fields such as industry, headcount, locations, funding, web presence, domains, emails, and phone numbers when available. Fields with no data are omitted from the response. The request is queued asynchronously and returns a request_id; poll the status endpoint or supply a callback_url. At least one identifier is required. Credits are charged only when the enrichment returns data.

POST https://api.nyne.ai/company/enrichment API key

Manual credentials take precedence over your account key.

Overview

The Company Enrichment API resolves a known company identifier into a structured company profile with firmographics, web presence, and business context.

Best for

  • Completing company records
  • Enriching domains and company social URLs
  • Adding firmographic context to accounts

Returns

  • Company profile and firmographics
  • Website and social context
  • Business metadata

Implementation guide

Company identifiers

Use the company enrichment API with a domain, website, company social URL, business email, or phone number to resolve a company profile.

Firmographic schema

Responses are designed for account records, firmographics, web presence, social context, and business metadata that can feed CRM or data warehouse fields.

Related workflows

After enrichment, use Employees for people at the account, Funding for financing history, or CheckFeature for technographic signals.

Parameters

domain string optional
Company website domain. Scheme, www., and path are stripped automatically before matching.
email string optional
Company email address. Validated for format.
phone string optional
Company phone number (digits, spaces, dashes, parentheses, and + only).
social_media_url string optional
Company social profile URL.
callback_url string optional
http(s) URL on an allowed host that receives the completed enrichment payload.

Polling for the result

This endpoint is asynchronous. A successful submit returns a request_id while the job runs in the background. Poll the same path with a GET request - same authentication headers - passing the request_id as a query parameter:

Loading your API credentials...

Each poll returns the job's current status; once it is completed the payload carries the result shown under Responses. Polling an unknown or expired request_id returns 404 request_not_found.

Status Meaning
queued · processing · pending The job is still running - keep polling.
completed The job finished; the payload carries the result and completed: true.
failed Terminal - the job could not complete; the error field explains why.

Poll every few seconds at first, backing off for long-running jobs. Polling is free - status checks never burn credits.

Prefer push delivery?
Supply the optional callback_url parameter and the completed payload is POSTed to your endpoint when the job finishes - no polling required. Delivery is retried up to 5 times with exponential backoff (1s, 5s, 15s, 1m, 5m) and a 30-second timeout per attempt; respond with a 2xx status to acknowledge receipt.

Credit usage

Credits are charged based on the matched configuration. The listed cost is the per-result unit price.

Feature Credits Notes
Company Enrichment - Charged once per request, only on a meaningful result
No match 0 No data found never burns credits
Heads up
Empty results do not burn credits.

Responses

202 Enrichment queued - poll the status endpoint with the returned request_id
400 missing_parameters / invalid_email / invalid_phone / invalid_url / invalid_domain / invalid_callback_url
401 Missing or invalid API credentials
402 insufficient_credits
403 subscription_required or ip_not_allowed
404 not_found - no company matched the supplied identifiers (no credits charged)
429 rate_limit_exceeded / monthly_limit_exceeded
503 service_unavailable - the API is temporarily unavailable

A successful response wraps the payload in the { success, data, timestamp } envelope (also shown live in the panel on the right):

{
  "success": true,
  "data": {
    "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"
  },
  "timestamp": "2026-01-01T00:00:00"
}