# Mastodon API

按 Mastodon 联邦账号、标签或实例公共时间线读取公开嘟文与轻量资料，区分 Favourite 与 Boost；不承诺完整联邦历史或账号元数据。

- Domain: social · 5 data actions
- Canonical page: https://everyinfra.com/mastodon-api
- Failures and empty results never form a final charge.

## Actions

### user_posts — 用户内容
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: username

- Optional: instance

- Returns fields: id, url, text, author_name, author_username, author_url, instance, like_count, reblog_count, comment_count, language, is_reblog, posted_at, platform, media_urls, hashtags

### profile — 主页或对象详情
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: username

- Optional: instance

- Returns fields: username, display_name, handle, instance, url, platform

### hashtag — 话题内容
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: hashtag

- Optional: instance

- Returns fields: id, url, text, author_name, author_username, author_url, instance, like_count, reblog_count, comment_count, language, is_reblog, posted_at, platform, media_urls, hashtags

### trending — 热榜
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: —

- Optional: instance

- Returns fields: id, url, text, author_name, author_username, author_url, instance, like_count, reblog_count, comment_count, language, is_reblog, posted_at, platform, media_urls, hashtags

### timeline — 时间线
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: —

- Optional: instance

- Returns fields: id, url, text, author_name, author_username, author_url, instance, like_count, reblog_count, comment_count, language, is_reblog, posted_at, platform, media_urls, hashtags

## Also

- Machine catalog (no key): https://everyinfra.com/openapi.json · GET /api/v1/social/catalog
- Agents guide: https://everyinfra.com/agents.md