Social Media Data API

26 pay-per-call social media data tools for agents: social listening, mentions, post search, comments and public profiles across 10 platforms. $0.01-$0.025 per tool call via x402 (USDC on Base); no account or API key.

Gehosteter MCP-Server

npx add-mcp 'https://social.duoleads.com/mcp'

Installiert in Claude Code, Codex, Cursor und mehr

Dokumentation

Social Media Data API: documentation

Payment

Every data route is paid per call over x402 v2 (scheme exact): HTTP 402 plus USDC on Base (CAIP-2 eip155:8453), settled through the Coinbase CDP facilitator. An unpaid request returns 402 with a base64 PAYMENT-REQUIRED header (price, payTo, asset) and a JSON body with a hint. Sign an EIP-3009 authorization for exactly that amount and send the request with its required parameters and a base64 PAYMENT-SIGNATURE header; the 200 response carries a base64 PAYMENT-RESPONSE receipt. Malformed input (400), unknown paths (404) and the wrong method (405) are answered before the paywall and never charged. An account, post or video that does not exist, or a search without matches, is a 404, and a total upstream failure (nothing to answer) or a capacity limit is a 503: in every one of these cases your authorization is NOT settled. A partial answer IS charged: a 200 with complete: false because one part failed (platforms_missing or posts_missing names it; a Hacker News reply that failed to load is left out).

Quick start

Try it from a terminal: npx agentcash try https://social.duoleads.com

Python (requests):

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client
client = x402ClientSync()
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["PRIVATE_KEY"])))  # a Base wallet holding USDC
session = x402_requests(client)  # pays the 402 and retries for you
r = session.get("https://social.duoleads.com/v1/social/mentions?q=open+source&days=7", timeout=30)
print(r.status_code, r.json())

TypeScript (fetch):

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const account = privateKeyToAccount(process.env.PRIVATE_KEY as \`0x${string}\`); // a Base wallet holding USDC
const pay = wrapFetchWithPayment(fetch, new x402Client().register("eip155:8453", new ExactEvmScheme(account)));
const res = await pay("https://social.duoleads.com/v1/social/mentions?q=open+source&days=7", { signal: AbortSignal.timeout(30_000) });
process.stdout.write(\`${res.status} ${JSON.stringify(await res.json())}\n\`);

Most paid answers take 1-5 s, some up to about 20 s: give your HTTP client a timeout of at least 30 s. The payment settles only after the answer is ready, so a call that fails before that is never charged.

A bare URL without any parameters answers with the 402 (that is how discovery probes see the price); a request with missing or malformed parameters is a free 400 that says what would be accepted.

Methods

Methods: every route is a GET with query parameters. Also accepts POST with the same parameters as a JSON object body (numbers may be JSON numbers), or the same query string with an empty body. Unknown parameters are a free 400 either way; any other method is a free 405.

Answers

Every 200 answer has the same envelope: platform, query (the normalised input), as_of (when the data was fetched), complete (false when part of the data could not be fetched; such a partial answer is charged and never cached), items (posts, comments, videos, ads, profiles or company pages in ONE schema: type, platform, id, url, created_at, text, author {handle, display_name, verified, followers}, metrics {likes, replies, reposts, views}, lang, media_urls, parent_id), next_cursor (pass it as cursor for the next page; null at the end), source, disclaimer and request_id. Media are links, never bytes. Answers may come from a short cache (5 minutes for posts, search and comments, 15 for profiles and aggregates, 1 hour for transcripts).

Errors

Errors are {error:{status, code, message, param, expected}, request_id, disclaimer}: 400 for bad input (free, with what would have been accepted), 404 (unknown path, an account, post or video that does not exist, or no match: not charged), 405, 402 (payment required or refused), 503 (a total upstream failure with nothing to answer, a rate limit or capacity: nothing was charged; retry later), 500 when a settlement could not be confirmed (the data was withheld; contact us with the request id). A partial answer IS charged: a 200 with complete: false because one part failed (platforms_missing or posts_missing names it; a Hacker News reply that failed to load is left out).

MCP

Streamable HTTP at https://social.duoleads.com/mcp (stateless, JSON responses). tools/list is free; tools/call is paid with x402 (the payment goes in _meta["x402/payment"], the receipt comes back in _meta["x402/payment-response"]). Tools: bluesky_search ($0.01), bluesky_posts ($0.01), bluesky_profile ($0.01), hackernews_search ($0.01), hackernews_thread ($0.01), social_mentions ($0.01), x_search ($0.02), x_posts ($0.02), x_profile ($0.02), reddit_search ($0.02), reddit_comments ($0.02), tiktok_videos ($0.02), tiktok_search ($0.02), instagram_profile ($0.02), youtube_transcript ($0.02), youtube_comments ($0.02), threads_posts ($0.02), facebook_ads ($0.02), social_search ($0.025), social_audience ($0.02), social_accounts ($0.02), linkedin_company ($0.02), people_search ($0.02), tiktok_followers ($0.02), tiktok_following ($0.02), linkedin_profile ($0.02). Same checks, prices and order as HTTP.

A2A

JSON-RPC at https://social.duoleads.com/a2a (A2A 1.0 SendMessage and 0.3 message/send, stateless), agent card at https://social.duoleads.com/.well-known/agent-card.json. A message without a skill is a free list of skills. To run one, send a DataPart {"skill": "<MCP tool name>", "params": {...}} with the header A2A-Extensions: https://github.com/google-agentic-commerce/a2a-x402/blob/main/spec/v0.2: integer parameters are JSON integers, booleans are true or false, and an unknown parameter is a free refusal. You get a task in input-required state with x402.payment.required. Sign it and resend with the taskId and metadata x402.payment.status "payment-submitted" and x402.payment.payload; the completed task carries the result artifact and x402.payment.receipts. The task id holds your request's values: it is returned only to you and we never store it. Same checks, prices and order as HTTP.

GET /v1/bluesky/search ($0.01)

Bluesky Posts & Search: find public Bluesky posts by keyword, phrase, hashtag or from:handle through the AT Protocol AppView, newest first. Per post the text, author handle and display name, likes, replies, reposts, language, media links, time and URL, in one schema shared by every platform; next_cursor gives the next page. Social listening on Bluesky for brands, products and topics. Bad input is free; not found or no match is not charged.

MCP tool: bluesky_search.

ParameterRequiredDescription
qyesSearch text (1-200 characters; Bluesky search syntax such as from:, #tag and quotes works).
limitnoPosts per page, 1-25. Default 25.
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/bluesky/search?q=open+source&limit=10'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "bluesky",
  "query": {
    "q": "synthetic widgets",
    "limit": 10,
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "post",
      "platform": "bluesky",
      "id": "at://did:plc:synth000000000000000000000001/app.bsky.feed.post/3lsynth000001",
      "url": "https://bsky.app/profile/synth-alpha.bsky.social/post/3lsynth000001",
      "created_at": "2026-10-14T10:00:00.000Z",
      "text": "The synthwidget launch went really well, great work team!",
      "author": {
        "handle": "synth-alpha.bsky.social",
        "display_name": "Synthetic Alpha",
        "verified": true,
        "followers": null
      },
      "metrics": {
        "likes": 42,
        "replies": 3,
        "reposts": 5,
        "views": null
      },
      "lang": "en",
      "media_urls": [
        "https://cdn.bsky.app/img/feed_fullsize/plain/did:plc:synth000000000000000000000001/bafkreiimg@jpeg"
      ],
      "parent_id": null
    },
    {
      "type": "post",
      "platform": "bluesky",
      "id": "at://did:plc:synth000000000000000000000002/app.bsky.feed.post/3lsynth000002",
      "url": "https://bsky.app/profile/synth-beta.example.com/post/3lsynth000002",
      "created_at": "2026-10-14T11:30:00.000Z",
      "text": "synthwidget is not working for me today",
      "author": {
        "handle": "synth-beta.example.com",
        "display_name": "Synthetic Beta",
        "verified": false,
        "followers": null
      },
      "metrics": {
        "likes": 1,
        "replies": 0,
        "reposts": 0,
        "views": null
      },
      "lang": "en",
      "media_urls": [],
      "parent_id": null
    }
  ],
  "next_cursor": "25",
  "source": "public data via the Bluesky AppView API; not affiliated with Bluesky",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/bluesky/posts ($0.01)

Bluesky Account Posts Feed: the latest public posts and replies of one Bluesky account (a handle such as name.bsky.social, a DID or a bsky.app profile URL), reposts left out. Per post the text, likes, replies, reposts, language, media links, time and URL in the shared social schema; next_cursor pages back through the feed. Bad input is free; not found or no match is not charged.

MCP tool: bluesky_posts.

ParameterRequiredDescription
handleyesThe account: a Bluesky handle (a domain name such as name.bsky.social, or a bare name meaning name.bsky.social), a did:plc / did:web identifier, or a bsky.app profile URL.
limitnoPosts per page, 1-25. Default 25.
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/bluesky/posts?handle=bsky.app&limit=10'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "bluesky",
  "query": {
    "handle": "synthbrand.bsky.social",
    "limit": 10,
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "post",
      "platform": "bluesky",
      "id": "at://did:plc:synth000000000000000000000001/app.bsky.feed.post/3lsynth000003",
      "url": "https://bsky.app/profile/synth-alpha.bsky.social/post/3lsynth000003",
      "created_at": "2026-10-14T08:00:00.000Z",
      "text": "Morning post from a synthetic account",
      "author": {
        "handle": "synth-alpha.bsky.social",
        "display_name": "Synthetic Alpha",
        "verified": true,
        "followers": null
      },
      "metrics": {
        "likes": 10,
        "replies": 2,
        "reposts": 1,
        "views": null
      },
      "lang": "en",
      "media_urls": [],
      "parent_id": null
    },
    {
      "type": "post",
      "platform": "bluesky",
      "id": "at://did:plc:synth000000000000000000000001/app.bsky.feed.post/3lsynth000004",
      "url": "https://bsky.app/profile/synth-alpha.bsky.social/post/3lsynth000004",
      "created_at": "2026-10-14T08:05:00.000Z",
      "text": "Replying to myself",
      "author": {
        "handle": "synth-alpha.bsky.social",
        "display_name": "Synthetic Alpha",
        "verified": true,
        "followers": null
      },
      "metrics": {
        "likes": 1,
        "replies": 0,
        "reposts": 0,
        "views": null
      },
      "lang": "en",
      "media_urls": [],
      "parent_id": "at://did:plc:synth000000000000000000000001/app.bsky.feed.post/3lsynth000003"
    }
  ],
  "next_cursor": "2026-10-13T09:00:00.000Z",
  "source": "public data via the Bluesky AppView API; not affiliated with Bluesky",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/bluesky/profile ($0.01)

Bluesky Profile Lookup: one public Bluesky account by handle, DID or bsky.app URL: display name, bio, follower, following and post counts, verification, avatar link, creation time and DID, in the shared social schema. Bad input is free; not found or no match is not charged.

MCP tool: bluesky_profile.

ParameterRequiredDescription
handleyesThe account: a Bluesky handle (a domain name such as name.bsky.social, or a bare name meaning name.bsky.social), a did:plc / did:web identifier, or a bsky.app profile URL.

Example request

curl -i 'https://social.duoleads.com/v1/bluesky/profile?handle=bsky.app'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "bluesky",
  "query": {
    "handle": "synthbrand.bsky.social"
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "profile",
      "platform": "bluesky",
      "id": "did:plc:synth000000000000000000000001",
      "url": "https://bsky.app/profile/synth-alpha.bsky.social",
      "created_at": "2023-06-01T12:00:00.000Z",
      "text": "Synthetic Bluesky account for tests.",
      "author": {
        "handle": "synth-alpha.bsky.social",
        "display_name": "Synthetic Alpha",
        "verified": true,
        "followers": 1234
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [
        "https://cdn.bsky.app/img/avatar/plain/did:plc:synth000000000000000000000001/bafkreisynth@jpeg"
      ],
      "parent_id": null,
      "profile": {
        "following": 56,
        "posts": 789,
        "likes_total": null
      }
    }
  ],
  "next_cursor": null,
  "source": "public data via the Bluesky AppView API; not affiliated with Bluesky",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/hackernews/search ($0.01)

Hacker News Search & Stories: full-text search of Hacker News stories or comments (HN Search by Algolia). Per hit the title, text, author, points, comment count, linked URL, time and item URL in the shared social schema; next_cursor gives the next page. Tech news, launches and developer discussion for market and competitor research. Bad input is free; not found or no match is not charged.

MCP tool: hackernews_search.

ParameterRequiredDescription
qyesSearch text (1-200 characters).
limitnoResults per page, 1-20. Default 20.
typenostory or comment. Default story. One of: story, comment.
cursornonext_cursor of the previous page (a page number).

Example request

curl -i 'https://social.duoleads.com/v1/hackernews/search?q=open+source&type=story&limit=10'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "hackernews",
  "query": {
    "q": "synthetic widgets",
    "limit": 10,
    "type": "story",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "post",
      "platform": "hackernews",
      "id": "40000001",
      "url": "https://news.ycombinator.com/item?id=40000001",
      "created_at": "2026-10-13T14:00:00.000Z",
      "text": null,
      "title": "Show HN: Synthwidget, a synthetic widget",
      "author": {
        "handle": "synth_hn_user1",
        "display_name": null,
        "verified": null,
        "followers": null
      },
      "metrics": {
        "likes": 128,
        "replies": 47,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null,
      "link_url": "https://example.invalid/synthwidget"
    },
    {
      "type": "post",
      "platform": "hackernews",
      "id": "40000002",
      "url": "https://news.ycombinator.com/item?id=40000002",
      "created_at": "2026-10-12T10:13:20.000Z",
      "text": null,
      "title": "Ask HN: Anyone using synthwidget?",
      "author": {
        "handle": "synth_hn_user2",
        "display_name": null,
        "verified": null,
        "followers": null
      },
      "metrics": {
        "likes": 5,
        "replies": 2,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null,
      "link_url": null
    }
  ],
  "next_cursor": "1",
  "source": "public data via the Hacker News API (Algolia search and Firebase); not affiliated with Y Combinator",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/hackernews/thread ($0.01)

Hacker News Comments & Threads: one Hacker News story or comment by id or news.ycombinator.com URL with its direct replies (up to 8 per call, next_cursor for more), deleted and dead replies skipped. Per item the text as plain text, author, score, reply count, parent and time in the shared social schema. Bad input is free; not found or no match is not charged.

MCP tool: hackernews_thread.

ParameterRequiredDescription
idyesThe story or comment: a Hacker News item id (a positive whole number) or a news.ycombinator.com/item?id= URL.
limitnoDirect replies wanted, 1-50 (default 10); one call returns at most 8, next_cursor pages through the rest.
cursornonext_cursor of the previous page (a reply offset).

Example request

curl -i 'https://social.duoleads.com/v1/hackernews/thread?id=27326961&limit=10'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "hackernews",
  "query": {
    "id": "40000001",
    "limit": 10,
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "post",
      "platform": "hackernews",
      "id": "40000001",
      "url": "https://news.ycombinator.com/item?id=40000001",
      "created_at": "2026-10-13T14:00:00.000Z",
      "text": null,
      "title": "Show HN: Synthwidget, a synthetic widget",
      "author": {
        "handle": "synth_hn_user1",
        "display_name": null,
        "verified": null,
        "followers": null
      },
      "metrics": {
        "likes": 128,
        "replies": 47,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null,
      "link_url": "https://example.invalid/synthwidget"
    },
    {
      "type": "comment",
      "platform": "hackernews",
      "id": "40000011",
      "url": "https://news.ycombinator.com/item?id=40000011",
      "created_at": "2026-10-13T14:10:00.000Z",
      "text": "Looks useful. How does it compare to the old one?",
      "author": {
        "handle": "synth_hn_user4",
        "display_name": null,
        "verified": null,
        "followers": null
      },
      "metrics": {
        "likes": null,
        "replies": 1,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": "40000001"
    }
  ],
  "next_cursor": null,
  "source": "public data via the Hacker News API (Algolia search and Firebase); not affiliated with Y Combinator",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/social/mentions ($0.01)

Social Mentions & Sentiment: daily mention counts, distinct authors and mean VADER sentiment for a brand, product or topic over the last 1-7 days, plus the top 10 co-occurring terms. Sources: Bluesky and Hacker News, plus Reddit and X (latest, newest first) when available. One page per source: days beyond its reach come back truncated (coverage_from). Aggregate only, no text, no authors; a day under 20 known authors is suppressed. Bad input is free; not found or no match is not charged.

MCP tool: social_mentions.

ParameterRequiredDescription
qyesBrand, product or topic (1-100 characters).
daysnoUTC days ending today, 1-7. Default 7.

Example request

curl -i 'https://social.duoleads.com/v1/social/mentions?q=open+source&days=7'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "multi",
  "query": {
    "q": "synthbusy widgets",
    "days": 7,
    "sources": [
      "bluesky",
      "hackernews",
      "x",
      "reddit"
    ]
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": false,
  "items": [],
  "next_cursor": null,
  "platforms": [
    "bluesky",
    "hackernews",
    "x",
    "reddit"
  ],
  "platforms_missing": [],
  "days": [
    {
      "date": "2026-10-09",
      "mentions": null,
      "authors": null,
      "sentiment": null,
      "suppressed": false,
      "truncated": true
    },
    {
      "date": "2026-10-10",
      "mentions": null,
      "authors": null,
      "sentiment": null,
      "suppressed": false,
      "truncated": true
    },
    {
      "date": "2026-10-11",
      "mentions": null,
      "authors": null,
      "sentiment": null,
      "suppressed": false,
      "truncated": true
    },
    {
      "date": "2026-10-12",
      "mentions": null,
      "authors": null,
      "sentiment": null,
      "suppressed": false,
      "truncated": true
    },
    {
      "date": "2026-10-13",
      "mentions": null,
      "authors": null,
      "sentiment": null,
      "suppressed": false,
      "truncated": true
    },
    {
      "date": "2026-10-14",
      "mentions": 27,
      "authors": 27,
      "sentiment": 0.7522,
      "suppressed": false,
      "truncated": false
    },
    {
      "date": "2026-10-15",
      "mentions": 0,
      "authors": 0,
      "sentiment": null,
      "suppressed": false,
      "truncated": false
    }
  ],
  "top_terms": [
    {
      "term": "synthwidget",
      "count": 27
    },
    {
      "term": "great",
      "count": 25
    },
    {
      "term": "launch",
      "count": 25
    }
  ],
  "suppressed_buckets": 0,
  "total_mentions": 27,
  "coverage_from": "2026-10-14T00:00:00.000Z",
  "source": "public data via the Bluesky AppView API; not affiliated with Bluesky; public data via the Hacker News API (Algolia search and Firebase); not affiliated with Y Combinator; public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/x/search ($0.02)

Twitter API: Tweet Search: the latest public tweets on X matching a keyword or phrase, newest first. Per tweet the text, author handle and name, verification, followers, likes, replies, retweets, views, language, time and URL in one schema shared by every platform; parent_id names the replied-to or quoted tweet; next_cursor gives the next page. For social listening, brand monitoring and research. Bad input is free; not found or no match is not charged.

MCP tool: x_search.

ParameterRequiredDescription
qyesSearch text (1-200 characters).
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/x/search?q=open+source'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "x",
  "query": {
    "q": "synthetic widgets",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "post",
      "platform": "x",
      "id": "1910000000000000001",
      "url": "https://x.com/synth_alpha/status/1910000000000000001",
      "created_at": "2026-10-01T18:50:27.000Z",
      "text": "Trying the synthwidget beta today, the dark mode is great",
      "author": {
        "handle": "synth_alpha",
        "display_name": "Synthetic Alpha",
        "verified": true,
        "followers": 1234
      },
      "metrics": {
        "likes": 11,
        "replies": 4,
        "reposts": 2,
        "views": 780
      },
      "lang": "en",
      "media_urls": [],
      "parent_id": "1910000000000000901"
    },
    {
      "type": "post",
      "platform": "x",
      "id": "1910000000000000002",
      "url": "https://x.com/synth_beta/status/1910000000000000002",
      "created_at": "2026-10-02T09:00:00.000Z",
      "text": "synthwidget support never answered my ticket",
      "author": {
        "handle": "synth_beta",
        "display_name": "Synthetic Beta",
        "verified": false,
        "followers": 88
      },
      "metrics": {
        "likes": 0,
        "replies": 1,
        "reposts": 0,
        "views": 45
      },
      "lang": "en",
      "media_urls": [],
      "parent_id": "1910000000000000001"
    }
  ],
  "next_cursor": "synthcursor_2",
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/x/posts ($0.02)

Twitter API: User Tweets: the latest public tweets of one X (Twitter) account by handle or x.com URL, newest first. Per tweet the text, author handle and name, verification, followers, likes, replies, retweets, views, language, reply or quote parent, time and URL in the shared social schema; next_cursor gives the next page. Bad input is free; not found or no match is not charged.

MCP tool: x_posts.

ParameterRequiredDescription
handleyesAn X handle (with or without @) or an x.com profile URL.
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/x/posts?handle=nasa'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "x",
  "query": {
    "handle": "synthbrand",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "post",
      "platform": "x",
      "id": "1910000000000000001",
      "url": "https://x.com/synth_alpha/status/1910000000000000001",
      "created_at": "2026-10-01T18:50:27.000Z",
      "text": "Trying the synthwidget beta today, the dark mode is great",
      "author": {
        "handle": "synth_alpha",
        "display_name": "Synthetic Alpha",
        "verified": true,
        "followers": 1234
      },
      "metrics": {
        "likes": 11,
        "replies": 4,
        "reposts": 2,
        "views": 780
      },
      "lang": "en",
      "media_urls": [],
      "parent_id": "1910000000000000901"
    },
    {
      "type": "post",
      "platform": "x",
      "id": "1910000000000000002",
      "url": "https://x.com/synth_beta/status/1910000000000000002",
      "created_at": "2026-10-02T09:00:00.000Z",
      "text": "synthwidget support never answered my ticket",
      "author": {
        "handle": "synth_beta",
        "display_name": "Synthetic Beta",
        "verified": false,
        "followers": 88
      },
      "metrics": {
        "likes": 0,
        "replies": 1,
        "reposts": 0,
        "views": 45
      },
      "lang": "en",
      "media_urls": [],
      "parent_id": "1910000000000000001"
    }
  ],
  "next_cursor": "synthcursor_posts_2",
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/x/profile ($0.02)

Twitter API: User Profile: one public X (Twitter) account by handle or x.com URL: display name, bio, followers, following, post count, verification, avatar link and creation time, in the shared social schema. Bad input is free; not found or no match is not charged.

MCP tool: x_profile.

ParameterRequiredDescription
handleyesAn X handle (with or without @) or an x.com profile URL.

Example request

curl -i 'https://social.duoleads.com/v1/x/profile?handle=nasa'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "x",
  "query": {
    "handle": "synthbrand"
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "profile",
      "platform": "x",
      "id": "20000001",
      "url": "https://x.com/synthbrand",
      "created_at": "2014-03-12T09:30:00.000Z",
      "text": "Synthetic account for tests.",
      "author": {
        "handle": "synthbrand",
        "display_name": "Synthetic Brand",
        "verified": true,
        "followers": 44240
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [
        "https://pbs.twimg.invalid/profile/synthbrand.jpg"
      ],
      "parent_id": null,
      "profile": {
        "following": 81,
        "posts": 213,
        "likes_total": 99
      }
    }
  ],
  "next_cursor": null,
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/reddit/search ($0.02)

Reddit Posts & Subreddit Search: search public Reddit posts by keyword, within one subreddit, or list a subreddit's newest posts. Per post the title, text, subreddit, author, upvotes, comment count, linked URL, time and permalink in the shared social schema; next_cursor gives the next page. Forum research and social listening. Bad input is free; not found or no match is not charged.

MCP tool: reddit_search.

ParameterRequiredDescription
qnoSearch text (1-200 characters). Give q, subreddit or both.
subredditnoLimit to one community: a subreddit name: 2 to 21 letters, digits or underscores, with or without r/. Alone it returns the subreddit's newest posts.
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/reddit/search?q=open+source'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "reddit",
  "query": {
    "q": "synthetic widgets",
    "subreddit": null,
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "post",
      "platform": "reddit",
      "id": "synp001",
      "url": "https://www.reddit.com/r/SynthTech/comments/synp001/synthetic_post/",
      "created_at": "2026-10-14T00:00:00.000Z",
      "text": null,
      "title": "Is synthwidget worth it?",
      "author": {
        "handle": "synth_redditor_1",
        "display_name": null,
        "verified": null,
        "followers": null
      },
      "metrics": {
        "likes": 2204,
        "replies": 124,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null,
      "community": "SynthTech",
      "link_url": null
    },
    {
      "type": "post",
      "platform": "reddit",
      "id": "synp002",
      "url": "https://www.reddit.com/r/SynthTech/comments/synp002/synthetic_post/",
      "created_at": "2026-10-14T01:00:00.000Z",
      "text": null,
      "title": "synthwidget 2.0 first impressions",
      "author": {
        "handle": "synth_redditor_2",
        "display_name": null,
        "verified": null,
        "followers": null
      },
      "metrics": {
        "likes": 45,
        "replies": 12,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null,
      "community": "SynthTech",
      "link_url": null
    }
  ],
  "next_cursor": "t3_synp002",
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/reddit/comments ($0.02)

Reddit Post Comments: one Reddit post by id or URL with its comment thread (up to 3 reply levels, deleted and removed comments left out). Per comment the text, author, upvotes, parent, subreddit, time and permalink in the shared social schema; next_cursor gives more comments. Bad input is free; not found or no match is not charged.

MCP tool: reddit_comments.

ParameterRequiredDescription
postyesThe post: a Reddit post id (such as 1abc2de, or t3_1abc2de) or a reddit.com/r/<sub>/comments/<id>/, reddit.com/comments/<id> or redd.it/<id> URL.
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/reddit/comments?post=bpvaau'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "reddit",
  "query": {
    "post": "synp101",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "post",
      "platform": "reddit",
      "id": "synp101",
      "url": "https://www.reddit.com/r/SynthTech/comments/synp101/synthetic_post/",
      "created_at": "2026-10-14T03:53:20.000Z",
      "text": null,
      "title": "Weekly synthetic discussion thread",
      "author": {
        "handle": "synth_redditor_3",
        "display_name": null,
        "verified": null,
        "followers": null
      },
      "metrics": {
        "likes": 47,
        "replies": 353,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null,
      "community": "SynthTech",
      "link_url": null
    },
    {
      "type": "comment",
      "platform": "reddit",
      "id": "sync001",
      "url": "https://www.reddit.com/r/SynthTech/comments/synp101/synthetic_post/sync001/",
      "created_at": "2026-10-14T04:10:00.000Z",
      "text": "I like it a lot, battery life is good.",
      "author": {
        "handle": "synth_redditor_4",
        "display_name": null,
        "verified": null,
        "followers": null
      },
      "metrics": {
        "likes": 75,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": "synp101",
      "community": null
    }
  ],
  "next_cursor": "sync010,sync011",
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/tiktok/videos ($0.02)

TikTok Profile & Videos: the latest public videos of one TikTok account by handle or tiktok.com/@ URL. Per video the caption, plays, likes, comments, shares, language, cover image link, time and URL, with the creator's name, verification and followers, in the shared social schema; next_cursor pages back. Bad input is free; not found or no match is not charged.

MCP tool: tiktok_videos.

ParameterRequiredDescription
handleyesA TikTok handle (with or without @) or a tiktok.com/@handle URL.
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/tiktok/videos?handle=nasa'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "tiktok",
  "query": {
    "handle": "synthcreator",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "video",
      "platform": "tiktok",
      "id": "7000000000000000001",
      "url": "https://www.tiktok.com/@synthcreator/video/7000000000000000001",
      "created_at": "2026-10-13T14:00:00.000Z",
      "text": "Synthetic video one #synth",
      "author": {
        "handle": "synthcreator",
        "display_name": "Synthetic Creator",
        "verified": true,
        "followers": 44240
      },
      "metrics": {
        "likes": 5960,
        "replies": 58,
        "reposts": 342,
        "views": 55992
      },
      "lang": "en",
      "media_urls": [
        "https://p16.tiktokcdn.invalid/cover/7000000000000000001.jpeg"
      ],
      "parent_id": null
    },
    {
      "type": "video",
      "platform": "tiktok",
      "id": "7000000000000000002",
      "url": "https://www.tiktok.com/@synthcreator/video/7000000000000000002",
      "created_at": "2026-10-12T10:13:20.000Z",
      "text": "Synthetic video two",
      "author": {
        "handle": "synthcreator",
        "display_name": "Synthetic Creator",
        "verified": true,
        "followers": 44240
      },
      "metrics": {
        "likes": 40,
        "replies": 2,
        "reposts": 3,
        "views": 1000
      },
      "lang": "en",
      "media_urls": [
        "https://p16.tiktokcdn.invalid/cover/7000000000000000002.jpeg"
      ],
      "parent_id": null
    }
  ],
  "next_cursor": "1791800000000",
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/tiktok/search ($0.02)

TikTok Video Search: search public TikTok videos by keyword or hashtag. Per video the caption, creator handle, name, verification and followers, plays, likes, comments, shares, cover image link, time and URL in the shared social schema; next_cursor gives the next page. Trend and hashtag research. Bad input is free; not found or no match is not charged.

MCP tool: tiktok_search.

ParameterRequiredDescription
qyesSearch text (1-200 characters).
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/tiktok/search?q=open+source'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "tiktok",
  "query": {
    "q": "synthetic widgets",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "video",
      "platform": "tiktok",
      "id": "7000000000000000101",
      "url": "https://www.tiktok.com/@synth_unboxer/video/7000000000000000101",
      "created_at": "2026-10-11T06:26:40.000Z",
      "text": "synthwidget unboxing",
      "author": {
        "handle": "synth_unboxer",
        "display_name": "Synth Unboxer",
        "verified": false,
        "followers": 1476
      },
      "metrics": {
        "likes": 4816,
        "replies": 187,
        "reposts": 272,
        "views": 128264
      },
      "lang": "en",
      "media_urls": [
        "https://p16.tiktokcdn.invalid/cover/101.jpeg"
      ],
      "parent_id": null
    }
  ],
  "next_cursor": "12",
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/instagram/profile ($0.02)

Instagram Profile & Posts: one public Instagram account by handle or URL: name, bio, followers, following, post count, verification, then its recent posts and reels with caption, likes, comments, views, image link and time, in the shared social schema; next_cursor pages through the full post feed. Bad input is free; not found or no match is not charged.

MCP tool: instagram_profile.

ParameterRequiredDescription
handleyesAn Instagram handle (with or without @) or an instagram.com profile URL.
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/instagram/profile?handle=nasa'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "instagram",
  "query": {
    "handle": "synthbrand",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "profile",
      "platform": "instagram",
      "id": "3000000001",
      "url": "https://www.instagram.com/synthbrand/",
      "created_at": null,
      "text": "Synthetic brand account used in tests.",
      "author": {
        "handle": "synthbrand",
        "display_name": "Synthetic Brand",
        "verified": false,
        "followers": 24555
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [
        "https://scontent.cdninstagram.invalid/p/3000000001.jpg"
      ],
      "parent_id": null,
      "profile": {
        "following": 110,
        "posts": 90,
        "likes_total": null
      }
    },
    {
      "type": "video",
      "platform": "instagram",
      "id": "3600000000000000001",
      "url": "https://www.instagram.com/p/SYNcode001/",
      "created_at": "2026-10-03T20:33:50.000Z",
      "text": "Synthetic reel caption",
      "author": {
        "handle": "synthbrand",
        "display_name": "Synthetic Brand",
        "verified": false,
        "followers": 24555
      },
      "metrics": {
        "likes": 131,
        "replies": 14,
        "reposts": null,
        "views": 1870
      },
      "lang": null,
      "media_urls": [
        "https://scontent.cdninstagram.invalid/3600000000000000001.jpg"
      ],
      "parent_id": null
    }
  ],
  "next_cursor": "feed",
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/youtube/transcript ($0.02)

YouTube Transcript & Captions: the caption transcript of one YouTube video by id or URL (watch, shorts, live, youtu.be): the full text plus timed segments with start and end in milliseconds and the caption language. Video to text for summaries and research. A video without captions is not charged. Bad input is free; not found or no match is not charged.

MCP tool: youtube_transcript.

ParameterRequiredDescription
videoyesThe video: a YouTube video id (11 characters) or a youtube.com/watch?v=, youtube.com/shorts/, youtube.com/live/ or youtu.be/ URL.

Example request

curl -i 'https://social.duoleads.com/v1/youtube/transcript?video=iG9CE55wbtY'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "youtube",
  "query": {
    "video": "SYNvid00001"
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "video",
      "platform": "youtube",
      "id": "SYNvid00001",
      "url": "https://www.youtube.com/watch?v=SYNvid00001",
      "created_at": null,
      "text": "welcome to the synthetic channel today we test the widget",
      "author": null,
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null,
      "transcript": {
        "language": "English",
        "segments": [
          {
            "start_ms": 160,
            "end_ms": 1920,
            "text": "welcome to the synthetic channel"
          },
          {
            "start_ms": 1920,
            "end_ms": 4100,
            "text": "today we test the widget"
          }
        ]
      }
    }
  ],
  "next_cursor": null,
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/youtube/comments ($0.02)

YouTube Video Comments: the public comments on one YouTube video by id or URL. Per comment the text, author channel handle, verification, likes, reply count, time and link in the shared social schema; next_cursor gives the next page. Audience feedback and sentiment research. Bad input is free; not found or no match is not charged.

MCP tool: youtube_comments.

ParameterRequiredDescription
videoyesThe video: a YouTube video id (11 characters) or a youtube.com/watch?v=, youtube.com/shorts/, youtube.com/live/ or youtu.be/ URL.
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/youtube/comments?video=iG9CE55wbtY'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "youtube",
  "query": {
    "video": "SYNvid00001",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "comment",
      "platform": "youtube",
      "id": "UgSynthComment001",
      "url": "https://www.youtube.com/watch?v=SYNvid00001&lc=UgSynthComment001",
      "created_at": "2026-10-05T23:14:02.948Z",
      "text": "Great synthetic video, thanks!",
      "author": {
        "handle": "synthviewer1",
        "display_name": null,
        "verified": false,
        "followers": null
      },
      "metrics": {
        "likes": 110,
        "replies": 5,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null
    }
  ],
  "next_cursor": "EgsynthNextPage",
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/threads/posts ($0.02)

Threads Posts & Replies: the recent public posts of one Threads account by handle or threads.com URL. Per post the text, likes, replies, reposts, time and URL, with the author's handle and verification, in the shared social schema. Bad input is free; not found or no match is not charged.

MCP tool: threads_posts.

ParameterRequiredDescription
handleyesA Threads handle (with or without @) or a threads.com/@handle URL.

Example request

curl -i 'https://social.duoleads.com/v1/threads/posts?handle=nasa'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "threads",
  "query": {
    "handle": "synthbrand"
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "post",
      "platform": "threads",
      "id": "3650000000000000001",
      "url": "https://www.threads.com/@synthbrand/post/SYNthr001",
      "created_at": "2026-10-04T05:50:31.000Z",
      "text": "Synthetic Threads post: we are testing a new feature",
      "author": {
        "handle": "synthbrand",
        "display_name": null,
        "verified": true,
        "followers": null
      },
      "metrics": {
        "likes": 964,
        "replies": 31,
        "reposts": 12,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null
    }
  ],
  "next_cursor": null,
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/facebook/ads ($0.02)

Facebook Ad Library Search: search the public Meta Ad Library by keyword for ads on Facebook and Instagram. Per ad the page name, ad text, active status, start and end dates, publisher platforms, call to action, landing link and media links in the shared social schema; next_cursor gives the next page. Competitor ad research. Bad input is free; not found or no match is not charged.

MCP tool: facebook_ads.

ParameterRequiredDescription
qyesSearch text (1-200 characters).
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/facebook/ads?q=running+shoes'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "facebook",
  "query": {
    "q": "synthetic shoes",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "ad",
      "platform": "facebook",
      "id": "1300000000000001",
      "url": "https://www.facebook.com/ads/library?id=1300000000000001",
      "created_at": "2026-10-13T00:00:00.000Z",
      "text": "Synthetic shoes, 60% off this week only.",
      "title": "Synthetic shoes",
      "author": {
        "handle": null,
        "display_name": "Synthetic Shop",
        "verified": null,
        "followers": 7
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [
        "https://scontent.xx.fbcdn.invalid/ad1.jpg"
      ],
      "parent_id": null,
      "link_url": "https://example.invalid/shoes",
      "ad": {
        "page_name": "Synthetic Shop",
        "is_active": true,
        "start_date": "2026-10-13T00:00:00.000Z",
        "end_date": "2026-10-14T00:00:00.000Z",
        "publisher_platforms": [
          "FACEBOOK",
          "INSTAGRAM"
        ],
        "cta_text": "Shop now",
        "link_url": "https://example.invalid/shoes"
      }
    }
  ],
  "next_cursor": "AQHRsyntheticcursor",
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/social/search ($0.025)

Social Search Across Platforms: one keyword search on Reddit and TikTok, plus X (Twitter) when its key is enabled, at once (choose 1-3), run in parallel. Posts and videos from every platform in one shared schema with text, author, likes, replies, reposts, views, time and URL; platforms_missing names any platform that failed (such a partial answer is charged), next_cursor continues every platform. Bad input is free; not found or no match is not charged.

MCP tool: social_search.

ParameterRequiredDescription
qyesSearch text (1-200 characters).
platformsnoComma-separated, 1-3 of x, reddit, tiktok. Default all three.
cursornonext_cursor of the previous page (asks only the platforms that have a next page).

Example request

curl -i 'https://social.duoleads.com/v1/social/search?q=open+source&platforms=reddit%2Ctiktok'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "multi",
  "query": {
    "q": "synthetic widgets",
    "platforms": [
      "reddit",
      "tiktok"
    ],
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "post",
      "platform": "reddit",
      "id": "synp001",
      "url": "https://www.reddit.com/r/SynthTech/comments/synp001/synthetic_post/",
      "created_at": "2026-10-14T00:00:00.000Z",
      "text": null,
      "title": "Is synthwidget worth it?",
      "author": {
        "handle": "synth_redditor_1",
        "display_name": null,
        "verified": null,
        "followers": null
      },
      "metrics": {
        "likes": 2204,
        "replies": 124,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null,
      "community": "SynthTech",
      "link_url": null
    },
    {
      "type": "post",
      "platform": "reddit",
      "id": "synp002",
      "url": "https://www.reddit.com/r/SynthTech/comments/synp002/synthetic_post/",
      "created_at": "2026-10-14T01:00:00.000Z",
      "text": null,
      "title": "synthwidget 2.0 first impressions",
      "author": {
        "handle": "synth_redditor_2",
        "display_name": null,
        "verified": null,
        "followers": null
      },
      "metrics": {
        "likes": 45,
        "replies": 12,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null,
      "community": "SynthTech",
      "link_url": null
    }
  ],
  "next_cursor": "eyJyZWRkaXQiOiJ0M19zeW5wMDAyIiwidGlrdG9rIjoiMTIifQ",
  "platforms": [
    "reddit",
    "tiktok"
  ],
  "platforms_missing": [],
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/social/audience ($0.02)

Audience & Engagement Stats: numbers only for one TikTok, Instagram, YouTube or Threads account, or X when its key is enabled: followers, following, posts, and the average likes, comments and views over its last 20 posts, with the engagement rate in percent. No follower names, no post text. Influencer vetting and benchmarking. Bad input is free; not found or no match is not charged.

MCP tool: social_audience.

ParameterRequiredDescription
platformyesOne of tiktok, instagram, x, youtube, threads. One of: tiktok, instagram, x, youtube, threads.
handleyesThe account's handle (with or without @) or its profile URL on that platform.

Example request

curl -i 'https://social.duoleads.com/v1/social/audience?platform=tiktok&handle=nasa'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "tiktok",
  "query": {
    "platform": "tiktok",
    "handle": "synthcreator"
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [],
  "next_cursor": null,
  "audience": {
    "followers": 44240,
    "following": 81,
    "posts": 213,
    "posts_sampled": 2,
    "avg_likes": 3000,
    "avg_comments": 30,
    "avg_views": 28496,
    "engagement_rate_pct": 6.849
  },
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/social/accounts ($0.02)

Creator & Brand Account Search: find creator and brand accounts on TikTok, Instagram or Threads by name or keyword. Only verified accounts or accounts with 10,000+ followers are returned (the rest counted in filtered_out); Threads search gives no follower counts and Instagram only for its first 10 results, so beyond those only verified accounts qualify. Per account the handle, name, bio, followers, following, posts and verification. Bad input is free; not found or no match is not charged.

MCP tool: social_accounts.

ParameterRequiredDescription
platformyesOne of tiktok, instagram, threads. One of: tiktok, instagram, threads.
qyesName or keyword to search accounts for (1-200 characters).
cursornonext_cursor of the previous page (TikTok only).

Example request

curl -i 'https://social.duoleads.com/v1/social/accounts?platform=tiktok&q=nasa'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "tiktok",
  "query": {
    "platform": "tiktok",
    "q": "synthetic widgets",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "profile",
      "platform": "tiktok",
      "id": "6000000000000000201",
      "url": "https://www.tiktok.com/@synth_big",
      "created_at": null,
      "text": null,
      "author": {
        "handle": "synth_big",
        "display_name": "Synthetic Big Creator",
        "verified": null,
        "followers": 163953
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [
        "https://p16.tiktokcdn.invalid/a/201.jpeg"
      ],
      "parent_id": null,
      "profile": {
        "following": 63,
        "posts": null,
        "likes_total": null
      }
    },
    {
      "type": "profile",
      "platform": "tiktok",
      "id": "6000000000000000203",
      "url": "https://www.tiktok.com/@synth_edge",
      "created_at": null,
      "text": null,
      "author": {
        "handle": "synth_edge",
        "display_name": "Synthetic Edge Creator",
        "verified": null,
        "followers": 10000
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null,
      "profile": {
        "following": 5,
        "posts": null,
        "likes_total": null
      }
    }
  ],
  "next_cursor": "30",
  "filtered_out": 1,
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/linkedin/company ($0.02)

LinkedIn Company Page Data: one LinkedIn company page by URL or page name: name, description, industry, size, employee count, headquarters, website, founding year, type, specialties and logo link, plus its recent posts (posts=1 adds the post feed with next_cursor). Company pages only, personal profiles are refused for free. B2B research. Bad input is free; not found or no match is not charged.

MCP tool: linkedin_company.

ParameterRequiredDescription
urlyesThe company: a LinkedIn company page URL (linkedin.com/company/<name>) or the company's page name; personal profiles (/in/) are not accepted.
postsno1 adds the page's post feed (one more vendor call). Default 0.
cursornonext_cursor of the previous page (with posts=1: the next feed page).

Example request

curl -i 'https://social.duoleads.com/v1/linkedin/company?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fmicrosoft%2F'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "linkedin",
  "query": {
    "url": "synthetic-widgets-inc",
    "posts": false,
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "company",
      "platform": "linkedin",
      "id": "7800001",
      "url": "https://www.linkedin.com/company/synthetic-widgets-inc/",
      "created_at": null,
      "text": "Synthetic Corp makes test fixtures.",
      "author": {
        "handle": "synthetic-widgets-inc",
        "display_name": "Synthetic Corp",
        "verified": null,
        "followers": null
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [
        "https://media.licdn.invalid/logo.png"
      ],
      "parent_id": null,
      "company": {
        "name": "Synthetic Corp",
        "industry": "Software Development",
        "size": "1,001-5,000 employees",
        "employee_count": 2359,
        "headquarters": "Nowhere, NA",
        "website": "https://example.invalid",
        "founded": 2006,
        "company_type": "Privately Held",
        "specialties": [
          "fixtures",
          "testing"
        ]
      }
    },
    {
      "type": "post",
      "platform": "linkedin",
      "id": "synthetic-corp_post-1",
      "url": "https://www.linkedin.com/posts/synthetic-corp_post-1",
      "created_at": "2026-10-01T15:17:41.770Z",
      "text": "We shipped synthetic fixtures.",
      "author": {
        "handle": "synthetic-widgets-inc",
        "display_name": "Synthetic Corp",
        "verified": null,
        "followers": null
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [],
      "parent_id": null
    }
  ],
  "next_cursor": null,
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/social/people ($0.02)

Social Profile People Search: search public TikTok, Instagram or Threads profiles by name or keyword, unfiltered. Per profile the handle, name, bio, followers, following, posts and verification in the shared social schema; next_cursor on TikTok. Bad input is free; not found or no match is not charged.

MCP tool: people_search.

ParameterRequiredDescription
platformyesOne of tiktok, instagram, threads. One of: tiktok, instagram, threads.
qyesName or keyword to search accounts for (1-200 characters).
cursornonext_cursor of the previous page (TikTok only).

Example request

curl -i 'https://social.duoleads.com/v1/social/people?platform=tiktok&q=open+source'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "tiktok",
  "query": {
    "platform": "tiktok",
    "q": "synthetic widgets",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "profile",
      "platform": "tiktok",
      "id": "6000000000000000201",
      "url": "https://www.tiktok.com/@synth_big",
      "created_at": null,
      "text": null,
      "author": {
        "handle": "synth_big",
        "display_name": "Synthetic Big Creator",
        "verified": null,
        "followers": 163953
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [
        "https://p16.tiktokcdn.invalid/a/201.jpeg"
      ],
      "parent_id": null,
      "profile": {
        "following": 63,
        "posts": null,
        "likes_total": null
      }
    },
    {
      "type": "profile",
      "platform": "tiktok",
      "id": "6000000000000000202",
      "url": "https://www.tiktok.com/@synth_small",
      "created_at": null,
      "text": null,
      "author": {
        "handle": "synth_small",
        "display_name": "Synthetic Small Creator",
        "verified": null,
        "followers": 9999
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [
        "https://p16.tiktokcdn.invalid/a/202.jpeg"
      ],
      "parent_id": null,
      "profile": {
        "following": 10,
        "posts": null,
        "likes_total": null
      }
    }
  ],
  "next_cursor": "30",
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/tiktok/followers ($0.02)

TikTok Followers List: the public followers of one TikTok account by handle, one page per call with next_cursor. Per follower the handle, name, bio, followers, following, posts and verification in the shared social schema. Bad input is free; not found or no match is not charged.

MCP tool: tiktok_followers.

ParameterRequiredDescription
handleyesA TikTok handle (with or without @) or a tiktok.com/@handle URL.
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/tiktok/followers?handle=nasa'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "tiktok",
  "query": {
    "handle": "synthcreator",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "profile",
      "platform": "tiktok",
      "id": "6000000000000000301",
      "url": "https://www.tiktok.com/@synth_follower_1",
      "created_at": null,
      "text": null,
      "author": {
        "handle": "synth_follower_1",
        "display_name": "Synthetic Follower One",
        "verified": null,
        "followers": 319
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [
        "https://p16.tiktokcdn.invalid/a/6000000000000000301.jpeg"
      ],
      "parent_id": null,
      "profile": {
        "following": 1375,
        "posts": null,
        "likes_total": null
      }
    }
  ],
  "next_cursor": "1791289478",
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/tiktok/following ($0.02)

TikTok Following List: the public accounts one TikTok account follows, by handle, one page per call with next_cursor. Per account the handle, name, bio, followers, following, posts and verification in the shared social schema. Bad input is free; not found or no match is not charged.

MCP tool: tiktok_following.

ParameterRequiredDescription
handleyesA TikTok handle (with or without @) or a tiktok.com/@handle URL.
cursornonext_cursor of the previous page.

Example request

curl -i 'https://social.duoleads.com/v1/tiktok/following?handle=nasa'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "tiktok",
  "query": {
    "handle": "synthcreator",
    "cursor": null
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "profile",
      "platform": "tiktok",
      "id": "6000000000000000401",
      "url": "https://www.tiktok.com/@synth_followed_1",
      "created_at": null,
      "text": null,
      "author": {
        "handle": "synth_followed_1",
        "display_name": "Synthetic Followed One",
        "verified": null,
        "followers": 2175
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [
        "https://p16.tiktokcdn.invalid/a/6000000000000000401.jpeg"
      ],
      "parent_id": null,
      "profile": {
        "following": 10,
        "posts": null,
        "likes_total": null
      }
    }
  ],
  "next_cursor": "1791010829",
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}

GET /v1/linkedin/profile ($0.02)

LinkedIn Profile Lookup: one public LinkedIn profile by linkedin.com/in/ URL: name, followers, about text and photo link in the shared social schema. Experience, education and contact data are not returned. Bad input is free; not found or no match is not charged.

MCP tool: linkedin_profile.

ParameterRequiredDescription
urlyesThe profile: a LinkedIn profile URL (linkedin.com/in/<name>).

Example request

curl -i 'https://social.duoleads.com/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fsynthetic-person%2F'

Example answer (200, illustrative: synthetic values, not this account's real data)

{
  "platform": "linkedin",
  "query": {
    "url": "synthetic-person"
  },
  "as_of": "2026-10-15T12:00:00.000Z",
  "complete": true,
  "items": [
    {
      "type": "profile",
      "platform": "linkedin",
      "id": "synthetic-person",
      "url": "https://www.linkedin.com/in/synthetic-person/",
      "created_at": null,
      "text": "A synthetic professional profile for tests.",
      "author": {
        "handle": "synthetic-person",
        "display_name": "Synthetic Professional",
        "verified": null,
        "followers": 6480
      },
      "metrics": {
        "likes": null,
        "replies": null,
        "reposts": null,
        "views": null
      },
      "lang": null,
      "media_urls": [
        "https://media.licdn.invalid/p.png"
      ],
      "parent_id": null,
      "profile": {
        "following": null,
        "posts": null,
        "likes_total": null
      }
    }
  ],
  "next_cursor": null,
  "source": "public data via third-party provider; not affiliated with the platform",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000"
}