Tavily Docs home pagelight logodark logo
  • Support
  • Get an API key
  • Get an API key
Home
Documentation
SDKs
Examples
FAQ
Changelog
  • API Playground
  • Community
  • Blog
    • Changelog
    • Changelog
    Changelog

    Changelog

    Start date & end date Parameters

    July 2025


    start_date parameter,end_date parameter
    • You can now use both the start_date and end_date parameters in the Search endpoints.
    • start_date will return all results after the specified start date. Required to be written in the format YYYY-MM-DD.
    • end_date will return all results before the specified end date. Required to be written in the format YYYY-MM-DD.
    • Set start_date to 2025-01-01 and end_date to 2025-04-01 to reiceive results strictly from this time range.

    Usage dashboard

    July 2025


    Login to your account to view the usage dashboard

    The usage dashboard provides the following features to paid users/teams:
    • The Usage Graph offers a breakdown of daily usage across all Tavily endpoints with historical data to enable month over month usage and spend comparison.
    • The Logs Table offers granular insight into each API request to ensure visibility and traceability with every Tavily interaction.

    Include favicon parameter

    June 2025


    include_favicon parameter
    • You can now include the favicon URL for each result in the Search, Extract, and Crawl endpoints.
    • Set the include_favicon parameter to true to receive the favicon URL (if available) for each result in the API response.
    • This makes it easy to display website icons alongside your search, extraction, or crawl results, improving the visual context and user experience in your application.

    Auto parameters (BETA)

    June 2025

    Tavily Search
    auto_parameters (BETA)
    • Boolean default: false
    • When auto_parameters is enabled, Tavily automatically configures search parameters based on your query’s content and intent. You can still set other parameters manually, and your explicit values will override the automatic ones.
    • The parameters include_answer, include_raw_content, and max_results must always be set manually, as they directly affect response size.
    • Note: search_depth may be automatically set to advanced when it’s likely to improve results. This uses 2 API credits per request. To avoid the extra cost, you can explicitly set search_depth to basic.
    • Currently in BETA.

    Usage endpoint

    May 2025

    /usage endpoint
      Easily check your API usage and plan limits.
      Just GET https://api.tavily.com/usage with your API key to monitor your account in real time.

    Country parameter

    May 2025

    Tavily Search
    country parameter

    Boost search results from a specific country.

      This will prioritize content from the selected country in the search results. Available only if topic is general.

    Make & n8n integrations

    May 2025

    Make & n8n Integrations
    • Tavily is now available for no-code integration through n8n.

      Integrate Tavily with n8n to enhance your workflows with real-time web search and content extraction—without writing code. With Tavily’s powerful search and extraction capabilities, you can seamlessly integrate up-to-date online information into your n8n automations.

    • Integrate Tavily with Make without writing a single line of code.

      With Tavily’s powerful search and content extraction capabilities, you can seamlessly integrate real-time online information into your Make workflows and automations.

    Markdown format

    May 2025

    Tavily Extract
    format parameter
    • Type: enum<string>
    • Default: markdown
    • The format of the extracted web page content. markdown returns content in markdown format. text returns plain text and may increase latency.
    • Available options: markdown, text

    Advanced search & chunks per source

    April 2025

    Tavily Search
    search_depth and chunks_per_sourceparameters
    • search_depth
      • Type: enum<string>
      • Default: basic
      • The depth of the search. advanced search is tailored to retrieve the most relevant sources and content snippets for your query, while basic search provides generic content snippets from each source.
      • A basic search costs 1 API Credit, while an advanced search costs 2 API Credits.
      • Available options: basic, advanced
    • chunks_per_source
      • Chunks are short content snippets (maximum 500 characters each) pulled directly from the source.
      • Use chunks_per_source to define the maximum number of relevant chunks returned per source and to control the content length.
      • Chunks will appear in the content field as: <chunk 1> […] <chunk 2> […] <chunk 3>.
      • Available only when search_depth is advanced.
      • Required range: 1 < x < 3

    Tavily crawl (BETA)

    April 2025

    Tavily Crawl
    • Tavily Crawl enables you to traverse a website like a graph, starting from a base URL and automatically discovering and extracting content from multiple linked pages. With Tavily Crawl, you can:
      • Specify the starting URL and let the crawler intelligently follow links to map out the site structure.
      • Control the depth and breadth of the crawl, allowing you to focus on specific sections or perform comprehensive site-wide analysis.
      • Apply filters and custom instructions to target only the most relevant pages or content types.
      • Aggregate extracted content for further analysis, reporting, or integration into your workflows.
      • Seamlessly integrate with your automation tools or use the API directly for flexible, programmatic access.
      Tavily Crawl is ideal for use cases such as large-scale content aggregation, competitive research, knowledge base creation, and more.
      For full details and API usage examples, see the Tavily Crawl API reference.
    xgithublinkedinwebsite
    Powered by Mintlify
    Assistant
    Responses are generated using AI and may contain mistakes.