Botdog API

Name: Botdog API
Brand: Botdog API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMarketingMarketing AutomationapiKey11 EndpointsREST

For Agents

Push leads into Botdog LinkedIn outreach campaigns and pull campaign and per-user analytics across 11 endpoints.

Install Jentic One Beta

Connect the Botdog API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Botdog API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Botdog API.

Add leads in bulk to a running LinkedIn outreach campaign

List active campaigns and pull per-campaign statistics

Retrieve workspace users and team metadata

Pull aggregate outreach analytics across the workspace

GET STARTED

Start building with Botdog API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Botdog API for, with concrete tasks.

★ Push leads from a sales database into LinkedIn campaigns

RevOps teams enrich a target account list in their CRM and push the resulting LinkedIn profile URLs into a Botdog campaign so SDRs send connection requests on autopilot. POST /v1/leads/add_to_campaign accepts a campaign id and a batch of leads, and the campaign's statistics endpoint lets the team confirm the new leads are picked up. Most teams ship the integration in a day.

Add 25 LinkedIn lead URLs from the latest enrichment job into campaign id camp_q3_outbound and report the count accepted

Per-user outreach performance dashboard

Sales leaders need a daily view of connection requests sent, accepted, and replies received by each SDR. GET /v1/analytics/by-user returns the per-rep counts and GET /v1/analytics/daily provides time-series data, both ready for a BI dashboard or weekly recap. Setup typically takes a few hours after auth is in place.

Pull GET /v1/analytics/by-user for the last 7 days and return the top three users by replies received

Campaign monitoring and pause-on-issue automation

Operations teams monitor each campaign's statistics and pause sending when reply or acceptance rates drop, indicating message fatigue or incorrect targeting. GET /v1/campaigns/{id}/statistics gives the per-campaign signals; the team's automation reads them on a schedule and routes alerts to Slack. Read-only monitoring goes live the same day.

Get statistics for campaign id camp_42 and alert if the acceptance rate is below 15 percent

Agent-driven LinkedIn outreach via Jentic

An AI agent ingests qualified leads from a CRM workflow and pushes them into the right Botdog campaign based on persona and territory rules. Through Jentic the agent searches for 'add leads to a Botdog campaign', loads the schema, and executes the call while the bd_live_ API key stays inside the Jentic vault.

Search Jentic for 'add leads to a Botdog campaign', load the schema, and execute it with campaign id camp_eu_q3 and a list of 10 LinkedIn URLs

Key Endpoints

11 endpoints — jentic publishes the only available openapi specification for botdog api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/v1/leads/add_to_campaign

Add leads to a campaign

GET

/v1/campaigns

List campaigns

GET

/v1/campaigns/{id}/statistics

Per-campaign statistics

GET

/v1/analytics

Aggregate workspace analytics

GET

/v1/analytics/daily

Daily analytics time series

GET

/v1/analytics/by-user

Analytics broken down by user

GET

/v1/users

List workspace users

POST

/v1/leads/add_to_campaign

Add leads to a campaign

GET

/v1/campaigns

List campaigns

GET

/v1/campaigns/{id}/statistics

Per-campaign statistics

GET

/v1/analytics

Aggregate workspace analytics

GET

/v1/analytics/daily

Daily analytics time series

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Botdog x-api-key (bd_live_*) is stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped execution access only; the raw key never appears in prompts, logs, or tool outputs.

Intent-based discovery

Agents search Jentic for intents like 'add leads to a LinkedIn campaign' or 'pull Botdog analytics' and Jentic returns the matching operations with their input schemas, so the agent calls the right endpoint without crawling the docs site.

Time to first call

Direct Botdog integration: 1-2 days for auth, lead schema mapping, and analytics polling. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Botdog API through Jentic.

Why is there no official OpenAPI spec for Botdog API?

Botdog does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Botdog API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Botdog API use?

Botdog uses an API key in the x-api-key header, formatted as bd_live_abc123. Issue the key from your Botdog workspace and store it in the Jentic vault so the raw key never enters the agent's context.

Can I add leads to a LinkedIn campaign with the Botdog API?

Yes. POST /v1/leads/add_to_campaign with the target campaign id and a batch of LinkedIn lead profiles. The endpoint is the only write path in the spec and is the supported way to feed an outreach campaign without manually adding leads in the UI.

How do I pull per-user analytics through Jentic?

Run pip install jentic, then search Jentic for 'Botdog analytics by user', load the GET /v1/analytics/by-user schema, and execute it with the date range. Jentic injects the x-api-key automatically; the agent only sees the response.

What are the rate limits for the Botdog API?

Botdog does not document explicit per-second rate limits in the spec, but LinkedIn-side safety limits cap how aggressively a campaign can send. Schedule lead additions in steady batches rather than dumping thousands at once, and rely on the daily analytics endpoint instead of polling statistics minute-by-minute.

Can I monitor campaign performance over time?

Yes. GET /v1/campaigns/{id}/statistics returns the current campaign metrics, and GET /v1/analytics/daily returns workspace-level counts per day. Combine them to alert when a specific campaign deviates from the workspace baseline.