API updates

2025-01-09

Pagination Added to Events Calendar APIPagination support has been added to the Events Calendar REST endpoint (/v1/events-calendar), making it easier to work with large sets of past and upcoming events and to build scalable, production-ready integrations. See the Events Calendar API reference for more details.

Enables efficient navigation of large event datasets through paginated responses.
Supports scalable client integrations by reducing payload size and request complexity.
Improves the ability to build responsive user interfaces and event-driven workflows.

2025-12-19

Granular Category Filter ValuesThe category filter in the RESTful Search endpoint (/v1/search) and related endpoints now supports more granular category values, allowing customers to search by categories at a more precise level.In addition to the existing categories, the following new granular categories are now available:News Categories:

news_premium - Premium news sources

Research Categories:

research_academic_journals - Academic journal research

The original categories (expert_interviews, filings, my_files, news, podcasts, research, transcripts) continue to be supported for backward compatibility.Example:

{
    "query": {
        "text": "market analysis",
        "filters": {
            "category": {
                "mode": "INCLUDE",
                "values": [
                    "news_premium"
                ]
            }
        }
    }
}

See the Search Documents API reference for more details.

2025-12-15

Search Volume EndpointAdded a new /v1/search/volume endpoint that returns document and chunk volume statistics over time for a search query, aggregated by date with sentiment analysis. This endpoint uses the same request parameters as the /v1/search endpoint, except for ranking_params and max_chunks.This endpoint is valuable for several use cases:

Evaluate the product: Customers can see how many unique documents Bigdata has available for their particular query, which sets us apart from competitors.
Narrative/Thematic screeners: Users can create a query and see how the defined narrative evolves over time.
Query strategy: Users can check the coverage and plan how to create queries accordingly.

The response includes daily volume statistics (documents, chunks, and average sentiment) for each date in the time range, as well as aggregated totals across all dates.Efficient Usage: This endpoint consumes exactly 1 API Query Unit regardless of the time period queried, making it a very efficient way to visualize narrative evolution over time without extracting specific chunks of text.Example:

{
    "query": {
        "text": "Tariffs impact",
        "filters": {
            "timestamp": {
                "start": "2025-01-01T14:15:22Z",
                "end": "2025-12-15T14:15:22Z"
            }
        }
    }
}

Example Response:

{
    "results": {
        "volume": [
            {
                "date": "2025-01-01",
                "documents": 164,
                "chunks": 387,
                "sentiment": -0.15
            },
            {
                "date": "2025-01-02",
                "documents": 1363,
                "chunks": 3570,
                "sentiment": -0.16
            },
            ... // other dates
        ],
        "total": {
            "documents": 3440,
            "chunks": 8196,
            "sentiment": -0.18
        }
    },
    "metadata": {
        "request_id": "473d22ea-7753-41d8-825a-4a4c7696f8cb",
        "timestamp": "2025-12-15T17:34:34.181589+00:00"
    },
    "usage": {
        "api_query_units": 1.0
    }
}

See the Search Volume API reference for more details, or check out the Theme Volume Evolution how-to guide for a complete example with visualization.

2025-12-12

Sentiment API launch & Earnings Data EnhancementsAdded

Launched the Sentiment REST endpoint (/v1/entity-sentiment), enabling programmatic access to sentiment signals derived from news and content sources. See the Entity Sentiment API reference for more details.

Improved

Expanded Earnings Calendar API coverage, providing improved access to upcoming and historical earnings events across supported companies.
Improved structure, consistency, and completeness of Earnings Calendar API responses to support more reliable downstream integrations.
Enhanced data validation and response handling across select financial datasets to reduce inconsistencies.
Improved overall API reliability and performance for high-volume requests.

Fixed

Fixed issues where certain API responses could return incomplete or inconsistent data under specific conditions.
Addressed minor response formatting issues across select endpoints.

2025-12-04

Search in Headlines, Body, or BothAdded a new optional search_in parameter to the keyword, entity, and topic filter objects in the RESTful Search endpoint (/v1/search). See the Search Documents API reference for more details.This parameter allows you to specify where to search for keywords, entities, or topics:

HEADLINE: Search only in document headlines
BODY: Search only in document body text
ALL: Search in both headlines and body text (default)

If the search_in parameter is not provided, it defaults to ALL, maintaining backward compatibility with existing API calls.Example:

{
    "query": {
        "text": "",
        "filters": {
            "keyword": {
                "search_in": "HEADLINE",
                "all_of": ["Snowflake"],
                "any_of": [],
                "none_of": []
            }
        },
        "ranking_params": {
            "source_boost": 10,
            "freshness_boost": 10
        },
        "max_chunks": 50
    }
}

2025-11-14

Sentiment Filter with Custom RangesAdded a new ranges parameter to the sentiment filter in the RESTful Search endpoint (/v1/search). This parameter allows you to filter documents by custom sentiment score ranges, providing more precise control over sentiment filtering than the previous values parameter.The ranges parameter accepts an array of objects, each specifying a min and max sentiment score (ranging from -1.0 to 1.0). You can specify multiple ranges to capture different sentiment segments.Sunsetting: The values parameter (which accepted ["positive", "negative", "neutral"]) is now sunsetting. While it will continue to work for backward compatibility, we recommend migrating to the new ranges parameter for more precise sentiment filtering.Example:

{
    "query": {
        "text": "Solid state battery research",
        "filters": {
            "sentiment": {
                "ranges": [
                    {
                        "min": -1,
                        "max": -0.3
                    },
                    {
                        "min": 0.3,
                        "max": 1
                    }
                ]
            }
        },
        "ranking_params": {
            "source_boost": 10,
            "freshness_boost": 10
        },
        "max_chunks": 50
    }
}

See the Search Documents API reference for more details.

2025-11-11

Tag Filter for Uploaded DocumentsAdded a new tag filter to the RESTful Search endpoint (/v1/search) that allows you to find uploaded documents with specific tags. This filter is particularly useful when working with private uploaded files or forwarded emails that have been tagged.The tag filter accepts an any_of parameter containing an array of tag strings. Documents matching any of the specified tags will be included in the search results.Example:

{
    "query": {
        "text": "stock",
        "filters": {
            "source": {
                "mode": "INCLUDE",
                "values": [
                    "000000",   // Private uploaded files
                    "9790B7"    // Private forwarded emails
                ]
            },
            "tag": {
                "any_of": ["Data Science Research"]
            }
        },
        "max_chunks": 10
    }
}

See the Search Documents API reference for more details.

2025-11-10

Custom Reranker ThresholdAdded a new optional threshold parameter to the reranker object in the ranking_params of the RESTful Search endpoint (/v1/search). This parameter allows you to set a custom threshold to filter results by relevance score, improving precision and reducing noise.The threshold parameter accepts a float value ranging from 0.0 to 1.0. The default reranker uses a threshold of 0.2, but you can set a custom threshold to control result quality. Higher values return fewer, more relevant results.Example:

{
    "query": {
        "text": "Quantum computer pattern",
        "ranking_params": { 
            "source_boost": 10,
            "freshness_boost": 1,
            "reranker": {
                "enabled": true,
                "threshold": 0.8
            }
        }
    }
}

See the Search Documents API reference for more details.

2025-11-10

Category FilterAdded a new category filter to the RESTful Search endpoint (/v1/search) that allows you to filter documents by category. This enables selecting a related set of sources without having to add a long list of source IDs.The category filter accepts a mode parameter (INCLUDE or EXCLUDE) and a values array containing one or more category names. The currently supported categories are:

expert_interviews
filings
my_files
news
podcasts
research
transcripts

Example:

{
    "query": {
        "text": "tariffs",
        "filters": {
            "category": {
                "mode": "INCLUDE",
                "values": [
                    "expert_interviews",
                    "news",
                    "research"
                ]
            }
        }
    }
}

See the Search Documents API reference for more details.

2025-10-03

Expanded API Coverage for Companies, Financials, and FundsThese new APIs give clients richer company fundamentals and the ability to screen & analyze funds with more precision:

Company Profile (/v1/company-profile) retrieving comprehensive company profile data.
Revenue Geographic Segments (/v1/company-revenue-geographic-segments) providing revenue data for a company broken down by geographic regions.
Revenue Product Segments (/v1/company-revenue-product-segments) delivering detailed revenue data for a company segmented by product lines or business units.
Stock & Funds Screener (/v1/company-screener) enabling advanced screening of stocks and funds.
Fund Holdings (/v1/holdings/funds/stocks) delivering institutional fund holdings and portfolio summary data.

See the Structured Data Introduction for more details.

2025-09-26

New Core Financial & Market Data EndpointsThis release introduces a set of core financial and market data APIs, including comprehensive company financial statements, trailing ratios, daily and intraday prices, price changes, and real‑time quotes.

Income Statement (/v1/income-statement) returning a company’s income statement data.
Cash Flow Statement (/v1/cash-flow-statement) providing a company’s cash flow statement data.
Daily Prices (/v1/price/daily) delivering end‑of‑day pricing data for equities.
Company Ratios TTM (/v1/company-ratios-ttm) returning trailing twelve‑month financial ratios for a company.
Intraday Prices (/v1/price/intraday) providing intraday (within‑day) pricing data for equities.
Price Changes (/v1/price/changes) delivering computed price change metrics.
Quote (/v1/quote) returning the latest real‑time or near‑real‑time quote for an equity.

See the Structured Data Introduction for more details.

2025-09-19

Earnings Surprises (/v1/latest-surprise) returning actual earnings vs. consensus estimates along with surprise metrics.
Key Metrics TTM (/v1/key-metrics-ttm) providing key trailing twelve‑month performance metrics.
Balance Sheet (/v1/balance-sheet) delivering a company’s balance sheet data.
Analyst Ratings (/v1/analyst-ratings) returning aggregated analyst rating data.
Analayst Estimates (/v1/analyst-estimates) providing detailed analyst forecast estimates for metrics.
Events Calendar (/v1/events-calendar) delivering scheduled company and market events.

See the Structured Data Introduction for more details.

API Changelog

MCP Changelog

SDK Changelog