---
title: "Results"
method: GET
path: "/search"
---

# Results

`GET /search`

Retrieve search results or queue a search for later retrieval.

## Query parameters

- `id` string, uuid
- `terms` string
- `engine` 'google' | 'bing (coming soon)'
- `serps` integer
- `size` integer
- `offset` integer
- `device` string
- `country` string
- `subdivision` string
- `city` string
- `uule` string
- `language` string
- `display` string
- `url` string, uri
- `awaiting` 'ai' | 'answers' | 'ads'
- `expiration` integer
- `mode` 'sync' | 'async'
- `callback` string

## Response `200`

The search results.

## Other responses

- `202` — A job identifier or the search status.
- `401` — The authorization header was missing.
- `402` — No more credits are available.
- `403` — The content was captcha’d.
- `422` — One or more parameters were invalid.
- `500` — An unknown error occurred.
- `503` — The service is unavailable.
- `504` — The operation timed out.

## Changes

> 9 revisions in range; 1 could not be searched.

- **2026-07-06** `bfddf5b2c698` — 3 breaking, 3 warning, 4 info
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `202`
  - the response's body type/format changed from `object`/`` to ``/`` for status `202`
  - removed the required property `id` from the response with the `202` status
  - for the `query` request parameter `callback`, the maxLength was set to `2047`
  - …6 more
- **2026-06-29** `bbfea328162f` — 2 info
  - added the new optional `query` request parameter `callback`
  - added the new optional `query` request parameter `url`
- **2026-05-11** `b27e3b3c12b6` — 1 info
  - added the new enum value `ads` to the `query` request parameter `awaiting`

[Change history](https://skmtc.dev/joinmassive/apis/massive/changes/search/get.md)

---

[API](https://skmtc.dev/joinmassive/apis/massive.md) · [All operations](https://skmtc.dev/joinmassive/apis/massive/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinmassive/massive/revisions/3a9f7769563f/schema)