---
title: "Search again into the same list"
method: POST
path: "/v1/searches/{id}/more"
tags: ["Searches"]
---

# Search again into the same list

`POST /v1/searches/{id}/more`

## Request

- Base URL: `https://api.nvoke.run`
- URL: `https://api.nvoke.run/v1/searches/{id}/more`
- Auth: HTTP bearer

Runs a finished search again with new params of the same kind, for example a wider area or another keyword, and adds what it finds to the same list. Companies the search already holds are skipped, so `limit` caps the new companies only. The search goes back to `queued` and its counters keep counting from where they were; `runs` lists every run. Answers 409 `search_running` while it still runs.

## Path parameters

- `id` string, uuid, required

## Request body

- union
  - object
    - `kind` 'local', required
    - `params` object, required
      - `niche` string, required
      - `location` string, required
    - `limit` integer
    - `checkInboxes` boolean
  - object
    - `kind` 'web', required
    - `params` object, required
      - `keyword` string, required
      - `country` string
    - `limit` integer
    - `checkInboxes` boolean
  - object
    - `kind` 'launches', required
    - `params` object, required
      - `keyword` string
      - `days` integer
      - `sources` string[]
    - `limit` integer
    - `checkInboxes` boolean
  - object
    - `kind` 'domains', required
    - `params` object, required
      - `items` string[], required
      - `country` string
    - `limit` integer
    - `checkInboxes` boolean
  - object
    - `kind` 'icp', required
    - `params` object, required
      - `description` string, required
      - `product` string
      - `countries` string[]
      - `locations` string[]
    - `limit` integer
    - `checkInboxes` boolean

## Response `200`

OK

- union
  - object
    - `id` string, uuid, required
    - `limit` integer, required
    - `status` 'queued' | 'running' | 'done' | 'failed' | 'canceled', required
    - `error` string, nullable, required
    - `companiesFound` integer, required
    - `companiesCrawled` integer, required
    - `emailsFound` integer, required
    - `emailsValid` integer, required
    - `createdAt` string, date-time, required
    - `startedAt` string, date-time, nullable, required
    - `finishedAt` string, date-time, nullable, required
    - `stage` string, nullable
    - `stageNote` string, nullable
    - `ongoing` boolean, nullable
    - `checkInboxes` boolean, nullable
    - `inboxesSkipped` integer, nullable
    - `inboxesPending` integer, nullable
    - `kind` 'local', required
    - `params` object, required
      - `niche` string, required
      - `location` string, required
    - `runs` object[]
      - `params` object, required
        - `niche` string, required
        - `location` string, required
      - `limit` integer, required
      - `foundBefore` integer, required
      - `createdAt` string, date-time, required
      - `trigger` 'escalate' | 'ongoing'
  - object
    - `id` string, uuid, required
    - `limit` integer, required
    - `status` 'queued' | 'running' | 'done' | 'failed' | 'canceled', required
    - `error` string, nullable, required
    - `companiesFound` integer, required
    - `companiesCrawled` integer, required
    - `emailsFound` integer, required
    - `emailsValid` integer, required
    - `createdAt` string, date-time, required
    - `startedAt` string, date-time, nullable, required
    - `finishedAt` string, date-time, nullable, required
    - `stage` string, nullable
    - `stageNote` string, nullable
    - `ongoing` boolean, nullable
    - `checkInboxes` boolean, nullable
    - `inboxesSkipped` integer, nullable
    - `inboxesPending` integer, nullable
    - `kind` 'web', required
    - `params` object, required
      - `keyword` string, required
      - `country` unknown
    - `runs` object[]
      - `params` object, required
        - `keyword` string, required
        - `country` unknown
      - `limit` integer, required
      - `foundBefore` integer, required
      - `createdAt` string, date-time, required
      - `trigger` 'escalate' | 'ongoing'
  - object
    - `id` string, uuid, required
    - `limit` integer, required
    - `status` 'queued' | 'running' | 'done' | 'failed' | 'canceled', required
    - `error` string, nullable, required
    - `companiesFound` integer, required
    - `companiesCrawled` integer, required
    - `emailsFound` integer, required
    - `emailsValid` integer, required
    - `createdAt` string, date-time, required
    - `startedAt` string, date-time, nullable, required
    - `finishedAt` string, date-time, nullable, required
    - `stage` string, nullable
    - `stageNote` string, nullable
    - `ongoing` boolean, nullable
    - `checkInboxes` boolean, nullable
    - `inboxesSkipped` integer, nullable
    - `inboxesPending` integer, nullable
    - `kind` 'launches', required
    - `params` object, required
      - `keyword` string
      - `days` integer, required
      - `sources` string[]
    - `runs` object[]
      - `params` object, required
        - `keyword` string
        - `days` integer, required
        - `sources` string[]
      - `limit` integer, required
      - `foundBefore` integer, required
      - `createdAt` string, date-time, required
      - `trigger` 'escalate' | 'ongoing'
  - object
    - `id` string, uuid, required
    - `limit` integer, required
    - `status` 'queued' | 'running' | 'done' | 'failed' | 'canceled', required
    - `error` string, nullable, required
    - `companiesFound` integer, required
    - `companiesCrawled` integer, required
    - `emailsFound` integer, required
    - `emailsValid` integer, required
    - `createdAt` string, date-time, required
    - `startedAt` string, date-time, nullable, required
    - `finishedAt` string, date-time, nullable, required
    - `stage` string, nullable
    - `stageNote` string, nullable
    - `ongoing` boolean, nullable
    - `checkInboxes` boolean, nullable
    - `inboxesSkipped` integer, nullable
    - `inboxesPending` integer, nullable
    - `kind` 'domains', required
    - `params` object, required
      - `items` unknown, required
      - `country` unknown
    - `runs` object[]
      - `params` object, required
        - `items` unknown, required
        - `country` unknown
      - `limit` integer, required
      - `foundBefore` integer, required
      - `createdAt` string, date-time, required
      - `trigger` 'escalate' | 'ongoing'
  - object
    - `id` string, uuid, required
    - `limit` integer, required
    - `status` 'queued' | 'running' | 'done' | 'failed' | 'canceled', required
    - `error` string, nullable, required
    - `companiesFound` integer, required
    - `companiesCrawled` integer, required
    - `emailsFound` integer, required
    - `emailsValid` integer, required
    - `createdAt` string, date-time, required
    - `startedAt` string, date-time, nullable, required
    - `finishedAt` string, date-time, nullable, required
    - `stage` string, nullable
    - `stageNote` string, nullable
    - `ongoing` boolean, nullable
    - `checkInboxes` boolean, nullable
    - `inboxesSkipped` integer, nullable
    - `inboxesPending` integer, nullable
    - `kind` 'drop', required
    - `params` object, required
      - `dropId` string, uuid, required
      - `dropName` string, required
      - `keyword` string
      - `sources` string[], required
  - object
    - `id` string, uuid, required
    - `limit` integer, required
    - `status` 'queued' | 'running' | 'done' | 'failed' | 'canceled', required
    - `error` string, nullable, required
    - `companiesFound` integer, required
    - `companiesCrawled` integer, required
    - `emailsFound` integer, required
    - `emailsValid` integer, required
    - `createdAt` string, date-time, required
    - `startedAt` string, date-time, nullable, required
    - `finishedAt` string, date-time, nullable, required
    - `stage` string, nullable
    - `stageNote` string, nullable
    - `ongoing` boolean, nullable
    - `checkInboxes` boolean, nullable
    - `inboxesSkipped` integer, nullable
    - `inboxesPending` integer, nullable
    - `kind` 'icp', required
    - `params` object, required
      - `description` string, required
      - `product` string
      - `countries` unknown[]
        - unknown
      - `locations` string[]
    - `runs` object[]
      - `params` object, required
        - `description` string, required
        - `product` string
        - `countries` unknown[]
          - unknown
        - `locations` string[]
      - `limit` integer, required
      - `foundBefore` integer, required
      - `createdAt` string, date-time, required
      - `trigger` 'escalate' | 'ongoing'

## Other responses

- `4XX`: `unauthorized`: No valid token. Send `Authorization: Bearer <key>`. `invalid_request`: The body or query failed validation. `details` lists the problems. `not_found`: No such search, key or webhook on this account. `search_running`: The search is still running. Wait for it to finish, or cancel it, then search again. `kind_mismatch`: A search runs again with its own kind. Start a new search for another kind. `quota_exceeded`: This month’s verified emails are used up. A human upgrades at `billingUrl`, sent with this error and by `GET /v1/me`. `source_unavailable`: Web search is paused on our side. Local and launch searches still work.

---

[API](https://skmtc.dev/nvoke/apis/nvoke-api.md) · [All operations](https://skmtc.dev/nvoke/apis/nvoke-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nvoke/apis/nvoke-api/revisions/6d78de7201f3?raw)