Google Search

Google Search (Light)

Perform a lightweight Google search. Returns structured JSON results.

Limitations:

  • Max 200 results per query (10 pages × 20 results)

Tip: Use query modifiers like filetype:pdf, site:reddit.com, or "exact phrase" in your query. * * Response includes total_results at the root level as a convenience accessor * that mirrors search_information.total_results. people_also_search_for is * best-effort autocomplete enrichment and may be empty. * * @queryParam query string required The search query. Use modifiers like filetype:pdf, site:reddit.com, or "exact phrase". Example: artificial intelligence * @queryParam num integer Number of results per page (1-20). Default: 10. Example: 10 * @queryParam page integer Page number for pagination (1-10). Mutually exclusive with "start". Example: 1 * @queryParam start integer Starting index for offset-based pagination (0-170). Mutually exclusive with "page". Example: 0

get/search-light

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/search-light
  • Auth: API key in header X-API-KEY

Query parameters

querystring required

Required

numinteger nullable

Results per page (1-20, default 10).

startinteger nullable

Starting index for offset-based pagination (0-170). Mutually exclusive with "page".

pageinteger nullable

Page number for pagination (1-10, default: 1). Mutually exclusive with "start". Internally converted to a start offset after validation.

hlstring nullable

Language

lrstring nullable

Restrict results to language (e.g., lang_en)

glstring nullable

Geolocation

crstring nullable

Restrict to country (e.g., countryUS)

safe'active' | 'off' | 'null' nullable

Safety

dateRestrictstring nullable

Date filtering

sort'date' | 'date:r' | 'date:d' | 'null' nullable

Sort order (e.g., date)

filterinteger nullable

Duplicate-content filter: 1 to omit near-duplicate results (default), 0 to keep them.

rights'cc_publicdomain' | 'cc_attribute' | 'cc_sharealike' | 'cc_noncommercial' | 'cc_nonderived' | 'null' nullable

Filter by usage rights (cc_publicdomain, cc_attribute, cc_sharealike, cc_noncommercial, cc_nonderived)

Response

people_also_search_forstring[] required
total_resultsinteger required

Changes

No recorded changes to this operation across all 3 revisions of this API.