n8n-nodes-reserp
v0.3.1
Published
Minimal n8n community node for the Reserp Google Search API v2
Maintainers
Readme
n8n-nodes-reserp
An n8n community node for the Reserp Google Search API v2.
It accepts a complete Google Search URL, makes one request per input item, and returns the selected public v2 payload as the n8n output item. It adds no retries, timeout policy, concurrency management, caching, queues, result conversion, or automatic pagination.
Installation
Follow the n8n community-node installation guide.
Response shapes
- Search (default) calls
POST /v2/serp/searchand returns flat, page-ordered, deduplicated entries inresults[]. - Structured Results calls
POST /v2/serp/structuredand returns typed, page-ordered SERP blocks inblocks[].
In either mode, the node forwards the public response without reshaping it.
Credentials
Create a Reserp API credential and enter your Reserp API key. n8n stores the key and sends it directly to https://api.reserp.ai as a bearer token. No OAuth flow or additional Reserp service is involved.
When you explicitly test the credential, n8n sends one empty request to the v2 Search endpoint. A valid key receives the non-billable invalid_request response; an invalid key receives authentication_failed. The test does not run a Google search.
Usage
Provide a complete URL such as:
https://www.google.com/search?q=photonic+computing&gl=us&hl=enEvery successful response includes pagination.next_url. Submit that URL in a later node execution to advance; its presence does not guarantee that another page contains results. Do not infer pagination from a result-array length.
The surrounding n8n workflow owns retries, timeouts, error branches, queues, concurrency, observability, and pagination.
Migrating
From 0.2, select Search and replace /v2/serp/urls with /v2/serp/search and urls[] with results[]. Existing workflows whose saved option is urls are routed to Search for compatibility. If you used the structured beta, replace grouped results and features with the stable page-ordered blocks[] model.
Resources
Version history
0.3.0: adopt stable Searchresults[]and structuredblocks[]contracts.0.2.0: migrate to the Reserp v2 beta and add response selection.0.1.1: add the required non-billable credential test.0.1.0: initial one-request Reserp node.
License
MIT
