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

{
    "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"
        }
    ]
}