Introduction

This pull request introduces a robust and extensible durable web search API for the Golem platform, implemented in Rust. This web-search component provides a unified interface for performing web searches across multiple providers—including Brave, Google, Serper, and Tavily—enabling users to leverage the strengths of each search engine through a single, consistent API.

Key features include support for durable, replayable search sessions, advanced filtering (such as domain inclusion/exclusion and safe search levels), multilingual and regional queries, and the ability to retrieve both standard and enriched content (like images and HTML snippets). The API is designed for reliability and flexibility, making it suitable for a wide range of use cases, from simple information retrieval to advanced, policy-driven or content-sensitive searches.


Tests Added

A comprehensive suite of tests has been included to validate the new web search API, including:

  1. Basic Search Test:
    Verifies simple search queries return expected results.

  2. Session Pagination Test:
    Ensures multiple pages of results can be fetched in a session.

  3. Error Handling Test:
    Confirms graceful handling of invalid queries and provider errors.

  4. Domain Filtering Test:
    Tests inclusion and exclusion of specific domains in search results.

  5. Image and HTML Content Test:
    Checks correct handling of image results and HTML snippets.

  6. Multilingual and Regional Search Test:
    Validates search with different languages and regions.

  7. Advanced Search Test:
    Demonstrates advanced search with high safe search and content chunks.
    This test ensures the API can perform advanced queries with strict safe search settings and return results in content chunks, supporting use cases like child safety and trusted content discovery.

    /closes #34 /claim #34

Claim

Total prize pool $2,500
Total paid $0
Status Pending
Submitted July 02, 2025
Last updated July 02, 2025

Contributors

SA

SaikiranSurapalli

@SaikiranSurapalli17

100%

Sponsors

GO

Golem Cloud

@golemcloud

$2,500