# Response schema

All responses are JSON. The fields returned depend on what you request via
`include`.

## Top-level fields

| Field            | Always present   | Description                                                                                                          |
|------------------|------------------|----------------------------------------------------------------------------------------------------------------------|
| `status`         | Yes              | `"success"` on a successful response.                                                                                |
| `url`            | Yes              | The search URL that was fetched.                                                                                     |
| `fetchedAt`      | Yes              | ISO-8601 timestamp of when the page was fetched.                                                                     |
| `meta`           | Yes              | Request metadata. Includes `requestedAt`, and geo fields if `queryParameters` were passed (`geolocation`, `locale`). |
| `html`           | When requested   | Raw rendered HTML of the SERP page. Returned when `"html"` is in `include`.                                          |
| `organicResults` | When requested   | Array of parsed organic results. Returned when `"organic"` is in `include`.                                          |

## organicResults

Each item in the `organicResults` array has the following fields:

| Field          | Type    | Always present   | Description                                           |
|----------------|---------|------------------|-------------------------------------------------------|
| `rank`         | integer | Yes              | Position in results, starting at 1.                   |
| `title`        | string  | Yes              | Result title as shown on the SERP.                    |
| `url`          | string  | Yes              | Link to the result page.                              |
| `snippet`      | string  | No               | Description text shown on the SERP.                   |
| `displayedUrl` | string  | No               | URL as displayed on the SERP (may differ from `url`). |

## Example response

```json
{
    "status": "success",
    "url": "https://www.example-engine.com/search?q=web+scraping+tools",
    "fetchedAt": "2026-05-11T09:36:57Z",
    "meta": {
        "requestedAt": "2026-05-11T09:36:39Z",
        "geolocation": "US",
        "locale": "en-US"
    },
    "organicResults": [
        {
            "rank": 1,
            "title": "Zyte - Web Scraping API",
            "url": "https://www.zyte.com/",
            "snippet": "The leading web scraping platform...",
            "displayedUrl": "zyte.com"
        },
        {
            "rank": 2,
            "title": "ScraperAPI",
            "url": "https://www.scraperapi.com/",
            "snippet": "Scale data collection with a simple API.",
            "displayedUrl": "scraperapi.com"
        }
    ]
}
```