NAME

Net::Async::WebSearch::Provider::Tavily - Tavily Search API provider

VERSION

version 0.003

SYNOPSIS

my $tavily = Net::Async::WebSearch::Provider::Tavily->new(
  api_key => $ENV{TAVILY_API_KEY},
);

DESCRIPTION

Provider for https://tavily.com, a search API built for LLM and agent workflows. Sends a JSON POST to the /search endpoint and parses the results array from the JSON response.

API KEY

Sign up at https://app.tavily.com. No credit card required — the free tier grants a monthly allowance of API credits. The key (prefixed tvly-) is shown in the account dashboard after you log in.

api_key

Required. Sent as an Authorization: Bearer header.

endpoint

Override the endpoint URL. Default https://api.tavily.com/search.

Honours limit (max_results, clamped to the upstream maximum of 20), language (language, ISO 639-1), and region (country). A topic override may be passed; it defaults to general.

SEE ALSO

https://tavily.com/

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-net-async-websearch/issues.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de> https://raudss.us/

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.