# 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.

- Page: https://socialtoai.com/tools/batch-stats/
- Last updated: 2026-10-17

## What it takes

| 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. |

## What comes back

| 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. Every result states how much of the plan was read and which parts of the price were charged.

## Credits by platform

Each link is one row, priced as below:

| Platform | A post link | An account link |
| --- | --- | --- |
| TikTok | 2 | 2 |
| Instagram | 2 | 2 |
| X | 1 | 1 |
| Reddit | 2 | 2 |
| YouTube | 2 | 2 |
| Facebook | 2 | 2 |
| LinkedIn | 2 | 2 |
| Threads | 2 | 2 |
| Telegram | 2 | 2 |
| Xiaohongshu | 12 | 12 |
| Douyin | 2 | 2 |
| Weibo | 2 | 2 |
| WeChat Articles | 24 | 12 |
| Bilibili | 2 | 2 |
| Zhihu | 2 | 2 |
| Kuaishou | 2 | 12 |
| WeChat Channels | 12 | 12 |

## How credits are counted

- **Priced by the row**: Each link is one row, at what one call on its platform costs.
- **Dead rows are not charged**: A row that was deleted, not recognised or skipped is not charged. A row with numbers is, also when they are zero.
- **You see the most first**: Before it runs you get the most this list can cost. It never costs more.

## The result of one run (sample data)

**Bulk link data: 8 links (sample data)**

Done

6 read; 1 dead, 1 failed, 0 not recognised, 0 not run.

| # | Platform | Link | Views | Likes | Comments | Shares | Saves | Status | Credits |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 1 | TikTok | https://www.tiktok.com/@slowdrip.demo/video/7412000000000000011 | 318,000 | 41,200 | 1,204 | 3,870 | 12,600 | OK | 1 |
| 2 | TikTok | https://www.tiktok.com/@campcup.demo/video/7409000000000000012 | – | – | – | – | – | Dead link | 0 |
| 3 | Instagram | https://www.instagram.com/reel/DAq8sample01/ | 86,300 | 5,120 | 214 | 640 | – | OK | 1 |
| 4 | YouTube | https://www.youtube.com/shorts/sAmPLe7Kq2x | 152,000 | 7,940 | 388 | – | – | OK | 1 |
| 5 | X | https://x.com/ridgebrew_demo/status/1843120000000000001 | 41,700 | 1,380 | 96 | 212 | 540 | OK | 1 |
| 6 | Douyin | https://www.douyin.com/video/7410000000000000014 | – | – | – | – | – | Failed | 0 |
| 7 | Xiaohongshu | https://www.xiaohongshu.com/explore/66f0sample3a | – | 4,210 | 302 | 518 | 2,960 | OK | 10 |
| 8 | Instagram | https://www.instagram.com/campnotes.demo/ | – | – | – | – | – | OK | 1 |

### Bill

Charged 15 credits of 17 credits quoted. Only a row that came back is charged, also when its numbers are zero; dead, failed, unrecognised and unstarted rows are not.

## Use it in your AI

Connect https://mcp.socialtoai.com/mcp to your AI client as a remote MCP server ([how](https://socialtoai.com/mcp.md)), then ask:

> Use Bulk link data to get the current numbers for these links: [links]

MCP tool: `research` (with tool `batch_stats`).

## Call it from code

```bash
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"]
  }'
```

[Bulk link data in the docs](https://socialtoai.com/docs/tools/batch-stats.md)

## FAQ

**What 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.

## Other tools

- [Brand buzz](https://socialtoai.com/tools/brand-buzz.md): How people feel about it on each platform, what comes up most, and the posts behind it
- [Comment analysis](https://socialtoai.com/tools/comment-insights.md): The topics in their comments and how big each is, plus questions, buying intent and complaints
- [Account watch](https://socialtoai.com/tools/account-watch.md): What each one posted lately, and which posts beat its usual numbers
- [Find creators](https://socialtoai.com/tools/find-creators.md): Creators who make that content, with their size, recent posts and how well each fits
- [Creator profile](https://socialtoai.com/tools/creator-card.md): Their accounts on other platforms, the numbers on each, and how sure the match is
- [Viral finder](https://socialtoai.com/tools/viral-finder.md): Posts that did clearly better than their authors usually do