API Reference

Base URL

https://api.distribute.you/v1

Authentication

All requests require your API key in the header:

curl https://api.distribute.you/v1/campaigns \
  -H "X-API-Key: YOUR_API_KEY"

Get your API key at dashboard.distribute.you/api-keys

Endpoints

Account

Company Scraping

Scrape Company

POST /v1/company/scrape
Content-Type: application/json

{
  "url": "https://acme.com"
}

Lead Search

Search Leads

POST /v1/leads/search
Content-Type: application/json

{
  "person_titles": ["CEO", "CTO", "Founder"],
  "organization_locations": ["United States"],
  "organization_industries": ["Software"],
  "per_page": 10
}

Reply Qualification

Qualify Reply

POST /v1/qualify
Content-Type: application/json

{
  "fromEmail": "prospect@company.com",
  "toEmail": "sales@yourbrand.com",
  "subject": "Re: Quick question",
  "bodyText": "Thanks for reaching out! I'd love to learn more..."
}

Campaigns

Create Campaign

POST /v1/campaigns
Content-Type: application/json

{
  "name": "Q1 Outreach",
  "brandUrl": "https://yourbrand.com",
  "targetAudience": "CTOs at SaaS startups with 10-50 employees in the US",
  "targetOutcome": "Book sales demos",
  "valueForTarget": "Access to enterprise analytics at startup pricing",
  "maxBudgetDailyUsd": 10
}

Rate Limits

Rate limit: 100 requests/minute

Errors

All errors return a JSON response:

{
  "error": "Invalid API key"
}

HTTP Status Codes