LeadShark API

Overview

The LeadShark API provides programmatic access to LinkedIn enrichment, automation management, bookmarking, and scheduled posting. Available on all paid plans (Pro, Pro+, Apex).

Authentication

Include your API key in the request header.

Rate Limits

Exceeding limits returns 429 Too Many Requests. Use exponential backoff.

Enrichment API

Enrich LinkedIn profiles and companies with detailed data.

Automations API

Create and manage LinkedIn post engagement automations.

# 1. Find the post you want to automate
curl 'https://apex.leadshark.io/api/v1/posts?limit=5' \
  -H "x-api-key: YOUR_API_KEY"
# → grab items[N].post_id  (e.g. "urn:li:activity:7150123456789012345")
# → grab items[N].share_url (e.g. "https://www.linkedin.com/posts/...")

# 2. Create the automation using those values
curl -X POST 'https://apex.leadshark.io/api/automations' \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "name": "Guide Giveaway",
    "post_id": "urn:li:activity:7150123456789012345",
    "linkedin_post_url": "https://www.linkedin.com/posts/...",
    "keywords": ["interested"],
    "dm_template": "Hi {{firstName}}! Here is the guide: https://example.com/guide"
  }'

curl -X POST 'https://apex.leadshark.io/api/automations' \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "name": "Webhook only — Q1 lead magnet",
    "post_id": "urn:li:activity:7150123456789012345",
    "linkedin_post_url": "https://www.linkedin.com/posts/..."
  }'

Leads API

List all your leads (from automations and post engagement). Each lead includes email & ICP score (when present). Paginated for large lists.

• Use response.data for the current page; use response.pagination.has_more to know if there is a next page.
• First page: GET /api/leads?page=1&limit=250 (omit params for defaults).
• Only non-archived, individual leads (LinkedIn profile IDs starting with ACo) are returned.
• Response uses a limited field set; user_id, icp_starred, icp_negative and related internal fields are not included.

Bookmarks API

Save and organize LinkedIn profiles with tags and notes.

Scheduled Posts API

Schedule LinkedIn posts with optional pre-configured automations that activate when the post goes live.

curl 'https://apex.leadshark.io/api/automation-templates' \
  -H "x-api-key: YOUR_API_KEY"

curl -X POST 'https://apex.leadshark.io/api/v1/pages' \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "LinkedIn Growth Playbook",
    "status": "published",
    "page_title": "Get Your Free Playbook",
    "page_description": "The exact strategies I used to grow to 100K followers",
    "questions": [{
      "question_text": "What is your biggest LinkedIn challenge?",
      "answers": [
        { "answer_text": "Getting more engagement", "mapped_outcome": "fit" },
        { "answer_text": "Growing my network", "mapped_outcome": "fit" },
        { "answer_text": "Just browsing", "mapped_outcome": "not" }
      ]
    }]
  }'

curl -X POST 'https://apex.leadshark.io/api/scheduled-posts' \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Comment PLAYBOOK and I'\''ll DM it to you!",
    "scheduled_time": "2026-04-25T14:00:00Z",
    "automation": {
      "name": "Playbook Giveaway",
      "keywords": ["playbook", "interested", "yes"],
      "dm_template": "Hey {{firstName}}! Here is your playbook: https://example.com/playbook",
      "auto_connect": true,
      "links_enabled": true,
      "page_id": "abc-123",
      "quiz_enabled": true
    }
  }'

Posts & Stats API

List recent posts (your own or anyone's) and pull aggregate engagement stats.

One call returns lifetime totals across your last N posts (impressions, comments, reactions, reposts) without you having to paginate and sum yourself. Great for dashboards and weekly reports. Apex-gated because each call may walk multiple upstream pages.

Signals APIApex

Access your ranked hot leads and raw engagement signal events via API. Requires an Apex subscription.

• Use response.pagination.total_pages to know how many pages exist. Increment page until you reach it.
• Both endpoints use total_pages pagination (not has_more). Check page < total_pages to determine if more data is available.
• All results are scoped to the authenticated user's data only.

Engagement APIPro & up

See exactly who's engaging with you on LinkedIn — the people who reacted to a specific post, left a comment, reshared it, or recently viewed your profile. Results are pulled live from your connected LinkedIn account, so what you see is what's on LinkedIn right now.

"social_id": "urn:li:ugcPost:74549342603287*****"   →   use as post_id

{
  "items": [...],
  "pagination": {
    "cursor": "abc123" | null,
    "has_more": true | false
  }
}

• Reposts pagination uses single-page-per-call (~10 items) deliberately. The underlying LinkedIn surface is sensitive to aggressive polling; spread your walks with a 1–2 second delay between cursor calls.
• Profile viewers Premium gate hard-fails on the first page only. Subsequent calls with a valid cursor that return zero elements are returned as a normal empty page with has_more: false.
• network_distance values: DISTANCE_1, DISTANCE_2, DISTANCE_3, OUT_OF_NETWORK, SELF, or null when LinkedIn doesn't expose it.

Links APIPro+

Create and manage lead magnet links with analytics. Requires Pro+ or Apex subscription.

Pages APIPro+

Create and manage quiz pages, view responses, and export collected emails. Requires Pro+ or Apex subscription.

Webhooks APIPro

Programmatically create, update, list, delete, and test webhooks. Webhooks let LeadShark push real-time events (new comments, likes, profile visits, captured emails, etc.) to your own URL with an HMAC-SHA256 signature. Available on Pro and above; some event types are Apex-only.

// Node.js example
const crypto = require('crypto');
const expected = crypto
  .createHmac('sha256', process.env.WEBHOOK_SECRET)
  .update(rawBody)
  .digest('hex');
const ok = crypto.timingSafeEqual(
  Buffer.from(expected),
  Buffer.from(req.headers['x-webhook-signature'])
);

Error Codes