---
title: "Run the query-mode iterator and return the next page of results (beta)"
method: POST
path: "/search/query-mode/{search_id}/run"
tags: ["search"]
---

# Run the query-mode iterator and return the next page of results (beta)

`POST /search/query-mode/{search_id}/run`

Returns the next page of records for an existing query-mode search.

## Path parameters

- `search_id` string, required

## Request body

- NextSearchResultsBody
  - `limit` integer

## Response `200`

200

- union
  - NextQueryModePeopleResultsResponse
    - `data` PublicApiPersonSearchResult[], required
      - `clay_profile_id` number, required
      - `first_name` string, nullable, required
      - `last_name` string, nullable, required
      - `location` object, required
        - `city` string, nullable, required
        - `name` string, nullable, required
        - `state_or_province` string, nullable, required
      - `matched_experiences` PublicApiMatchedExperience[], required
        - `company` string, nullable, required
        - `end_date` string, nullable, required
        - `location` string, nullable, required
        - `start_date` string, nullable, required
        - `title` string, nullable, required
      - `name` string, nullable, required
    - `exhaustion_reason` 'query_limit' | 'no_more_results'
    - `has_more` boolean, required
    - `period_quota` object
      - `limit` number, required
      - `remaining` number, required
      - `resets_at` string, required
      - `used` number, required
    - `source_type` 'people', required
  - NextQueryModeCompanyResultsResponse
    - `data` PublicApiCompanySearchResult[], required
      - `annual_revenue` string, nullable, required
      - `clay_company_id` number, required
      - `country` string, nullable, required
      - `description` string, nullable, required
      - `domain` string, nullable, required
      - `industry` string, nullable, required
      - `linkedin_url` string, nullable, required
      - `location` string, nullable, required
      - `name` string, nullable, required
      - `size` string, nullable, required
      - `total_funding_amount_range_usd` number, nullable, required
      - `type` string, nullable, required
    - `exhaustion_reason` 'query_limit' | 'no_more_results'
    - `has_more` boolean, required
    - `period_quota` object
      - `limit` number, required
      - `remaining` number, required
      - `resets_at` string, required
      - `used` number, required
    - `source_type` 'companies', required

## Other responses

- `400` — 400
- `401` — 401
- `402` — 402
- `403` — 403
- `404` — 404
- `429` — 429

---

[API](https://skmtc.net/clay/apis/clay-public-api.md) · [All operations](https://skmtc.net/clay/apis/clay-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clay/clay-public-api/revisions/c1f3cd4d89da/schema)