Please Log In

You need to log in to access your API credentials and start using our APIs. Start with our free trial!

Log In & Start Free Trial

Enrich company data using email addresses, phone numbers, or LinkedIn company profiles. Responses include firmographics, locations, funding detail, and employee insights. The endpoint is asynchronous—queue a request and poll or receive a webhook when processing completes.

Try the API Playground

Test the API with our interactive playground to make real requests and see live responses.

Launch Company Enrichment Playground

Overview

API Endpoint

https://api.nyne.ai/company/enrichment

The Company Enrichment API retrieves detailed information about companies using their LinkedIn company URL, email address, or phone number. It provides comprehensive company data including size, locations, funding information, and more.

Key Features

  • Multiple Input Types: Accepts email, phone, or LinkedIn company profile URLs.
  • Comprehensive Data: Returns locations, headcount ranges, industries, funding, and web presence.
  • Async Workflow: Queue requests and poll or receive callbacks when finished.
  • Usage Controls: Integrated credit tracking and rate limiting.
  • Caching: Meaningful results are cached for subsequent requests.

Authentication

Authenticate every request with your API key and secret using HTTP headers (recommended) or query parameters.

Header Authentication (Recommended) 
X-API-Key: your_api_key_here
X-API-Secret: your_api_secret_here

Rate Limits

API usage is controlled by rate limiting mechanisms to ensure fair usage and system stability:

  • Per Minute: 60 requests
  • Per Hour: 1000 requests
  • Monthly: Varies by plan

Credit Usage

API credits are consumed for company enrichment requests:

  • Company Enrichment: 1 credit per successful enrichment

Credit Efficiency

Credits are only charged when the enrichment returns data. If a company cannot be found, no credits are charged.

POST /company/enrichment

Submit a company identifier and receive a comprehensive profile once processing completes.

POST /company/enrichment

Parameters

email (string, optional)
Company email address to enrich.
Example: contact@example.com
phone (string, optional)
Company phone number to enrich.
Example: +1-555-123-4567
social_media_url (string, optional)
LinkedIn company profile URL.
Example: https://www.linkedin.com/company/tesla-motors/
callback_url (string, optional)
HTTPS endpoint that will receive the completed enrichment payload.
Example: https://example.com/webhooks/company-enrichment
Required: Provide at least one of email, phone, or social_media_url. Results are delivered asynchronously via polling or optional webhook callback.

Request Example

{ "social_media_url": "https://www.linkedin.com/company/tesla-motors/", "callback_url": "https://example.com/webhooks/company-enrichment" }

Response Example

{ "success": true, "data": { "request_id": "coenrich_dfd84d2d_1700000123", "status": "completed", "company": { "company_name": "Tesla, Inc.", "website": "https://www.tesla.com", "linkedin_url": "https://www.linkedin.com/company/tesla-motors/", "industry": "Automotive", "headcount_range": "10,001+", "hq_location": "Austin, TX", "funding": { "last_round": "Post-IPO", "funding_total": "6.1B" } } }, "timestamp": "2025-11-10T21:45:09Z" }

Response Format

Responses include various company fields depending on the data available. Typical payload:

{ "success": true, "data": { "request_id": "coenrich_dfd84d2d_1700000123", "status": "completed", "company": { "company_name": "Tesla, Inc.", "website": "https://www.tesla.com", "description": "Tesla designs and manufactures electric vehicles, battery storage, and solar products.", "linkedin_url": "https://www.linkedin.com/company/tesla-motors/", "industry": "Automotive", "specialties": [ "Electric Vehicles", "Energy Storage", "Solar" ], "size": { "headcount_range": "10,001+", "employees": 127000 }, "locations": [ { "city": "Austin", "region": "Texas", "country": "United States" }, { "city": "Fremont", "region": "California", "country": "United States" } ], "funding": { "last_round": "Post-IPO", "funding_total": "6.1B" } } } }

Error Codes

  • missing_parameters – None of email, phone, or social_media_url were provided.
  • invalid_callback_url – Callback URL is not HTTPS.
  • rate_limit_exceeded / monthly_limit_exceeded – Usage exceeded configured limits.
  • subscription_required – Company enrichment product is not enabled on this account.
  • not_found – Unable to find a company matching the provided identifiers.

Response Fields

The enrichment payload is returned as a JSON object. Common fields include:

company_name              // Official company name
website                   // Canonical company website
description               // Company description
linkedin_url              // LinkedIn company profile
industry                  // Primary industry
specialties               // Array of specialty tags
size.headcount_range      // Reported headcount range
size.employees            // Estimated employee count
locations                 // Array of offices with city/region/country
funding.last_round        // Most recent funding stage
funding.funding_total     // Total disclosed funding
social_profiles           // Known social media URLs
domains                   // Known email/web domains
emails                    // Public company email addresses
phone_numbers             // Array of known phone numbers
employees                 // Headcount information (range/min/max if available)
sic_codes                 // Array of SIC codes
naics_codes               // Array of NAICS codes

Next Steps