n8n-nodes-yandex-search-api
v0.1.1
Published
Search Yandex and return organic results with titles, links, and snippets. Apify-backed n8n community node, pay-per-result, and usable as an AI agent tool.
Maintainers
Readme
n8n-nodes-yandex-search-api
An n8n community node that searches Yandex and returns structured organic results: position, title, link, and snippet. It is backed by the Yandex Search API on Apify and bills per result, so there are no subscriptions and no minimums.
Installation · Credentials · Operations · Output · Example workflows · Pricing · Resources
What it does
Give the node a query, and it returns one item per organic result with the position, title, link, snippet, and displayed link. It also works as an AI Agent tool, so an agent can run Yandex searches on demand.
- Search any Yandex domain, for example
yandex.comoryandex.ru - Localize with a language code and a Yandex region ID
- Sort by relevance or date, and restrict to a time period
- Choose how much data to return per result: Simplified, Raw, or Selected Fields
Installation
Follow the n8n community nodes installation guide:
- In n8n, open Settings > Community Nodes.
- Select Install.
- Enter
n8n-nodes-yandex-search-apias the npm package name. - Agree to the risks of using community nodes, then select Install.
After it installs, the Yandex Search node appears in the nodes panel.
n8n Cloud only allows verified community nodes. Until this node is verified, install it on a self-hosted n8n instance.
Credentials
You need a free Apify account and an API token.
- Sign in to the Apify Console.
- Open Settings > Integrations and copy your Personal API token.
- In n8n, create a new Apify API credential and paste the token.
- Use the credential's Test button to confirm it works.
The node also supports Apify OAuth2 if you prefer to connect that way.
Operations
Search Result > Search returns organic results for a query.
| Parameter | Description |
| --- | --- |
| Search Query | The query to search for. Required. |
| Yandex Domain | Which Yandex domain to query. Defaults to yandex.com. |
| Language | Two-letter language code. Optional. |
| Region ID | Yandex region ID (lr) to localize results. -1 to omit. |
| Maximum Pages | How many result pages to fetch. |
| Results per Page | How many results to request per page. |
| Sort Mode | Relevance or Date. |
| Time Period | All Time, Last Day, Last Two Weeks, or Last Month. |
| Output | How much data to return: Simplified, Raw, or Selected Fields. |
Output
Each organic result is returned as its own n8n item. The Output parameter lets you choose how much to return:
- Simplified (default): a compact object with
position,title,link,snippet, anddisplayedLink. This mode is also used automatically when the node runs as an AI Agent tool, to keep responses small. - Raw: every field the API returns for each result, using the original field names below.
- Selected Fields: pick exactly which fields to include.
Fields (Raw and Selected Fields)
| Field | Type | Description |
| --- | --- | --- |
| position | integer | Rank of the result on the page |
| title | string | Result title |
| link | string | Result URL |
| snippet | string | Result snippet text |
| displayed_link | string | The link as displayed by Yandex |
| sitelinks | array | Additional sitelinks, when present |
Example workflows
1. Track rankings for a keyword
- Schedule Trigger: run daily.
- Yandex Search: set Search Query to your keyword, Output
Simplified. - Filter: keep the item whose
linkmatches your domain; log itspositionover time.
2. Collect results into a sheet
- Manual Trigger.
- Yandex Search: your query, Maximum Pages
3. - Google Sheets: append each result's
position,title, andlink.
3. Let an AI Agent search Yandex
- AI Agent node.
- Attach Yandex Search as a tool.
- Ask the agent a question; it calls the node (in Simplified mode) and answers using live Yandex results.
Pricing
This node calls the Yandex Search API on Apify, which is billed pay-per-result, with no subscription and no minimums. Apify also includes a free monthly usage tier that covers typical volumes. See the Actor page for current rates.
