---
title: "Claim sites to read from your own computer"
method: POST
path: "/v1/local-crawl/claim"
tags: ["Leads"]
---

# Claim sites to read from your own computer

`POST /v1/local-crawl/claim`

## Request

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

For the desktop app’s local render crawl. Hands out up to `max` companies from your searches of the last 30 days whose crawl ended without an address because the site refused our servers (`refused`), needs JavaScript (`js_only`) or showed no address (`done`), each held for 10 minutes. `reasons` picks which (default `refused` and `js_only`); refused and JS-only sites come first. Read them under the same rules as nvokebot (robots.txt, one page a second, 8 pages, no logins, no CAPTCHAs) and send what you found to `POST /v1/local-crawl/results`. Empty while this month’s allowance is used up.

## Request body

- object
  - `max` integer
  - `reasons` string[]

## Response `200`

OK

- object
  - `tasks` object[], required
    - `companyId` string, uuid, required
    - `searchId` string, uuid, required
    - `domain` string, required
    - `website` string, required
    - `reason` 'refused' | 'js_only' | 'done', required

## Other responses

- `4XX`: `unauthorized`: No valid token. Send `Authorization: Bearer <key>`. `invalid_request`: The body or query failed validation. `details` lists the problems.

---

[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)