nvoke Tools API
The Tools API from nvoke — 3 operation(s) for tools.
The Tools API from nvoke — 3 operation(s) for tools.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/nvoke-run:nvoke-run-tools-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: nvoke Tools API
version: 0.1.0
description: 'Find companies, read their websites and get email addresses checked with the mail server. Everything the desktop app does. Send `Authorization: Bearer `.'
servers:
- url: https://api.nvoke.run
tags:
- name: Tools
paths:
/v1/tools/verify-email:
post:
operationId: toolVerifyEmail
summary: Check one email address, free
description: 'The free email verifier on nvoke.run/tools. Syntax, disposable domains, MX records and, while the small free probe budget lasts, the mail server itself (`depth: mailbox`). Past that budget it answers from syntax and DNS (`depth: domain`). Rate limited per IP and per day. For volume, use a search of kind `domains` with an API key.'
tags:
- Tools
security: []
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
email:
type: string
minLength: 3
maxLength: 320
turnstileToken:
description: Cloudflare Turnstile token, when the server asks for one.
type: string
maxLength: 2048
required:
- email
example:
email: hello@example.com
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
email:
type: string
verification:
type: string
enum:
- valid
- invalid
- risky
- catch_all
- unknown
reason:
type: string
mxHost:
type:
- string
- 'null'
depth:
type: string
enum:
- mailbox
- domain
required:
- email
- verification
- reason
- mxHost
- depth
additionalProperties: false
4XX:
description: '`invalid_request`: The body or query failed validation. `details` lists the problems.
`rate_limited`: Too many requests of this kind from this account or client. Try again later.
`captcha_failed`: The Turnstile token was missing or did not pass. Solve the challenge again.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/tools/extract-emails:
post:
operationId: toolExtractEmails
summary: Read one website for emails, free
description: The free website email extractor on nvoke.run/tools. Reads the homepage and likely contact pages of one domain (robots.txt honored, opt-outs respected) and returns its generic role addresses. Addresses of people are counted in `hiddenPersonal` and shown only in a search. Rate limited per IP and per day.
tags:
- Tools
security: []
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
domain:
type: string
minLength: 3
maxLength: 253
turnstileToken:
description: Cloudflare Turnstile token, when the server asks for one.
type: string
maxLength: 2048
required:
- domain
example:
domain: example.com
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
domain:
type: string
status:
type: string
enum:
- done
- blocked
- refused
- js_only
- failed
- opted_out
emails:
type: array
items:
type: object
properties:
address:
type: string
sourceUrl:
type:
- string
- 'null'
required:
- address
- sourceUrl
additionalProperties: false
hiddenPersonal:
type: integer
minimum: 0
maximum: 9007199254740991
cached:
type: boolean
required:
- domain
- status
- emails
- hiddenPersonal
- cached
additionalProperties: false
4XX:
description: '`invalid_request`: The body or query failed validation. `details` lists the problems.
`rate_limited`: Too many requests of this kind from this account or client. Try again later.
`captcha_failed`: The Turnstile token was missing or did not pass. Solve the challenge again.
`busy`: Too many free tool checks are running or today’s free allowance is used up. Try again later, or sign up.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/tools/email-auth:
post:
operationId: toolEmailAuth
summary: Check SPF, DMARC, DKIM and MX, free
description: 'The free SPF and DMARC checker on nvoke.run/tools. DNS only: MX hosts, the SPF record with its lookup count, the DMARC policy and DKIM keys under common selectors, each graded pass, warn or fail. Rate limited per IP.'
tags:
- Tools
security: []
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
domain:
type: string
minLength: 3
maxLength: 253
required:
- domain
example:
domain: example.com
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
domain:
type: string
mx:
type: object
properties:
grade:
type: string
enum:
- pass
- warn
- fail
hosts:
type: array
items:
type: string
notes:
type: array
items:
type: string
required:
- grade
- hosts
- notes
additionalProperties: false
spf:
type: object
properties:
grade:
type: string
enum:
- pass
- warn
- fail
record:
type:
- string
- 'null'
all:
type:
- string
- 'null'
lookups:
type: integer
minimum: 0
maximum: 9007199254740991
notes:
type: array
items:
type: string
required:
- grade
- record
- all
- lookups
- notes
additionalProperties: false
dmarc:
type: object
properties:
grade:
type: string
enum:
- pass
- warn
- fail
record:
type:
- string
- 'null'
policy:
anyOf:
- type: string
enum:
- none
- quarantine
- reject
- type: 'null'
notes:
type: array
items:
type: string
required:
- grade
- record
- policy
- notes
additionalProperties: false
dkim:
type: object
properties:
grade:
type: string
enum:
- pass
- warn
- fail
selectors:
type: array
items:
type: string
notes:
type: array
items:
type: string
required:
- grade
- selectors
- notes
additionalProperties: false
required:
- domain
- mx
- spf
- dmarc
- dkim
additionalProperties: false
4XX:
description: '`invalid_request`: The body or query failed validation. `details` lists the problems.
`rate_limited`: Too many requests of this kind from this account or client. Try again later.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
Error:
type: object
required:
- error
properties:
error:
type: string
enum:
- unauthorized
- claim_required
- invalid_request
- not_found
- quota_exceeded
- source_unavailable
- not_cancelable
- search_running
- kind_mismatch
- ongoing_not_supported
- search_canceled
- not_claimed
- api_key_limit
- account_exists
- email_not_accepted
- rate_limited
- captcha_failed
- busy
- site_unreadable
- ai_unavailable
- ai_key_rejected
- ai_model_unknown
- search_key_rejected
- signup_unavailable
- too_many_drops
- too_many_webhooks
- webhook_url_not_allowed
- database_unavailable
details: {}
securitySchemes:
bearer:
type: http
scheme: bearer
description: An API key (nvk_sk_...) or an OAuth access token from nvoke’s Clerk.