EveryData platform API
Mastodon API
Across Mastodon, Mastodon federated accounts, public posts, hashtag feeds, trending statuses, and instance timelines are available through 5 separately documented actions, with `user_posts`, `profile`, `hashtag` illustrating the distinct request shapes.
Two early Mastodon scopes are `user_posts` for posts from a known account and `profile` for the selected Mastodon record, both using `username` to keep their objects and fields interpretable.
- Endpoint
- POST /api/v1/social
- Capabilities
- 5
- Per 1,000
- $1.389
Available capabilities
Compare the Mastodon actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
user_postsPosts by user Retrieve public posts from Mastodon. Accepts these parameters: | username | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform |
profileProfiles Retrieve public profile details from Mastodon. Accepts these parameters: | username | — | Sync delivery | — | $1.39 per 1,000 requests | username · display_name · handle · instance · url · platform |
hashtagHashtag Retrieve a public hashtag feed from Mastodon. Accepts these parameters: | hashtag | keyword, tag | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform |
trendingTrending Retrieve current trends from Mastodon. Requires no parameters. Returns these fields: | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform | |
timelineTimeline Use the | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform |
What does each Mastodon action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Mastodon user_posts parameters mean?
Retrieve public posts from Mastodon. Accepts these parameters: username. Returns these fields: author_username, text, like_count, and instance.
usernameRequired- Specifies the Mastodon account handle or full user@instance format, with an optional leading @ symbol. Providing a short handle without specifying an instance defaults to mastodon.social, and identical usernames across different instances represent distinct accounts.Mastodon WebFinger: Account Handles Require Domain ResolutionOfficial documentation explicitly states that @[email protected] and @[email protected] are distinct accounts, defined by both username and domain. This document clarifies account identification rules and does not imply that this gateway returns all official Account metadata.Checked
What do the Mastodon profile parameters mean?
Retrieve public profile details from Mastodon. Accepts these parameters: username. Returns these fields: handle, display_name, username, and instance.
usernameRequired- Specifies the Mastodon account handle or full user@instance format, with an optional leading @ symbol. Providing a short handle without specifying an instance defaults to mastodon.social, and identical usernames across different instances represent distinct accounts.Mastodon WebFinger: Account Handles Require Domain ResolutionOfficial documentation explicitly states that @[email protected] and @[email protected] are distinct accounts, defined by both username and domain. This document clarifies account identification rules and does not imply that this gateway returns all official Account metadata.Checked
What do the Mastodon hashtag parameters mean?
Retrieve a public hashtag feed from Mastodon. Accepts these parameters: hashtag, tag, and keyword. Returns these fields: author_name, is_reblog, author_url, and author_username.
hashtagRequired- Specifies the topic tag without the leading # to fetch the hashtag timeline on a target instance. Excludes boosts and replies, so it does not represent a complete sample of federated network tags.Mastodon: Hashtag Streams and Public Instance Preview LimitsOfficial documentation states that hashtag feeds retrieve public statuses containing a given tag, with tag paths excluding the # symbol; instance access is constrained when public previews are disabled. EveryInfra parameters for excluding Boosts/replies adhere to this page's contract rather than copying all official query keys.Checked
keywordOptional- Provides a tag compatibility input for the hashtag action rather than enabling open full-text search; public requests must still supply hashtag.
tagOptional- Provides a compatibility alias for hashtag, though hashtag takes precedence and remains mandatory in public requests. This parameter does not accept post IDs or account names.
What do the Mastodon trending parameters mean?
Retrieve current trends from Mastodon. Requires no parameters. Returns these fields: author_name, text, like_count, and language.
This action has no business parameters. Send only the platform and action identifiers.
What do the Mastodon timeline parameters mean?
Use the timeline action on Mastodon. Requires no parameters. Returns these fields: text, language, author_username, and author_url.
This action has no business parameters. Send only the platform and action identifiers.
How to use the Mastodon API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"mastodon","action":"user_posts","params":{"username":"<username>"}}'
Mastodon API questions
What can I retrieve with the Mastodon API?
Set platform to mastodon. The current catalog lists posts by user, profiles, hashtag, trending, and timeline. These action names identify different Mastodon objects or views; they are not interchangeable search modes.
Which input starts a Mastodon `user_posts` request?
Specifies the Mastodon account handle or full user@instance format, with an optional leading @ symbol. Providing a short handle without specifying an instance defaults to mastodon.social, and identical usernames across different instances represent distinct accounts. Send it as username inside params.
Which fields can Mastodon `user_posts` return?
Its declared schema includes text, author_name, author_username, and author_url. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Mastodon action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.