Business Intelligence API

What is the Business Intelligence API?

The Business Intelligence API retrieves comprehensive business data using entity IDs from verified entity records returned by our Entity Resolution or Domain Intelligence APIs.

Key Features

Input: Entity ID from confirmed entity records
Output: Core business data for entities
Current Focus: Industry classification and corporate hierarchy
Status: Async polling API only

New to entity IDs? Entity IDs are stable identifiers that work across all SavvyIQ APIs, while entity types determine what data is available.

Status Lifecycle

building - Initial comprehensive data compilation (first-time research)
complete - Data is ready and current
refreshing - Current data available immediately while background refresh occurs
failed - Processing could not complete

Data freshness is managed automatically based on data age and source reliability.

Polling recommendation: Check status every 5-10 seconds until complete.

Comprehensive Business Intelligence

The Business Intelligence API transforms entity IDs into actionable business insights through comprehensive data compilation. Our system provides detailed business intelligence for any entity that has been successfully resolved, covering public companies, private entities, subsidiaries, and international organizations.

What Data You Get

The API returns comprehensive business intelligence across key categories:

Industry Classification

NAICS Codes: Primary and secondary industry classifications with confidence and relevance scores
Business Tags: Descriptive industry categorization (e.g., "Search Engine", "Cloud Computing")
Business Model: Revenue model classification (e.g., "Online Advertising", "B2B SaaS")
Products/Services: List of core offerings and business lines

Corporate Structure

Parent Entity: Direct corporate parent with entity ID for further lookup
Operational Presence: Legal jurisdictions and business locations with presence counts
Headquarters: Primary business address and location details

Entity Details

Legal Information: Official name, business type, legal entity details, and operational status
Business Description: AI-generated summary of business activities
Website: Primary domain and web presence

💡 Corporate Hierarchy: Parent entity IDs can be used with this same API to retrieve complete corporate hierarchy data.

Example Response

Here's a sample response for Google showing the complete data structure:

{
    "entity_id": "siq_2ZYEAh7VdPkWsvlsqW9lG",
    "status": "complete",
    "data": {
        "id": "siq_2ZYEAh7VdPkWsvlsqW9lG",
        "name": "Google",
        "type": "business",
        "subtype": "incorporated_entity",
        "status": "active",
        "headquarters": {
            "address": {
                "city": "Mountain View",
                "state": "California",
                "country": "United States",
                "state_code": "CA",
                "postal_code": "94043",
                "sub_premise": null,
                "country_code": "US",
                "street_number": null,
                "street_address": "1600 Amphitheatre Parkway",
                "formatted_address": null
            }
        },
        "primary_legal_entity": {
            "id": "le_2Zp3YaC1I4wgYZpQDPgx8",
            "name": "GOOGLE LLC",
            "jurisdiction": {
                "country_code": "US",
                "state_province": "Delaware"
            }
        },
        "attributes": {
            "description": "Google LLC is a multinational technology company specializing in internet-related services and products. As a subsidiary of Alphabet Inc., Google's core business revolves around advertising, search engine technology, cloud computing, computer software, quantum computing, e-commerce, consumer electronics, and artificial intelligence (AI). The company's mission is to organize the world's information and make it universally accessible and useful.",
            "website": "https://www.google.com",
            "domain": "google.com"
        },
        "classification": {
            "naics_codes_2022": [
                {
                    "code": "51",
                    "name": "Information",
                    "relevance": 95,
                    "confidence": 100,
                    "is_primary": true
                },
                {
                    "code": "519290",
                    "name": "Web Search Portals and All Other Information Services",
                    "relevance": 90,
                    "confidence": 95,
                    "is_primary": false
                },
                {
                    "code": "541511",
                    "name": "Custom Computer Programming Services",
                    "relevance": 85,
                    "confidence": 90,
                    "is_primary": false
                },
                {
                    "code": "541512",
                    "name": "Computer Systems Design Services",
                    "relevance": 80,
                    "confidence": 85,
                    "is_primary": false
                },
                {
                    "code": "518210",
                    "name": "Computing Infrastructure Providers, Data Processing, Web Hosting, and Related Services",
                    "relevance": 75,
                    "confidence": 80,
                    "is_primary": false
                }
            ],
            "business_tags": [
                "Search Engine",
                "Online Advertising",
                "Cloud Computing",
                "Artificial Intelligence",
                "Software Development",
                "Internet Services",
                "Consumer Electronics",
                "E-commerce",
                "Web Platforms"
            ],
            "business_model": [
                "Online Advertising",
                "B2C Services",
                "Cloud Computing",
                "Software Licensing",
                "E-commerce",
                "Hardware Sales"
            ],
            "products_services": [
                "Google Search",
                "Google Workspace",
                "Google Chrome",
                "Google Calendar",
                "Google Docs",
                "Google Drive",
                "Google Photos",
                "Google Meet",
                "Google Finance",
                "Google News",
                "Google Play Books",
                "Google Earth",
                "Google Ad Manager",
                "Google Play",
                "AdMob",
                "Google Maps",
                "AdSense",
                "Gmail",
                "Google Groups",
                "YouTube",
                "AI Technologies"
            ]
        },
        "corporate_structure": {
            "parent": {
                "id": "siq_2ZYEAcsNsEbssvpOLZmal",
                "name": "Alphabet Inc."
            }
        },
        "operational_presence": [
            {
                "id": "op_30lFgfjlLov9pfV4roOST",
                "country_code": "US",
                "country": "United States of America",
                "count": 49,
                "is_home_jurisdiction": true
            }
        ]
    },
    "message": null,
    "metadata": {
        "last_updated": "2025-07-01T03:54:42.091Z",
        "processing_started_at": null,
        "estimated_completion": null
    }
}

Supported Entities

Currently optimized for incorporated business entities with global coverage. For complete details on entity types and limitations, including our roadmap for expanding beyond corporations and LLCs, see our entity concepts documentation.

Quick Start

Get an entity ID from Entity Resolution or Domain Intelligence API
Make the request using the entity ID
Poll for completion if status is "building"
Use the data for your business intelligence needs

Integration Workflow Patterns

Standard Entity Enrichment

Business name/domain → Entity Resolution/Domain Intelligence → Entity ID → Business Intelligence → Complete profile

Corporate Hierarchy Exploration

Entity ID → Business Intelligence → Parent ID → Recursive Business Intelligence → Full hierarchy

Next Steps:

Get started: API Reference - Interactive endpoint documentation and examples
Understand responses: Confidence and Explainability - Interpret data quality scores
Scale up: Batch Processing - Process multiple entities efficiently