Mastodon post API
One request, one key: POST /v1/social/mastodon/post. The sample below is a real response captured 20 November 2026, shortened for display (long text cut, lists cut to three items); it is not invented.
Price
2 credits a call. One call is about $0.0196 and 1,000 calls are about $19.60 at the smallest paid plan's rate.Formula A call that comes back empty is not charged.
Try it free
Runs one real call with the sample input below. No key and no sign-up; a few runs a day per visitor.
{
"url": "https://mastodon.social/@Gargron/117621282276303009"
}
What it returns
| Field | Type | Value in the sample |
|---|---|---|
url | string | https://mastodon.social/@Gargron/117621282276303009 |
platform | string | mastodon |
extracted_at | string | 2026-11-20T10:21:42.484388+00:00 |
text | string | #SilentSunday |
title | string | #SilentSunday |
author_name | string | Eugen Rochko |
author_handle | string | Gargron |
author_url | string | https://mastodon.social/@Gargron |
author_avatar | string | https://files.mastodon.social/accounts/avatars/000/000/001/original/6b2384b33799a0dd.png |
author_followers | number | 381405 |
author_verified | boolean | true |
published_at | string | 2026-11-15T15:58:55.527Z |
date_source | string | mastodon_api |
likes | number | 251 |
comments_count | number | 2 |
reposts | number | 59 |
images | list | ["https://files.mastodon.social/media_attachments/files/117/621/278/656/194/255/original/c98cef895898a060.j... |
content_type | string | post |
hashtags | list | ["silentsunday"] |
extras | object | {"instance":"mastodon.social","status_id":"117621282276303009","spoiler_text":"","sensitive":false,"visibil... |
credits_used | number | 2 |
latency_ms | number | 364 |
Sample response (20 November 2026)
{
"url": "https://mastodon.social/@Gargron/117621282276303009",
"platform": "mastodon",
"extracted_at": "2026-11-20T10:21:42.484388+00:00",
"text": "#SilentSunday",
"title": "#SilentSunday",
"description": null,
"author_name": "Eugen Rochko",
"author_handle": "Gargron",
"author_url": "https://mastodon.social/@Gargron",
"author_avatar": "https://files.mastodon.social/accounts/avatars/000/000/001/original/6b2384b33799a0dd.png",
"author_followers": 381405,
"author_verified": true,
"published_at": "2026-11-15T15:58:55.527Z",
"published_at_unix": null,
"modified_at": null,
"date_source": "mastodon_api",
"likes": 251,
"comments_count": 2,
"shares": null,
"views": null,
"reposts": 59,
"saves": null,
"thumbnail_url": null,
"video_url": null,
"images": [
"https://files.mastodon.social/media_attachments/files/117/621/278/656/194/255/original/c98cef895898a060.jpeg"
],
"content_type": "post",
"hashtags": [
"silentsunday"
],
"mentions": [],
"language": null,
"extras": {
"instance": "mastodon.social",
"status_id": "117621282276303009",
"spoiler_text": "",
"sensitive": false,
"visibility": "public",
"language": "en",
"media_attachments": [
{
"type": "image",
"url": "https://files.mastodon.social/media_attachments/files/117/621/278/656/194/255/original/c98cef895898a060.jpeg",
"description": "A pier on a lake. Boats parked on water. Mountains disappearing in mist. "
}
],
"poll": null,
"mentions": [],
"reblog": false
},
"errors": [],
"credits_used": 2,
"latency_ms": 364
}
Measured on that call: 937 ms.
Code
curl -X POST https://api.foxapis.com/v1/social/mastodon/post \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://mastodon.social/@Gargron/117621282276303009"}'n8n (HTTP Request node: paste it into a workflow)
{
"nodes": [
{
"name": "Mastodon post",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4,
"position": [
0,
0
],
"parameters": {
"method": "POST",
"url": "https://api.foxapis.com/v1/social/mastodon/post",
"sendHeaders": true,
"headerParameters": {
"parameters": [
{
"name": "Authorization",
"value": "Bearer YOUR_KEY"
}
]
},
"sendBody": true,
"specifyBody": "json",
"jsonBody": "{\"url\":\"https://mastodon.social/@Gargron/117621282276303009\"}"
}
}
],
"connections": {}
}Assistants (Claude, ChatGPT, Cursor)
Connect the FoxAPIs server once; the tools it offers are listed on the MCP page.
claude mcp add --transport http foxapis https://foxapis.com/mcp \ --header "Authorization: Bearer YOUR_KEY"
Errors and limits
- 401: the key is missing or wrong.
- 402: out of credits; top up on the pricing page.
- 422: the input does not match; the answer names the field.
- 429: too many calls too fast; wait a moment and try again.
- 503: the source did not answer; nothing is charged. Live state: status.
Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.
Get my free keyTry it free, no key: Buying intent checker
Same category: Social posts and channels · all APIs
How we calculate
- Price of one call and of 1,000 calls: The credits per call times the smallest paid plan's price per credit (its monthly price divided by its monthly credits), times 1,000 for the larger figure.
Data: scripts/data/endpoint-credits.json and plans.json, 2026-11-20. Every other figure on this page is copied from the record, not calculated by us.