Skip to content
Docs

Retrieve archived Google search JSON

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

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

Poll or retrieve the JSON archive for a Google search. Pending internal Queued, Running, and legacy Processing rows return HTTP 202 with public status Processing. Final rows return HTTP 200 with public status Success or Error. 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

Final archived search JSON.

›

application/json

  • errorstring
  • 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_parametersSerpApiSearchParametersrequired

    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
  • search_informationSerpApiSearchInformation

    High-level information extracted from the Google results page.

    ›Show fields
    • query_displayedstring | null
    • total_resultsinteger | null
    • time_taken_displayednumber | null
    • organic_results_statestring | null
    • page_numberinteger | null
  • organic_resultsarray of SerpApiOrganicResult
    ›Show fields
    • positionintegerrequired
    • titlestring | null
    • linkstring · uri | null
    • displayed_linkstring | null
    • snippetstring | null
    • snippet_highlighted_wordsarray of string
    • sourcestring | null
  • related_searchesarray of object

    Real Google related-search suggestions only.

  • paginationSerpApiPagination
    ›Show fields
    • currentinteger
    • previousstring · uri | null
    • nextstring · uri | null
    • other_pagesobject
  • serpapi_paginationSerpApiPagination
    ›Show fields
    • currentinteger
    • previousstring · uri | null
    • nextstring · uri | null
    • other_pagesobject
  • error_diagnosticsobject

    Safe failure diagnostics, including CAPTCHA provider metadata when available. Raw secrets, cookies, tokens, proxy credentials, and API keys are not included.

202

Search is queued or running. Continue polling.

›

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.

503

Platform, configuration, or storage dependency is temporarily unavailable. New searches normally queue when the runner is at capacity or briefly unavailable.

›

application/json

  • errorstringrequired

    SerpApi-compatible error message.

  • error_codestring

    Machine-readable Lempile error code when available.

Was this page helpful?