nvoke Drops API
The Drops API from nvoke — 3 operation(s) for drops.
The Drops API from nvoke — 3 operation(s) for drops.
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-drops-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 Drops 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: Drops
paths:
/v1/drops:
get:
operationId: listDrops
summary: List daily drops
description: Your daily drops, and how each launch source is doing (`sources`). A drop looks at new launches on Show HN, Launch HN, Product Hunt and YC once a day and delivers each run as a search of kind `drop`; list those with `GET /v1/searches`.
tags:
- Drops
security:
- bearer: []
parameters: []
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
drops:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
name:
type: string
keyword:
type:
- string
- 'null'
sources:
type: array
items:
type: string
enum:
- show_hn
- launch_hn
- product_hunt
- yc
dailyLimit:
type: integer
exclusiveMinimum: 0
maximum: 9007199254740991
enabled:
type: boolean
nextRunAt:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
lastDeliveredAt:
anyOf:
- type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
- type: 'null'
companiesDelivered:
type: integer
minimum: 0
maximum: 9007199254740991
createdAt:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
required:
- id
- name
- keyword
- sources
- dailyLimit
- enabled
- nextRunAt
- lastDeliveredAt
- companiesDelivered
- createdAt
additionalProperties: false
sources:
type: array
items:
type: object
properties:
source:
type: string
enum:
- show_hn
- launch_hn
- product_hunt
- yc
available:
type: boolean
lastWeek:
type: integer
minimum: 0
maximum: 9007199254740991
lastCollectedAt:
anyOf:
- type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
- type: 'null'
required:
- source
- available
- lastWeek
- lastCollectedAt
additionalProperties: false
required:
- drops
- sources
additionalProperties: false
4XX:
description: '`unauthorized`: No valid token. Send `Authorization: Bearer <key>`.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
operationId: createDrop
summary: Create a drop
description: Every word of `keyword` must appear in a launch’s name, tagline, description or tags; left out, every launch matches. `sources` defaults to all of them. `dailyLimit` caps the companies one run delivers (default 25), held to what your plan allows. The first run looks back 7 days. At most 20 drops.
tags:
- Drops
security:
- bearer: []
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 80
keyword:
type: string
minLength: 1
maxLength: 100
sources:
minItems: 1
type: array
items:
type: string
enum:
- show_hn
- launch_hn
- product_hunt
- yc
dailyLimit:
type: integer
minimum: 1
maximum: 5000
required:
- name
example:
name: Dev tools
keyword: developer
sources:
- show_hn
- product_hunt
dailyLimit: 25
responses:
'201':
description: OK
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
name:
type: string
keyword:
type:
- string
- 'null'
sources:
type: array
items:
type: string
enum:
- show_hn
- launch_hn
- product_hunt
- yc
dailyLimit:
type: integer
exclusiveMinimum: 0
maximum: 9007199254740991
enabled:
type: boolean
nextRunAt:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
lastDeliveredAt:
anyOf:
- type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
- type: 'null'
companiesDelivered:
type: integer
minimum: 0
maximum: 9007199254740991
createdAt:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
required:
- id
- name
- keyword
- sources
- dailyLimit
- enabled
- nextRunAt
- lastDeliveredAt
- companiesDelivered
- createdAt
additionalProperties: false
4XX:
description: '`unauthorized`: No valid token. Send `Authorization: Bearer <key>`.
`invalid_request`: The body or query failed validation. `details` lists the problems.
`too_many_drops`: The account holds 20 drops. Delete one first.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/drops/{id}:
get:
operationId: getDrop
summary: Get a drop
description: One drop with its next run and what it delivered so far.
tags:
- Drops
security:
- bearer: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
name:
type: string
keyword:
type:
- string
- 'null'
sources:
type: array
items:
type: string
enum:
- show_hn
- launch_hn
- product_hunt
- yc
dailyLimit:
type: integer
exclusiveMinimum: 0
maximum: 9007199254740991
enabled:
type: boolean
nextRunAt:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
lastDeliveredAt:
anyOf:
- type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
- type: 'null'
companiesDelivered:
type: integer
minimum: 0
maximum: 9007199254740991
createdAt:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
required:
- id
- name
- keyword
- sources
- dailyLimit
- enabled
- nextRunAt
- lastDeliveredAt
- companiesDelivered
- createdAt
additionalProperties: false
4XX:
description: '`unauthorized`: No valid token. Send `Authorization: Bearer <key>`.
`not_found`: No such search, company, email, drop, key or webhook on this account.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
patch:
operationId: updateDrop
summary: Change a drop
description: 'Change the name, keyword, sources or daily limit, or pause and resume it with `enabled`. `keyword: null` removes the keyword.'
tags:
- Drops
security:
- bearer: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 80
keyword:
anyOf:
- type: string
minLength: 1
maxLength: 100
- type: 'null'
sources:
minItems: 1
type: array
items:
type: string
enum:
- show_hn
- launch_hn
- product_hunt
- yc
dailyLimit:
type: integer
minimum: 1
maximum: 5000
enabled:
type: boolean
example:
enabled: false
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
name:
type: string
keyword:
type:
- string
- 'null'
sources:
type: array
items:
type: string
enum:
- show_hn
- launch_hn
- product_hunt
- yc
dailyLimit:
type: integer
exclusiveMinimum: 0
maximum: 9007199254740991
enabled:
type: boolean
nextRunAt:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
lastDeliveredAt:
anyOf:
- type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
- type: 'null'
companiesDelivered:
type: integer
minimum: 0
maximum: 9007199254740991
createdAt:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
required:
- id
- name
- keyword
- sources
- dailyLimit
- enabled
- nextRunAt
- lastDeliveredAt
- companiesDelivered
- createdAt
additionalProperties: false
4XX:
description: '`unauthorized`: No valid token. Send `Authorization: Bearer <key>`.
`not_found`: No such search, company, email, drop, key or webhook on this account.
`invalid_request`: The body or query failed validation. `details` lists the problems.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
delete:
operationId: deleteDrop
summary: Delete a drop
description: Stops the drop. The searches its runs made stay until you delete them.
tags:
- Drops
security:
- bearer: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
responses:
'204':
description: No content
4XX:
description: '`unauthorized`: No valid token. Send `Authorization: Bearer <key>`.
`not_found`: No such search, company, email, drop, key or webhook on this account.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/drops/{id}/run:
post:
operationId: runDrop
summary: Run a drop now
description: Moves the next run to now. The worker picks it up within a minute; a run that finds nothing new creates no search.
tags:
- Drops
security:
- bearer: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
name:
type: string
keyword:
type:
- string
- 'null'
sources:
type: array
items:
type: string
enum:
- show_hn
- launch_hn
- product_hunt
- yc
dailyLimit:
type: integer
exclusiveMinimum: 0
maximum: 9007199254740991
enabled:
type: boolean
nextRunAt:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
lastDeliveredAt:
anyOf:
- type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
- type: 'null'
companiesDelivered:
type: integer
minimum: 0
maximum: 9007199254740991
createdAt:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
required:
- id
- name
- keyword
- sources
- dailyLimit
- enabled
- nextRunAt
- lastDeliveredAt
- companiesDelivered
- createdAt
additionalProperties: false
4XX:
description: '`unauthorized`: No valid token. Send `Authorization: Bearer <key>`.
`not_found`: No such search, company, email, drop, key or webhook on this account.'
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.