scrapeunblocker-yahoo-search

n8n community node for the Yahoo Search Scraper Apify Actor by ScrapeUnblocker: Yahoo organic results and ads with position, title, URL and snippet as JSON

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.2
Author: ScrapeUnblocker

Documentation

n8n-nodes-scrapeunblocker-yahoo-search

This is an n8n community node. It lets you search Yahoo for one or more queries in your n8n workflows and get the results pages as JSON: organic results plus the top and bottom ads, each with position, title, URL, displayed URL, domain and snippet.

The node runs the Yahoo Search Scraper Actor by ScrapeUnblocker on the Apify platform with your own Apify account, waits for the run to finish and returns every scraped record as an n8n item.

n8n is a fair-code licensed workflow automation platform.

Installation
Credentials
Operations
Output
Example workflow
Pricing
Compatibility
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation. The npm package name is n8n-nodes-scrapeunblocker-yahoo-search.

Credentials

The node authenticates with an Apify API token. Every run starts on the Apify account that owns the token and is billed to that account (see Pricing).

1. Create an Apify account (skip if you already have one)

  1. Go to console.apify.com/sign-up and sign up with email, Google or GitHub.
  2. Confirm your email address if Apify asks you to.

The free Apify plan needs no credit card and includes a monthly usage credit, which is enough to try the node. Current plan limits are listed on apify.com/pricing.

2. Get your API token

  1. Open Apify Console and go to Settings → API & Integrations, or open console.apify.com/settings/integrations directly.
  2. Find the Personal API tokens section.
  3. Either use the existing token (the one marked Default API token created on sign up): click the eye icon to reveal it or the copy icon to copy it.
  4. Or create a dedicated token for n8n (recommended, so you can revoke it without affecting anything else):
    1. Click + Add new token (the button may read Create new token).
    2. In the Create a new personal API token dialog, enter a Description such as n8n.
    3. Optionally switch on Set expiration date and pick a date.
    4. Leave Limit token permissions switched off. A token with limited permissions may not be allowed to run this Actor or read its results.
    5. Click Create and copy the new token.

The token starts with apify_api_. Treat it like a password: anyone who has it can run Actors on your account. You can revoke or rotate it on the same page at any time.

Working in an Apify organization? Switch to the organization in Apify Console first and copy a token from its API & Integrations page, so runs are billed to the organization.

3. Add the credential in n8n

  1. Add the Yahoo Search Scraper node to a workflow and open it.
  2. In Credential to connect with, choose Create new credential. (You can also create an Apify API credential from the n8n credentials list.)
  3. Paste the token into API Key and click Save. n8n checks the token right away; an invalid token shows Authorization failed - please check your credentials.

Already have an Apify API credential in n8n (for example from the official Apify node)? This node uses the same credential type, so you can simply select it.

Operations

Pick a Resource and an Operation. Each n8n input item starts one Apify run. List fields accept several values separated by commas or new lines, or an array returned by an expression. Search Queries take one value per line, because a value may itself contain commas.

Resource Operation Fields Returns
Result Search Search Queries (required) - One or more Yahoo search queries, one per line. Each query is searched separately
Result Pages - How many result pages to fetch per query (1-10). Each page returns about 7 organic results plus the ads Yahoo shows on it
One item per organic result or ad

Options

Option Description
Include Ads Whether to also return the paid results shown above and below the organic list
Language Only return results in this language, as an ISO-639-1 code (e.g. en or de). Leave empty for the regional site's default.
Parallel Queries How many queries to search at the same time (1-5)
Search From Country The country the search runs from. It sets the result market and the ads shown.
Timeout (Seconds) Maximum run time of the Apify run. 0 keeps the Actor default. A run that times out fails the node.

How a run works

  1. The node starts the Actor on your Apify account with the fields you set.
  2. It waits for the run to finish.
  3. It returns every record from the run's dataset as a separate n8n item.

The run is also visible in Apify Console under Runs. If a run fails or times out, the node error links to the run log and tells you whether any results were saved before it stopped.

Stopping the n8n execution only stops the node from waiting: the Apify run keeps going and its results are still charged. To stop it, abort the run in Apify Console under Runs, and use Timeout (Seconds) to cap long runs up front.

Use as an AI Agent tool

The node can be attached to an n8n AI Agent as a tool, so the agent can call it on its own.

Output

  • One item per organic result or ad, with the search query, result type (organic, ad_top or ad_bottom), position, title, URL, displayed URL, domain and snippet.

Fields of a returned item: keyword, type, position, title, url, displayedUrl, domain, description.

Example item (shortened):

{
  "keyword": "espresso machine",
  "type": "organic",
  "position": 1,
  "title": "Amazon.com: Espresso Machines: Home & Kitchen: Super...",
  "url": "https://www.amazon.com/Espresso-Machines-Coffee-Tea-Kitchen/b?node=289748",
  "displayedUrl": "https://www.amazon.com › Espresso-Machines-Coffee-Tea",
  "domain": "amazon.com",
  "description": "Discover Espresso Machines on Amazon.com at a great price. Our Small Applianc..."
}

Example workflow

To try the node in a minute, copy the workflow below, paste it into the n8n editor (Ctrl+V / Cmd+V), open the Yahoo Search Scraper node, select your Apify API credential and click Execute workflow.

{
  "nodes": [
    {
      "parameters": {},
      "name": "When clicking 'Execute workflow'",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        0,
        0
      ]
    },
    {
      "parameters": {
        "resource": "result",
        "operation": "search",
        "keywords": "espresso machine",
        "pagesToCheck": 1,
        "options": {}
      },
      "name": "Yahoo Search Scraper",
      "type": "n8n-nodes-scrapeunblocker-yahoo-search.yahooSearchScraper",
      "typeVersion": 1,
      "position": [
        220,
        0
      ]
    }
  ],
  "connections": {
    "When clicking 'Execute workflow'": {
      "main": [
        [
          {
            "node": "Yahoo Search Scraper",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

Pricing

The node itself is free. The Actor is paid per result on Apify: $0.50 per 1,000 results plus a tiny start fee per run ($0.00005), charged to the Apify account of your token. Every item the node returns counts as one result. The current price is always shown on the Actor page, and your spending is visible in Apify Console.

Compatibility

Tested with n8n 2.40 (self-hosted).

Resources

Version history

  • 0.1.0: Initial release
  • 0.1.1: First release published from GitHub Actions with an npm provenance statement
  • 0.1.2: Node category renamed to Marketing & Content, the name n8n's verification scanner accepts

Discussion