The FindUsefulAgents B2B API lets businesses run AI agents programmatically. Use it to power internal workflows, embed agents into your product, or build automated pipelines that process data at scale.

1. 1

   Register your organisation

   Submit your company name, URL slug, and email at /b2b/register. We review applications within 24 hours.

2. 2

   Receive your credentials

   On approval you'll receive 100 free credits and a temporary password by email. Log in at /b2b/login.

   Change your password immediately after first login.

3. 3

   Generate your API key

   In the portal under Settings → API Keys, click Generate Key. Copy and store it securely — it won't be shown again.

   Keep the secret key server-side only. Never expose it in frontend code.

4. 4

   Make your first API call

   Pass the key in the Authorization header. See the Run Agent section below for the full request format.

All B2B API requests require a Bearer token in the Authorization header.

Authorization: Bearer b2b_YOUR_SECRET_KEY

Key Rotation

To rotate your key without downtime: generate a new key in the portal (Settings → API Keys → Rotate). The old key remains valid for 1 hour after rotation, giving you time to deploy the new key to your infrastructure.

Use POST /api/b2b/run to execute any agent with your inputs. The request is synchronous — the response contains the full output.

Request

POST /api/b2b/run
Authorization: Bearer b2b_YOUR_SECRET_KEY
Content-Type: application/json

{
  "agent_id": "competitor-research-v1",
  "input": {
    "company_name": "Acme Corp",
    "focus": "pricing and recent funding"
  }
}

Response

{
  "session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "output": {
    "summary": "Acme Corp raised Series B ($18M) in Q3 2024...",
    "pricing_tier": "Enterprise: $500-2000/mo",
    "recent_news": ["Launched new API product", "Expanded EU offices"]
  },
  "credits_used": 2,
  "credits_remaining": 98
}

Error codes

For multi-turn interactions, use chat sessions. A session maintains conversation history so the agent can refer back to previous messages — ideal for embedded support agents or guided workflows.

1. Create a session

POST /api/b2b/sessions
Authorization: Bearer b2b_YOUR_SECRET_KEY

{
  "agent_id": "customer-support-v1",
  "metadata": { "user_id": "usr_123", "plan": "pro" }
}

2. Send a message

POST /api/b2b/sessions/{session_id}/message
Authorization: Bearer b2b_YOUR_SECRET_KEY

{
  "message": "I need to cancel my subscription"
}

Response

{
  "session_id": "sess_abc123",
  "reply": "I can help with that. Your subscription is currently active...",
  "credits_used": 1,
  "turn": 2
}

B2B billing is credit-based. Your organisation maintains a shared credit pool used across all API calls and chat sessions.

One-Time Credit Packs

Monthly Subscriptions (Auto-reload)

Credit deduction policy

The B2B portal at /b2b/login gives you a dashboard to manage your organisation's API usage.