Skip to content
Docs

Retrieve archived Google search HTML

Early access. Tell us what you're building and we'll set you up. Contact us

GETapi.lempile.com/searches/{searchId}.html

Retrieve raw Google HTML for a successful browser-backed search. Pending rows return HTTP 202 with the same processing JSON used by archive polling. This route requires the search.read scope.

Authentication

X-API-KEY header·A Lempile API key, made in the dashboard under Access tokens.

Path parameters

  • searchIdstringrequired

    Search archive id returned in search_metadata.id.

    ≥ 8 chars

Query parameters

  • api_keystring

    API key with search.write for search creation routes or search.read for archive routes. X-API-KEY may be used instead.

Responses

200

Raw Google Search HTML captured from the browser run.

›

text/html

string
202

Search is queued or running. Continue polling the JSON endpoint.

›

application/json

  • search_metadataSerpApiSearchMetadatarequired

    SerpApi-compatible lifecycle metadata. Internal Queued and Running states are exposed as public Processing plus detail fields.

    ›Show fields
    • idstringrequired
    • statusstringrequired
      One ofProcessingSuccessError
    • status_detailstring

      Internal state such as Queued, Running, or a final status detail.

    • runner_status_detailstring

      Runner detail such as queued, runner_claimed, lease_renewed, completed, search_queue_timeout, or runner_lease_expired.

    • json_endpointstring · uri
    • pixel_position_endpointstring · uri
    • raw_html_filestring · uri
    • created_atstring
    • queued_atstring
    • started_atstring
    • lease_expires_atstring
    • processed_atstring | null
    • google_urlstring | null
    • total_time_takennumber | null
    • captcha_autosolveobject

      Safe CAPTCHA autosolve summary when a Google block page required solving.

  • search_parametersSerpApiSearchParameters

    Normalized search parameters used for the Google request.

    ›Show fields
    • enginestringrequired
      One ofgoogle
    • qstringrequired
    • location_requestedstring | null
    • location_usedstring | null
    • google_domainstringrequired
    • hlstring | null
    • glstring | null
    • tbsstring | null
    • startinteger | null
    • devicestringrequired
      One ofdesktopmobiletablet
401

Missing or invalid API key.

›

application/json

  • errorstringrequired

    SerpApi-compatible error message.

  • error_codestring

    Machine-readable Lempile error code when available.

403

The API key does not include the required search.read scope.

›

application/json

  • errorstringrequired

    SerpApi-compatible error message.

  • error_codestring

    Machine-readable Lempile error code when available.

404

Search archive id was not found for the current workspace.

›

application/json

  • errorstringrequired

    SerpApi-compatible error message.

  • error_codestring

    Machine-readable Lempile error code when available.

Was this page helpful?