Company Data Schema

Complete reference for all fields returned in enriched company data. Unavailable fields return null.

Full Schema

{
  "id": "uuid",
  "domain": "stripe.com",
  "name": "Stripe",
  "description": "Financial infrastructure for the internet...",
  "logo": "https://stripe.com/img/logo.png",
  "website": "https://stripe.com",
  "industry": "Financial Technology",
  "foundedYear": 2010,
  "employeeCount": "8000-10000",
  "location": "San Francisco, CA",
  "email": "contact@stripe.com",
  "phone": "+1-888-926-2289",
  "socialProfiles": {
    "linkedin": "https://linkedin.com/company/stripe",
    "twitter": "https://twitter.com/stripe",
    "facebook": "https://facebook.com/stripe",
    "instagram": null,
    "github": "https://github.com/stripe"
  },
  "keywords": ["payments", "fintech", "api", "saas"],
  "valueProposition": "Payment processing for internet businesses",
  "targetCustomers": "Businesses of all sizes accepting online payments",
  "revenueModel": "Transaction fees and subscription pricing",
  "servicesOffered": ["Payment Processing", "Billing", "Invoicing", "Fraud Prevention"],
  "competitors": ["PayPal", "Square", "Adyen", "Braintree"],
  "businessStage": "enterprise",
  "fundingStatus": "Series I",
  "industriesServed": ["E-commerce", "SaaS", "Marketplaces", "Platforms"],
  "challenges": ["Regulatory compliance", "Global expansion", "Competition"],
  "enrichedAt": "2026-02-01T10:30:00Z",
  "confidence": 92,
  "sources": ["website", "linkedin", "ai"]
}

Field Reference

Core Fields

Field	Type	Description
id	string	Unique company identifier (UUID)
domain	string	Normalized domain (e.g., stripe.com)
name	string	Company name
description	string | null	Company description or tagline
logo	string | null	URL to company logo
website	string	Full website URL

Industry & Classification

Field	Type	Description
industry	string | null	Primary industry (e.g., Technology, Financial Technology, Healthcare, E-commerce, SaaS, Manufacturing)
keywords	string[] | null	Related keywords and tags
industriesServed	string[] | null	Industries the company serves

Company Size

Field	Type	Description
employeeCount	string | null	Employee count range
foundedYear	number | null	Year the company was founded

Employee Count Ranges: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10000+

Location & Contact

Field	Type	Description
location	string | null	Headquarters (e.g., "San Francisco, CA")
email	string | null	General contact email
phone	string | null	General contact phone

Social Profiles

Field	Type	Description
socialProfiles.linkedin	string | null	LinkedIn company page URL
socialProfiles.twitter	string | null	Twitter/X profile URL
socialProfiles.facebook	string | null	Facebook page URL
socialProfiles.instagram	string | null	Instagram profile URL
socialProfiles.github	string | null	GitHub organization URL

Business Context (AI-Generated)

Field	Type	Description
valueProposition	string | null	What the company offers and why it matters
targetCustomers	string | null	Who the company serves
revenueModel	string | null	How the company makes money
servicesOffered	string[] | null	List of products/services

Business Stage & Funding

Field	Type	Description
businessStage	enum | null	Company lifecycle stage
fundingStatus	string | null	Latest funding round or status

Business Stages: startup, growth, scaleup, enterprise, public

Funding Status Examples: Pre-seed, Seed, Series A-D+, IPO, Bootstrapped, Acquired

Competitive Intelligence (AI-Generated)

Field	Type	Description
competitors	string[] | null	Known competitors
challenges	string[] | null	Business challenges the company faces

Metadata

Field	Type	Description
enrichedAt	string	ISO 8601 timestamp of enrichment
confidence	number	Data quality score (0-100). See Data Sources for interpretation.
sources	string[]	Data sources used: website, linkedin, ai. See Data Sources.

---

TypeScript Interface

interface CompanyData {
  id?: string;
  domain: string;
  name: string;
  description: string | null;
  logo: string | null;
  website: string;
  industry: string | null;
  foundedYear: number | null;
  employeeCount: string | null;
  location: string | null;
  email: string | null;
  phone: string | null;
  socialProfiles: {
    linkedin?: string;
    twitter?: string;
    facebook?: string;
    instagram?: string;
    github?: string;
  };
  keywords: string[] | null;
  valueProposition: string | null;
  targetCustomers: string | null;
  revenueModel: string | null;
  servicesOffered: string[] | null;
  competitors: string[] | null;
  businessStage: 'startup' | 'growth' | 'scaleup' | 'enterprise' | 'public' | null;
  fundingStatus: string | null;
  industriesServed: string[] | null;
  challenges: string[] | null;
  enrichedAt: string;
  confidence: number;
  sources: string[];
}

Python Type Hints

from typing import TypedDict, Optional, List, Literal

class SocialProfiles(TypedDict, total=False):
    linkedin: Optional[str]
    twitter: Optional[str]
    facebook: Optional[str]
    instagram: Optional[str]
    github: Optional[str]

BusinessStage = Literal['startup', 'growth', 'scaleup', 'enterprise', 'public']

class CompanyData(TypedDict):
    id: Optional[str]
    domain: str
    name: str
    description: Optional[str]
    logo: Optional[str]
    website: str
    industry: Optional[str]
    foundedYear: Optional[int]
    employeeCount: Optional[str]
    location: Optional[str]
    email: Optional[str]
    phone: Optional[str]
    socialProfiles: SocialProfiles
    keywords: Optional[List[str]]
    valueProposition: Optional[str]
    targetCustomers: Optional[str]
    revenueModel: Optional[str]
    servicesOffered: Optional[List[str]]
    competitors: Optional[List[str]]
    businessStage: Optional[BusinessStage]
    fundingStatus: Optional[str]
    industriesServed: Optional[List[str]]
    challenges: Optional[List[str]]
    enrichedAt: str
    confidence: float
    sources: List[str]

See Also

• Enrichment Guide — How to enrich companies
• Data Sources — Where data comes from and confidence scoring