> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/mastodon/profiles-batch>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/mastodon/profiles-batch.mdx>

---

# Mastodon Profiles Batch API

Up to 40 account ids from one server in one request, with the missing ones named.

`GET /v1/mastodon/profiles/batch?host=mastodon.social&ids=1,13179` takes one server and a comma-separated list of account ids from that server. It returns `data.accounts` with full account records and `data.missingIds` for the requested ids the server did not return. Ids are local: account `1` on `mastodon.social` is a different account from `1` anywhere else.

The route accepts 1 to 40 ids and does not page. Use it to hydrate ids collected from search, a follower list or a batch of posts without one request per account. A deleted or suspended account, or an id that never existed, appears in `missingIds` rather than as an error.

## Request

- **Endpoint:** `GET /v1/mastodon/profiles/batch`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by ids
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/mastodon/profiles/batch/get)
- **Platform page:** [/platforms/mastodon](https://www.socialfetch.dev/platforms/mastodon)

## FAQ

### How do I pass the ids?

Send host with the server name and ids as a comma-separated list, for example ids=1,13179. Between 1 and 40 ids are accepted, and duplicates are rejected.

### How many credits does one batch cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

### Why is an id in missingIds?

The server did not return it: the account was deleted, is suspended, or the id never existed there. missingIds is the only signal because the server does not explain each id.

### Can I mix ids from different servers?

No. One request asks one host. Send one batch per server, because account ids are local to the server that issued them.