NAME
Net::Async::WebSearch::Provider::Yandex - Yandex Search API (XML) provider
VERSION
version 0.002
SYNOPSIS
my $y = Net::Async::WebSearch::Provider::Yandex->new(
api_key => $ENV{YANDEX_API_KEY},
folderid => $ENV{YANDEX_FOLDER_ID},
l10n => 'en',
);DESCRIPTION
Provider for the Yandex Search API (the XML-over-HTTP interface, a.k.a. Yandex XML, now billed through Yandex Cloud). Parses the grouped doc nodes out of the XML envelope via XML::LibXML.
API KEY
- Signup: https://console.yandex.cloud/link/search-api/
- Docs: https://yandex.cloud/en/docs/search-api/
You need a Yandex Cloud account and a "folder" (their project-scope concept) — copy the folder id from the Cloud Console, that's your folderid. Then create a service account, grant it the search-api.executor role, and issue an API key (or IAM token) — that's api_key. Pricing is via Yandex Cloud credits; standard Cloud welcome credits give you a working free trial.
api_key
Required. A Yandex Cloud API key (or IAM token, same placement) with access to the search-api scope.
folderid
Required. Your Yandex Cloud folder id — the API is billed per folder.
l10n
Interface language: en (default), ru, tr, be, kk, uk. Affects the language of system messages and, combined with lr (region), the result set.
endpoint
Override the endpoint URL. Default https://yandex.com/search/xml. Use the .ru host if you hit the TR/BY/KZ/UZ clusters.
search
Honours limit (wired into groupby=groups-on-page), l10n, region (mapped to Yandex' lr — numeric region codes), safesearch (mapped to filter: strict | moderate | none), sortby (rlv | tm), and groupby (raw pass-through if you know Yandex' grouping DSL).
SEE ALSO
https://yandex.cloud/en/docs/search-api/
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.