Home · APIs · Social posts and channels · Mastodon post

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

FieldTypeValue in the sample
urlstringhttps://mastodon.social/@Gargron/117621282276303009
platformstringmastodon
extracted_atstring2026-11-20T10:21:42.484388+00:00
textstring#SilentSunday
titlestring#SilentSunday
author_namestringEugen Rochko
author_handlestringGargron
author_urlstringhttps://mastodon.social/@Gargron
author_avatarstringhttps://files.mastodon.social/accounts/avatars/000/000/001/original/6b2384b33799a0dd.png
author_followersnumber381405
author_verifiedbooleantrue
published_atstring2026-11-15T15:58:55.527Z
date_sourcestringmastodon_api
likesnumber251
comments_countnumber2
repostsnumber59
imageslist["https://files.mastodon.social/media_attachments/files/117/621/278/656/194/255/original/c98cef895898a060.j...
content_typestringpost
hashtagslist["silentsunday"]
extrasobject{"instance":"mastodon.social","status_id":"117621282276303009","spoiler_text":"","sensitive":false,"visibil...
credits_usednumber2
latency_msnumber364

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"}'
import requests

r = requests.post(
    "https://api.foxapis.com/v1/social/mastodon/post",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={"url":"https://mastodon.social/@Gargron/117621282276303009"},
)
print(r.json())
const r = await fetch("https://api.foxapis.com/v1/social/mastodon/post", {
  method: "POST",
  headers: { "Authorization": "Bearer YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({"url":"https://mastodon.social/@Gargron/117621282276303009"}),
});
console.log(await r.json());

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

Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.

Get my free key

Try it free, no key: Buying intent checker

Same category: Social posts and channels · all APIs

How we calculate

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.