---
title: "Send what a local crawl found"
method: POST
path: "/v1/local-crawl/results"
tags: ["Leads"]
---

# Send what a local crawl found

`POST /v1/local-crawl/results`

## Request

- Base URL: `https://api.nvoke.run`
- URL: `https://api.nvoke.run/v1/local-crawl/results`
- Auth: HTTP bearer

The addresses found on a claimed company’s site and the page each was on. We check every address again (shape, placeholders, the company’s own domain, opt-outs), store the rest in that search and verify them like any other; you pay only for valid ones. Nothing sent here enters the shared cache.

## Request body

- object
  - `companyId` string, uuid, required
  - `outcome` 'done' | 'failed' | 'blocked', required
  - `emails` object[]
    - `address` string, required
    - `sourceUrl` string, nullable, required
  - `pages` integer, required

## Response `200`

OK

- object
  - `stored` integer, required

## 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. `not_claimed`: The company is not claimed for a local crawl right now. Claim it again with `POST /v1/local-crawl/claim`.

---

[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/f7cfd26111a8?raw)
