credits.get, research.get/list and tasks.get/list is billed per call: searches $0.005 to $0.055 by depth, page fetches $0.001 to $0.011, research $0.25 to $2.50 by reasoningDepth (the plugin defaults to S, $0.25; Linkup’s own default is L).
search.run, answers.get, search.structured and pages.fetch are metered lookups (read). responses.create, research.create and tasks.create are paid generation jobs and are destructive.
depth: flash, fast (default here) and standard cost the same; deep runs several searches and costs 10x. fromDate/toDate take YYYY-MM-DD and the domain filters take bare domains such as example.com.
Research and batch tasks run in the background: create them, then poll research.get or tasks.get until status is completed (or failed); output holds the answer, results or data.
Only the credit balance, source URLs with name, type and date, and response ids are stored. Page text, generated text and queries are not stored or put in events.
What you get:
- 12 typed API operations
- 3 synced entities (
credits,responses,sources) for fast.search()/.list()
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the Linkup API key before the first call: More: API Key
pnpm corsair setup --plugin=linkup --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
Search recent news on a domainQuery synced data
Synced entities supporttenant.linkup.db.<entity>.search() and .list(): credits, responses, sources.
See Database for filters and operators.
What’s next
API reference
Every
linkup.api.* operation with input and output types.Database
Synced entities, search filters, and operators.
Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.