Get Mastodon Profile

PythonSocial Media

POST api.upapi.io/mastodon-profile.get

Look up a Mastodon account by fully-qualified handle (e.g. Gargron@mastodon.social). Works against any Mastodon instance via its open REST API - no auth needed.

mastodonfediversesocialpython

AuthAPI key

Cost1 unit

Timeout15s

Cache60s

Request schema

Field	Type	Description
`handle`req	string	Fully-qualified Mastodon handle, e.g. "Gargron@mastodon.social"

Response schema

Field	Type	Description
`id`req	string
`bot`req	boolean
`url`req	string
`acct`req	string
`note`req	string
`group`req	boolean
`avatar`req
`header`req
`locked`req	boolean
`instance`req	string
`username`req	string
`createdAt`req
`fetchedAt`req	string
`displayName`req	string
`discoverable`req
`lastStatusAt`req
`statusesCount`req	integer
`followersCount`req	integer
`followingCount`req	integer

Try it

handlerequired

Fully-qualified Mastodon handle, e.g. "Gargron@mastodon.social"

Run this endpoint live

Jump in as a guest — no signup — and run mastodon-profile.get with your own inputs. Create a free account anytime to get your own API key.

Code examples

curl -X POST https://api.upapi.io/mastodon-profile.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "handle": "Gargron@mastodon.social" }'

Developer tools

OpenAPI specImport the spec or collection into Postman, Insomnia, or any codegen tool.