How to integrate ThorData with n8n
This tutorial will guide you through installing the ThorData n8n node, configuring SERP API credentials, and running your first search workflow.
You can integrate ThorData into n8n using the n8n-nodes-thordata-serp community node. Once configured, you can directly call the ThorData SERP API within your n8n workflows to retrieve structured search results from search engines such as Google, Bing, DuckDuckGo, and Yandex.
Overview
n8n is a workflow automation platform that allows you to visually connect applications, APIs, and AI agents. ThorData provides SERP API capabilities suitable for real-time search result retrieval, localized search analysis, SEO monitoring, market research, and agent-driven web data workflows.
With the ThorData n8n integration, you can:
Execute SERP searches on Google, Bing, DuckDuckGo, Yandex, and more directly within n8n.
Utilize localized search parameters such as country/region, language, device, and market.
Integrate search results into workflows involving AI agents, reporting pipelines, alerts, data enrichment, and more.
Pass advanced SERP parameters via raw request mode for scenarios requiring greater control.
Preparations
Before you begin, please ensure you have:
A working n8n instance.
Permissions for installing n8n community nodes.
A ThorData SERP API key starting with
sk_.
Specific steps
Installation
Install the ThorData node in the Community Nodes panel of n8n:
Start your n8n instance.
Create a new workflow or open an existing one for editing, and search for thordata.
Click on the "Install Node" option.
After installation, n8n will add:
A credential type named Thordata SERP API.
A workflow node named Thordata SERP.
Configure Credentials
Before adding nodes to the production workflow, it is recommended to create ThorData credentials:
Open Credentials in n8n.
Create new credentials and select Thordata SERP API.
Paste your ThorData SERP API Key.
Unless you are testing an internal development environment, keep the default endpoint.
Save or test the credential.
Both credential testing requests and workflow execution requests send the following source identifier to ThorData for platform usage statistics:
Origin: n8nCreate Your First Workflow
Run a ThorData search in n8n:
Create a new workflow or open an existing one.
Add the Thordata SERP node.
Select your Thordata SERP API credentials.
Select an operation, such as Google Search.
Fill in the fields displayed for the operation.
Execute the node.
The node returns the ThorData SERP JSON response along with request metadata for the selected operation. You can pass the output to downstream n8n nodes, such as AI Agents, Code nodes, databases, spreadsheets, notification services, or reporting tools.
Example: Google Search
You can use this action when you need to retrieve standard web search results from Google.
Example: Bing Image Search
This action can be used when the workflow needs to retrieve image search results from Bing.
Example: Google Lens Search
Google Lens Search can be used when the workflow takes an image URL as input.
Example: Yandex Search
Yandex Search can be used when a workflow requires Yandex SERP results.
Advanced Usage: Raw SERP Request
You can use a Raw SERP Request when you want to select a pre-generated SERP action while manually passing advanced parameters.
The node automatically uses the correct query field based on the selected action—such as q、text、url、product_id、patent_id、author_id or trend。
The Extra Parameters JSONmust be a valid JSON object. This field is merged into the request after the visible form fields. The node controls the engine and the default json=2 value, so extra parameters cannot override the selected search engine.
Supported operations
Thordata SERP nodes expose SERP actions generated from ThorData metadata. The list of actions includes:
Web Search
Google Search、Bing Search、DuckDuckGo Search、Yandex Search
Image
Google Images、Bing Images、Google Lens
News
Google News、Bing News
E-commerce
Google Shopping、Google Play
Research
Google Scholar、Google Patents
Local & Travel
Google Maps、Google Hotels、Google Flights
Market and Trend Data
Google Finance、Google Trends
Troubleshooting
401 or 403 error
Please check:
Does the API key start with sk_?
Is the credential type Thordata SERP API?
Has the API key expired or been disabled?
If necessary, please generate a new SERP API Key in ThorData and update the n8n credentials.
400 error
Please check:
Whether the required query or URL fields have been filled in for the selected operation.
Whether the Extra Parameters JSON is valid JSON.
Whether the parameters match the selected SERP operation.
429 error
If the workflow triggers rate limiting, you can try:
Reduce n8n workflow concurrency.
Add batching or delay nodes between requests.
Check your ThorData quotas and rate limits.
Network error
If n8n cannot access ThorData, please check:
Check if the n8n runtime environment can access https://serpapi.thordata.net.
If your environment requires an outbound proxy, configure the proxy at the n8n runtime environment level.
Check for firewall, DNS, or regional network restrictions in the deployment environment.
Next step
Once the node configuration is complete, you can connect the ThorData SERP results to:
AI Agent node: provides real-time search context to the model.
Database or table node: used for periodic SERP tracking.
Notification node: used for alerts regarding news, rankings, or competitor changes.
Code node: used for custom logic for filtering, sorting, extraction, or data augmentation.
Last updated
Was this helpful?