Google SERP

Google search (SERP)

Run a Google search and return structured JSON results.

Same auth and billing gates as POST /api/v1/scrape. Charged only when a page is actually parsed; a Google block or a run with no results is free.

post/api/v1/serp

Request

  • Base URL: https://api.finedata.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.finedata.ai/api/v1/serp
  • Auth: HTTP bearer

Headers

authorizationstring nullable
x-api-keystring nullable

Request body

qstring required

Search query (1-2048 chars)

glstring

Google country: ISO 3166-1 alpha-2 (e.g. 'us')

hlstring

Google interface language: ISO 639-1, optional region (e.g. 'en' or 'en-GB')

locationstring nullable

Accepted but unused in P1 (only gl/hl apply)

startinteger

Result offset; 0-90 in steps of 10 (10 results per page)

devicestring

Only 'desktop' is supported in P1

include_htmlboolean

Also return the raw Google HTML

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.