Skip to main content
​
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.