Create once
Pass companies, people, or a saved list. Recommended mode chooses safe, relevant workflows that fit the remaining allowance. Idempotency prevents duplicated background or paid work.
Signal intelligence for software and agents
Submit companies or people once. TipOff chooses safe relevant workflows, respects the workspace credit allowance, and returns one source-linked summary your application or LLM can trust.
import { Tipoff } from "@tipoff/radar";
const tipoff = new Tipoff({
apiKey: process.env.TIPOFF_API_KEY,
});
const job = await tipoff.audiences.track({
companies: accounts,
playbooks: { mode: "recommended" },
});
await tipoff.tracking.waitUntilComplete(job.id);
const summary = await tipoff.tracking.summary(job.id);The integration model
Tracking Jobs sit above TipOff’s list, watch, collector, playbook, run, and signal systems. They give a coding agent one obvious operation and preserve the evidence needed for a production application.
Pass companies, people, or a saved list. Recommended mode chooses safe, relevant workflows that fit the remaining allowance. Idempotency prevents duplicated background or paid work.
Receive planned, queued, running, completed, partial, or failed. The SDK handles backoff, timeouts, abort signals, and terminal states.
Get every selected playbook, including zero-result playbooks, plus source-linked signals and explicit unknown or truncated coverage.
Stable core
OpenAPI 3.1, official JavaScript and Python clients, MCP discovery, structured errors, request IDs, usage units, and raw request escape hatches keep the integration straightforward as TipOff expands.
| Method | Path | Outcome |
|---|---|---|
| POST | /api/v1/tracking-jobs | Track companies, people, or saved audiences with a verified credit cap. |
| GET | /api/v1/tracking-jobs/{id} | Poll one durable asynchronous job. |
| GET | /api/v1/tracking-jobs/{id}/summary | Retrieve every playbook and its source-linked outcomes. |
| POST | /api/find-signals | Find buyers from a product description or company domain. |
| GET | /api/v1/signals/{id}/outcome | Trace evidence, scoring, CRM, people, and delivery. |
| POST | /api/mcp | Discover and call the live agent tool surface. |
Every new public resource returns a stable error code, the exact invalid parameter, a request id, and a documentation link. The SDK preserves these fields and only retries reads or writes protected by an idempotency key.
Free workspaces have a hard 50-credit monthly allowance. HTTP 402 is returned before new provider work is approved when the quoted maximum does not fit.