Tavily Search Integration

Field	Description	Required	Format
Tavily API Key	Your Tavily API key for authentication	Yes	`tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

web_search — Performs comprehensive web search using Tavily's AI-powered search engine

Parameters

string

required

Search query

integer

Maximum number of results to return (1-20) (Default: 5)

string

Search depth: basic (faster) or advanced (thorough) (Default: basic)

array

List of domains to specifically include in search results

array

List of domains to specifically exclude from search results

Response

{
  "$defs": {
    "TavilyResult": {
      "additionalProperties": false,
      "description": "One row in a Tavily search response.",
      "properties": {
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Title"
        },
        "content": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Content"
        },
        "score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Score"
        },
        "raw_content": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Raw Content"
        }
      },
      "title": "TavilyResult",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Query"
    },
    "answer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Answer"
    },
    "results": {
      "items": {
        "$ref": "#/$defs/TavilyResult"
      },
      "title": "Results",
      "type": "array"
    },
    "images": {
      "items": {
        "type": "string"
      },
      "title": "Images",
      "type": "array"
    },
    "response_time": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Response Time"
    },
    "request_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Request Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "WebSearchOutput",
  "type": "object"
}

answer_search — Performs web search and generates a direct AI answer to the query with supporting sources

Parameters

string

required

Question or search query

integer

Maximum number of supporting results to return (Default: 5)

string

Search depth: basic or advanced (Default: advanced)

array

List of domains to specifically include

array

List of domains to exclude

Response

{
  "$defs": {
    "TavilyResult": {
      "additionalProperties": false,
      "description": "One row in a Tavily search response.",
      "properties": {
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Title"
        },
        "content": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Content"
        },
        "score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Score"
        },
        "raw_content": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Raw Content"
        }
      },
      "title": "TavilyResult",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Query"
    },
    "answer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Answer"
    },
    "results": {
      "items": {
        "$ref": "#/$defs/TavilyResult"
      },
      "title": "Results",
      "type": "array"
    },
    "images": {
      "items": {
        "type": "string"
      },
      "title": "Images",
      "type": "array"
    },
    "response_time": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Response Time"
    },
    "request_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Request Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "AnswerSearchOutput",
  "type": "object"
}

news_search — Searches recent news articles using Tavily's specialized news search

Parameters

string

required

News search query

integer

Maximum number of news articles to return (Default: 5)

integer

Number of days back to search (1-365) (Default: 3)

array

News domains to include (e.g., reuters.com, bbc.com)

array

News domains to exclude

Response

{
  "$defs": {
    "TavilyResult": {
      "additionalProperties": false,
      "description": "One row in a Tavily search response.",
      "properties": {
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Title"
        },
        "content": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Content"
        },
        "score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Score"
        },
        "raw_content": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Raw Content"
        }
      },
      "title": "TavilyResult",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Query"
    },
    "results": {
      "items": {
        "$ref": "#/$defs/TavilyResult"
      },
      "title": "Results",
      "type": "array"
    },
    "images": {
      "items": {
        "type": "string"
      },
      "title": "Images",
      "type": "array"
    },
    "response_time": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Response Time"
    },
    "request_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Request Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "NewsSearchOutput",
  "type": "object"
}

Using

Providers

Building

Tools

Tavily Search Integration for AI Agents & Workflows

Overview

Authentication

API Key Authentication

Required Credentials

ModuleX Managed Key

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Jina AI

Ahrefs

Airweave

Links

​Overview

​Authentication

​API Key Authentication

​Required Credentials

​ModuleX Managed Key

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Jina AI

Ahrefs

Airweave

​Links

Overview

Authentication

API Key Authentication

Required Credentials

ModuleX Managed Key

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links