Run a SerpApi search
Relays to https://serpapi.com/search, slotting the secret api_key in at the front of the
query string. GET only. Controls ride the query string and reach SerpApi verbatim — the
gateway defaults nothing (SerpApi’s own default for engine is google). Any client
api_key in the query is dropped.
Authentication
Your per-client bearer token — the API key the gateway issued to you. Present it in
Authorization: Bearer <token> form. A token that is missing, unknown, or revoked draws a
401. Before the call is sent upstream the token is removed (stripped, or swapped for the
upstream’s own credential); it never makes it past the gateway.
Query parameters
Which engine to search. Left unset, SerpApi falls back to google.
Format of the reply — default json; choose html to get the raw SERP page.
Response
Whatever the upstream answered, relayed as-is (status, headers, body). Rendered here as JSON; the true shape is the upstream provider’s to define.