Cold DM Outreach Intelligence API Docs
Everything you need to forecast replies, booked calls, clients, revenue, campaign risk, and optimization recommendations for cold DM campaigns.
What Is the Cold DM Outreach Intelligence API?
The Cold DM Outreach Intelligence API lets you forecast campaign outcomes and score cold DM outreach strategies before they are sent. It is a planning-first intelligence layer for agencies, SDR teams, creators, and developers building outreach tools.
The API does not send messages, automate DMs, scrape platforms, or bypass platform rules. It is designed exclusively for campaign planning, forecasting, reporting, and decision support. See the API overview for more context on the planned interface.
Developer Preview Status
The ColdDMCalculator API is not publicly live yet. These docs describe the planned developer-preview interface. Request access to be notified when test keys are available.
Examples are provided to show the intended request and response structure. Endpoint behavior, rate limits, and fields may change before public release.
API Keys
When the API enters developer preview, requests will require authentication via a Bearer token. Test keys will be issued to approved early-access users.
Do not expose API keys in client-side code. Store keys securely on your server or in protected environment variables. To request early access, visit the planned API pricing page.
API Endpoint
The planned developer-preview base URL is:
This base URL is shown for planning and documentation purposes. It is not guaranteed to accept public requests until developer-preview access begins.
Planned Endpoints
The developer-preview interface is designed around forecasting, scoring, optimization, and benchmark endpoints.
| Endpoint | Status | Purpose |
|---|---|---|
| POST /v1/dm/forecast | Developer preview | Forecast replies, positive replies, booked calls, clients, revenue, and ROI |
| POST /v1/dm/score | Planned | Score campaign quality, targeting strength, offer clarity, and risk |
| POST /v1/dm/optimize | Planned | Return recommendations to improve reply rate, booking rate, and ROI |
| GET /v1/benchmarks | Planned | Return cold DM benchmark ranges for campaign planning |
See the API examples page for detailed usage and Cold DM benchmarks for planning ranges.
Forecast Cold DM Campaign
POST/v1/dm/forecast
Submit campaign assumptions and receive estimated replies, positive replies, booked calls, clients, revenue, campaign score, risk level, and optimization recommendations.
Request Fields
| Field | Type | Description |
|---|---|---|
| dms_sent | number required | Number of DMs planned for the campaign |
| reply_rate | number required | Expected reply rate as a percentage (e.g. 12 for 12%) |
| positive_reply_rate | number required | Expected percentage of replies that show genuine interest |
| call_booking_rate | number required | Expected percentage of positive replies that become booked calls |
| close_rate | number required | Expected percentage of booked calls that become clients |
| average_client_value | number required | Estimated revenue per closed client (in your currency) |
| campaign_cost | number optional | Estimated total campaign cost for ROI calculations |
| channel | string optional | Outreach channel: "instagram", "linkedin", "x", "tiktok", "facebook" |
| campaign_type | string optional | Campaign category: "agency_outreach", "creator_outreach", "social_selling", "lead_gen" |
Developer Preview Example — Request
Developer Preview Example — cURL
Developer Preview Example — Response
Forecasts are estimates. All forecast outputs are based on user-provided assumptions and benchmark ranges. They are not guarantees of replies, meetings, clients, revenue, or ROI. Use the free Cold DM calculator to test the forecasting logic directly.
Response Fields
| Field | Type | Description |
|---|---|---|
| estimated_replies | number | Estimated total replies |
| estimated_positive_replies | number | Estimated interested replies |
| estimated_booked_calls | number | Estimated booked calls |
| estimated_clients | number | Estimated clients closed |
| estimated_revenue | number | Estimated campaign revenue |
| estimated_roi | number | Estimated return on investment multiple |
| campaign_score | number | Campaign quality score from 0 to 100 |
| risk_level | string | Low, medium, or high campaign risk |
| recommendations | array | Suggested improvements for campaign planning |
Forecast outputs are estimates based on user-provided assumptions. They are not guarantees of replies, meetings, clients, revenue, or ROI.
Score Cold DM Campaign
POST/v1/dm/score Planned
Score your campaign quality based on channel, audience quality, personalization, offer clarity, follow-up strategy, and daily volume.
Request Parameters
| Field | Type | Description |
|---|---|---|
| channel | string required | Platform: "linkedin", "instagram", "twitter", "facebook", "tiktok" |
| audience_quality | string required | "low", "medium", or "high" |
| personalization_level | string required | "none", "low", "medium", or "high" |
| offer_clarity | string required | "low", "medium", or "high" |
| follow_up_count | integer required | Number of planned follow-ups (0-5) |
| daily_dm_volume | integer required | DMs sent per day |
Example Request
Example Response
Error Handling
The API returns standard HTTP status codes and a JSON error body for any problems with your request.
Example Error Response
| Status Code | Meaning |
|---|---|
| 400 | Bad request - invalid input parameters |
| 401 | Unauthorized - missing or invalid API key |
| 429 | Rate limit exceeded |
| 500 | Internal server error |
Usage Limits
Rate limits vary by plan. Planned limits are shown below and may change before public release. Rate limits shown here are planned for developer preview and may change before public release.
| Plan | Monthly Requests |
|---|---|
| Free | 100 requests/month |
| Starter | 10,000 requests/month |
| Pro | 100,000 requests/month |
| Enterprise | Custom |
Rate limits will be enforced when the API launches. During the developer preview period, higher limits may be available on request. See planned API pricing for details.
SDK Examples
Use these code examples to integrate the API into your application. SDK packages are planned but not yet published. These are developer preview examples showing the intended interface.
JavaScript
Python
AI-Readable API Documentation
ColdDMCalculator publishes structured docs, benchmark pages, JSON examples, and machine-readable files so AI assistants, search engines, and developer tools can understand what the API is designed to do.
llms.txt
Concise API summary for AI assistants at colddmcalculator.com/llms.txt. Includes core endpoints, use cases, and positioning.
llms-full.txt
Full context file at colddmcalculator.com/llms-full.txt with detailed API overview, request/response examples, and integration guidance.
AI Sitemap
Structured page index at colddmcalculator.com/ai-sitemap.json for AI crawlers and developer discovery tools.
API Examples
Practical developer-preview examples at /api/examples/ for LinkedIn, Instagram, creator, and agency campaign forecasting.
Cold DM Benchmarks
Benchmark ranges for reply rates, booked calls, clients, and ROI across platforms at /benchmark/.
Free Calculator
Test the forecasting logic directly with the interactive Cold DM calculator on the homepage.
Frequently Asked Questions
The API is not publicly live yet. These docs describe the planned developer-preview interface, and teams can request access to be notified when test keys are available.
It is a REST API that forecasts cold DM campaign outcomes including replies, positive replies, booked calls, clients, revenue, campaign score, risk level, and optimization recommendations before you send a campaign.
The base URL is shown for planning and documentation purposes. Public requests are not guaranteed to work until developer-preview access begins.
No. The API does not send messages, automate DMs, scrape platforms, or bypass platform rules. It is designed exclusively for campaign planning, forecasting, reporting, and decision support.
The API can forecast replies, positive replies, booked calls, clients, revenue, campaign quality score, risk level, and provides actionable optimization recommendations for your cold DM campaigns.
No. Forecasts are estimates based on user-provided assumptions and benchmark ranges. They are not guarantees of replies, meetings, clients, revenue, or ROI.