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"
  }'

{
  "id": "auto-uuid-new",
  ...,
  "warnings": [
    "auto_enrich is deprecated and was ignored. Use icp_gate (off | fit_or_adjacent | fit_only) with a one-line ICP in Settings → Ideal Customer."
  ]
}

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 its ICP Fit headline label and email (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.

Live LinkedIn content search — posts that contain your keywords, by anyone. Distinct from GET /api/v1/posts (a known person's recent posts), GET /api/v1/discover (Lead Magnet Radar corpus), and POST /api/linkedin-search (people only). Each result's post_id drops into the engagement and comment/react endpoints.

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.

Dashboard activity

Rollups of your automation activity for exports and reporting — comments processed, DMs, connections, replies, and leads — matching the main dashboard. Pick a granularity: daily, weekly, monthly, or all-time.

Discover APIApex

A continuously refreshed feed of fresh lead-magnet posts from the LeadShark Lead Magnet Radar — prospect-rich posts to engage. Returns the public post, creator identity, and engagement counts only. Requires an Apex subscription.

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.Popular pattern: compile a daily engagement digest (profile viewers, likes, comments, new followers) with a morning cron job.

"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.
• Followers source — default recent reads "started following you" notification cards (best for newest followers). Use source=list only when you need bulk export and can tolerate LIST limitations on large accounts.
• network_distance values: DISTANCE_1, DISTANCE_2, DISTANCE_3, OUT_OF_NETWORK, SELF, or null when LinkedIn doesn't expose it.

Daily engagement digestPlaybook

A popular integration pattern: run one scheduled job every morning (e.g. 8:00 in your timezone) and compile who engaged with you in the last 24 hours — profile viewers, post likes, comments, and new followers — using only the Engagement API endpoints above (live reads from your connected LinkedIn account).

Four pulls, one report

1. Comments — filter on posted_at

List posts, then pull comments per post_id. Paginate both steps. This is the only engagement type with a true 24-hour window on a single daily poll.

const since = Date.now() - 24 * 60 * 60 * 1000;
const last24h = items.filter(
  (c) => c.posted_at && Date.parse(c.posted_at) >= since
);

2. Likes — daily snapshot diff

The reactions endpoint returns reaction_type per person but not when they reacted. Each morning, store the full set of reactor.member_urn (or reactor.linkedin_id) per post. New IDs since yesterday ≈ likes in the last run.

NEW_LIKES = reactors_today − reactors_yesterday   // per post_id

3. Profile viewers — daily snapshot diff

Paginate /profile-viewers (10 per page, ?cursor=10, 20, …). Diff viewer keys day over day. Parsing viewed_at_label ("1d ago") is possible but brittle.

4. New followers — daily snapshot diff

source=recent reads "started following you" notification cards — best for newest followers on large accounts. Paginate with pagination.cursor. Diff actor_id day over day.

Job outline (cron, GitHub Actions, Zapier, etc.)

1. Paginate GET /api/v1/posts?limit=50 → collect post_id values (optionally stop when posted_at is older than ~30 days).
2. Per post: paginate comments → keep posted_at ≥ now() − 24h.
3. Per post: paginate reactions → build today's reactor ID set.
4. Diff reactor sets vs yesterday → new likes.
5. Paginate profile viewers → diff vs yesterday → new viewers.
6. Paginate /followers?source=recent → diff vs yesterday → new followers.
7. Persist today's snapshots; send your report (email, Slack, sheet, warehouse).

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

LinkedIn Post Actions

Available to Pro, Pro+, and Apex accounts. These endpoints act through your connected LinkedIn account and use the same safety mode, queue, Emergency Stop, quiet-hours, pacing, retry ceiling, circuit breaker, and action log as Apex MCP. Free and unverifiable subscriptions fail closed before LinkedIn is called.

Activity Limits

Read where you stand — “can I act now, and how much room is left?” — and set any channel from 0 up to its max. With a direct API key it’s simple: raising and lowering both apply immediately, and the per-channel max is the safety bound. This is the REST twin of themanage_activity_limits MCP tool (which keeps a stricter guard for autonomous agents). Available to Pro, Pro+, and Apex. All caps are shared with your automations.