Skip to main content
Make a search request through Locus and charge it to your workspace pool. You’ll need an enterprise workspace and owner or admin access to create the key. If you are connecting an agent, use the agent connection guide for OAuth or a scoped service credential.
1

Open your workspace

Accept your evaluation or team invitation, sign in to the dashboard, and select the enterprise workspace.
2

Create a server key

Open API Keys and create a secret key with credits:move for metered calls. Complete MFA or passkey verification when prompted. Save the returned value in your server’s secret manager; it is shown once.
Keep this key on your server. Use OAuth for interactive agents and scoped Agent Connections for unattended agents.
3

Check your balance

Open Funding & billing → Funding and add credits if needed. An evaluation workspace may already have a promotional balance.
4

Enable a tool

Open Agent tools, find tavily/search, review its price, and enable it.
5

Make the call

6

Check the result and charge

The body contains the search result. Response headers show the charged credits and remaining balance. Open Activity to find the call and its cost.
Reuse the same idempotency key when retrying this request. Choose a new key for a new search.
If the call fails, the response explains whether you need to enable the tool, add credits, or update access.

​
Add customer billing

When you want customers to pay for their own usage, create end-user balances and set your markup. The billing widget adds balances and top-ups to your app using browser-safe credentials issued by your server.

Funding and billing

Configure customer balances, auto-recharge, and spending caps.

Recipes

Get complete research and enrichment outcomes through one call.

SDK

Make calls from Node or TypeScript.