Ceven Web Search API

Playground POST /api/v1/web-search  ·  auth: X-Api-Key  ·  docs JSON
Sent as the X-Api-Key request header. The pre-filled demo key is rate-limited to 1000 queries/day and shared with everyone using this page; for your own key contact the Ceven team.
The search string used to retrieve results. Phrase queries with "…" are honored by most upstream engines.
Number of results to return per upstream provider (integer, 1–50, default 10). The merged response may return more or fewer after URL-dedup + consensus ranking.
Optional. Leave all unchecked to fan out across every alive provider. Today, only SearXNG is reliably alive — the paid keys are exhausted (Tavily 432, Serper 400, Brave 402, you.com 401).
ISO 3166-1 alpha-2 codes — keep ONLY results at these country-code TLDs. Generic gTLDs (.com / .org / .io / .ai) always pass, so US drops amazon.de while keeping amazon.com.
Comma-separated, empty = allow everything.
ISO 3166-1 alpha-2 codes — DROP results at these ccTLDs. Applied after country_include. e.g. DE, FR, IT drops amazon.de + .fr + .it regardless of include list.

Code example


    


    

      

        
Response

        awaiting request
      

      

      
// Click "Send Request" to call the API.
// Results will appear here, parsed below, and your rate-limit
// counter will update in real time from the response headers.

      

      

        Rate-limit headers (x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset) are surfaced above. The demo key resets on a rolling 24h window per key, not calendar UTC.