Google search results in n8n
In n8n, Google results come from an HTTP Request node: method POST, URL ending in /search, your key sent as the X-API-KEY header through a Header Auth credential, and a JSON body with q, gl and hl. Then split the organic field into items to use each result in the next nodes.
Last updated:
Key takeaways
- No SDK to install: the built-in HTTP Request node is enough.
- Send the key in the X-API-KEY header, never in a URL or in browser code.
- 202 means the search is still running: poll GET /requests/{requestId}.
- 60 searches per minute per account by default; 429 and 503 are not charged.
Step by step
Create the credential
In n8n, add a credential of type Header Auth: name X-API-KEY, value your BestSERP key. Keys never appear in the workflow itself.
Configure the HTTP Request node
Method POST, URL https://api.bestserp.com/search, Authentication: Generic Credential Type > Header Auth (the credential above), Send Body: JSON with the fields below. Use an expression such as {{ $json.keyword }} for q to search a value from a previous node.
JSON body{ "q": "best running shoes", "gl": "us", "hl": "en", "timeout": 120 }One item per result
Add a Split Out node on the field organic. Each result becomes an item with position, title, link and snippet for the next nodes (a sheet, a database, a message).
Schedule it
Start the workflow with a Schedule Trigger to run daily: a simple rank or news monitor without code.
Status codes to handle
| Status | Code | Meaning | Credits |
|---|---|---|---|
| 202 | - | Not finished within timeout (or async: true). Poll pollUrl. | Reserved |
| 400 | invalid_request | Malformed body or a parameter out of range. | No |
| 400 | unknown_parameter | A field the API does not know (typo?). | No |
| 400 | unsupported_parameter | A known field that this endpoint does not support yet (e.g. location). | No |
| 401 | missing_api_key / invalid_api_key | No key, or the key is wrong or revoked. | No |
| 402 | insufficient_credits | Your balance is too low for this request. | No |
| 403 | account_suspended | The account is suspended. | No |
| 404 | not_found | Unknown requestId, or it belongs to another account. | - |
| 429 | rate_limited | Too many requests this minute. See Retry-After. | No |
| 502 | search_failed | The search could not be completed (blocked or timed out). | Refunded |
| 503 | busy | No capacity right now. Retry after Retry-After seconds. | Refunded |
Frequently asked questions
Is there a BestSERP node for n8n?
How do I search a list of keywords?
What if the node gets status 202?
How many credits does a workflow use?
Start with 3,000 free searches
No credit card. Sign in with Google, create a key, send your first request.