Bulk link data: bulk post and profile metrics
Bulk link data is a ready-made SocialToAI tool that returns the numbers of up to 2,000 links to posts or account pages as they are now, and which links no longer work. No AI analysis. It costs from 1 credit per link, the most a list can cost is stated before it runs, and a dead link is not charged. Run it here, in your AI over MCP, or over the API.
Last updated:
- 1tiktok.com/@slowdrip.demo/video/7…2
- 2tiktok.com/@campcup.demo/video/74…2
- 3instagram.com/reel/DAq8sample01/2
- 4youtube.com/shorts/sAmPLe7Kq2x2
- 5x.com/ridgebrew_demo/status/18431…1
- 6douyin.com/video/7410000000000000…2
- 7xiaohongshu.com/explore/66f0sampl…12
- 8instagram.com/campnotes.demo/2
It was deleted or set to private. That row is not charged.
Numbers are what each platform showed when the link was read; a dash means it does not show that number. A link that reads fine and shows zeros is charged.
- Each link is read once, as one call on its platform. No link is retried on its own.
- The job runs in waves of 50 rows. When more than three in ten rows of it have failed, no new wave is started.
- The full result is kept for 24 hours after the job ends. Export it to keep it.
How credits are counted.
By the row, with the most stated first.
- Dead links are not charged
- Credits never expire
What it takes.
What comes back.
| Name | Type | Required | What it is |
|---|---|---|---|
urls | string[] | Yes | 1 to 2,000 links to posts or account pages; they may be of different platforms. |
max_cost_credits | integer | No | Refused, free, with the quote, if the run would cost more. |
confirm | boolean | No | true: run it whatever it costs. false: answer the plan and its price, and run nothing. Left out: a costly run, and one that runs in the background, answers its price first. |
| Part | What it holds |
|---|---|
| One row per link | The numbers of each link as they are now. |
| Links that no longer work | Links that were deleted or could not be recognised. These rows are not charged. |
| Main number | Engagement of the links that work |
Same tool, where you already work.
Ask your AI, or call it from code.
Connect SocialToAI once over MCP. After that, ask in plain words and your AI runs the tool for you.
https://mcp.socialtoai.com/mcpresearchwith tool batch_statsOne POST request returns the same result. Send max_cost_credits, and a run that would cost more is refused for free, with the quote.
curl https://api.socialtoai.com/v1/tools/batch_stats \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "urls": ["https://x.com/NASA"] }'import osimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/tools/batch_stats", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "urls": ["https://x.com/NASA"], },)print(response.json())Before you run it.
Short answers.
Read the docsWhat does a run cost?
Each link is one row, at what one call on its platform costs: from 1 credit a row. The table on this page lists every platform. Before it runs you get the most the list can cost, and it never costs more.
What am I charged for dead links, or if I cancel?
A row whose link was deleted, could not be recognised or was skipped is not charged. A row that comes back with numbers is charged, also when the numbers are zero. If you cancel, rows that already finished stay charged and the rest are not.
What happens when a platform fails?
The rows on that platform that fail are not charged, and the other rows are not affected. When more than three in ten rows of a batch fail, the rest of the list is not started.
Which platforms does it cover?
17 platforms now: TikTok, Instagram, X, Reddit, YouTube, Facebook, LinkedIn, Threads, Telegram, Xiaohongshu, Douyin, Weibo, WeChat Articles, Bilibili, Zhihu, Kuaishou, WeChat Channels. The links you give may be of different platforms.
Can I run it on the free credits?
No. Bulk link data is available after your first purchase, and so is running a tool on a schedule.