---
title: "Search engine results (SERP) by query"
method: GET
path: "/serp"
tags: ["SERP"]
---

# Search engine results (SERP) by query

`GET /serp`

Returns parsed search engine results for a query. The engine is selected with the `engine` parameter (currently `google`, the default). Unlike the page endpoints this is query-shaped, not URL-shaped: pass `q` (the search query) instead of `url`, and WebScraping.AI handles proxy routing and parsing. Organic results follow the common SERP naming (`organic_results` with `position`, `title`, `link`, `displayed_link`). Flat pricing of 15 credits per search; failed searches are not charged. Response is JSON.

## Query parameters

- `q` string, required
- `engine` 'google'
- `gl` string
- `hl` string
- `page` integer

## Response `200`

Success

- SerpResult
  - `search_parameters` object — The normalized parameters the search was run with.
    - `engine` string
    - `q` string
    - `gl` string
    - `hl` string
    - `page` integer
  - `organic_results` object[] — Organic (non-ad) search results, in rank order.
    - `position` integer — Absolute rank of the result across pages.
    - `title` string
    - `link` string
    - `displayed_link` string — The result's hostname.
    - `snippet` string — Result description snippet, when available.
  - `pagination` object
    - `current` integer
    - `next` integer

## Other responses

- `400` — Parameters validation error
- `402` — Out of API credits — upgrade your plan or top up your pay-as-you-go balance on https://webscraping.ai/dashboard/billing
- `403` — Wrong API key
- `429` — Too many concurrent requests
- `500` — Non-2xx and non-404 HTTP status code on the target page or unexpected error, try again or contact support@webscraping.ai
- `504` — Timeout error, try increasing timeout parameter value

---

[API](https://skmtc.dev/webscraping/apis/webscraping-ai.md) · [All operations](https://skmtc.dev/webscraping/apis/webscraping-ai/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webscraping/webscraping-ai/revisions/72139e6bf207/schema)