Reserp Haystack Integration

ReserpWebSearch exposes the Reserp Google Search API v2 as a minimal Haystack component.

The component accepts a complete Google Search URL, makes one request to POST /v2/serp/urls, and returns the public JSON under Haystack's required output key. The v2 URL index is flat, page ordered, and deduplicated, with optional visible text for each URL. The component adds no retries, timeout policy, concurrency management, caching, queues, result conversion, or automatic pagination.

Installation

pip install reserp-haystack

Usage

from haystack.utils import Secret
from haystack_integrations.components.websearch.reserp import ReserpWebSearch

search = ReserpWebSearch(api_key=Secret.from_env_var("RESERP_API_KEY"))
result = search.run(
    url="https://www.google.com/search?q=photonic+computing&gl=us&hl=en"
)["response"]

if result["ok"]:
    for item in result["urls"]:
        print(item.get("text"), item["url"])

Every successful response includes pagination.next_url. Submit that value in a later component call to advance; its presence does not prove another page contains results. Do not infer pagination from len(result["urls"]).

The surrounding pipeline owns retries, timeouts, task queues, concurrency, observability, and pagination. When the API reports retryable, this package exposes that field and takes no action itself.

Migrating from 0.1

Version 0.2 moves from the v1 recursive results[] response to the v2 flat urls[] index. Other notable field renames are url → request.url, finalUrl → page.url, pagination.nextUrl → pagination.next_url, and billingSource → billing_source.

For typed result families, SERP features, and explicit positions, call the structured v2 endpoint directly or use an official Reserp SDK.

Resources

• Reserp API documentation
• OpenAPI definition
• Postman collection

License

MIT