プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Mastodonの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
ユーザーの投稿user_posts | Mastodonアカウント1つの投稿を取得します。アカウントはハンドルまたはuser@instance形式でusernameに指定します。お気に入り・ブースト・返信数、言語、ブーストを示すフラグを取得できます。他のインスタンスにある同名のアカウントは別アカウントとして扱われます。全履歴の取得は保証されません。 | 1,000リクエストあたり$1.39 | 正常 |
プロフィールprofile | Mastodonのハンドルまたはuser@instance形式のアドレスから、1つのアカウントの表示名、完全なhandle、所属インスタンス、プロフィールリンクを取得します。ハンドルのみの場合は、instanceを指定しない限りmastodon.socialで検索されます。一致しても、意図したアカウントであるとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
ハッシュタグhashtag | Mastodonのハッシュタグに投稿された内容を閲覧します。ハッシュタグは#を付けずにhashtagに指定します。投稿者、本文、言語、メディアリンク、お気に入り・ブースト・返信数を取得できます。投稿は1つのインスタンスのタグタイムラインから取得され、ブーストされた投稿と返信投稿は含まれないため、連合全体の会話を測るものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
トレンドtrending | Mastodonインスタンスでトレンドになっている投稿を取得します。instanceで別のインスタンスを指定しない限り、mastodon.socialが対象です。各投稿には投稿者、本文、言語、メディア、お気に入り・ブースト・返信数が含まれます。順位と数値は呼び出し時点のものです。トレンドのアルゴリズムの説明や、Fediverse全体のランキングは含まれません。 | 1,000リクエストあたり$1.39 | 正常 |
タイムラインtimeline | Mastodonインスタンスの公開タイムラインを取得します。デフォルトはfosstodon.orgです。各投稿には投稿者、本文、言語、メディアリンク、お気に入り・ブースト・返信数が含まれます。ログインした個人のフィードではなく、Mastodon全体のアーカイブでもありません。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Mastodonの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
user_postsユーザーの投稿 Mastodonアカウント1つの投稿を取得します。アカウントはハンドルまたはuser@instance形式で | username | instance | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | 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プロフィール Mastodonのハンドルまたはuser@instance形式のアドレスから、1つのアカウントの表示名、完全な | username | instance | Sync配信 | — | 1,000リクエストあたり$1.39 | username · display_name · handle · instance · url · platform |
hashtagハッシュタグ Mastodonのハッシュタグに投稿された内容を閲覧します。ハッシュタグは#を付けずに | hashtag | instance | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | 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トレンド Mastodonインスタンスでトレンドになっている投稿を取得します。 | instance | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | 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タイムライン Mastodonインスタンスの公開タイムラインを取得します。デフォルトはfosstodon.orgです。各投稿には投稿者、本文、言語、メディアリンク、お気に入り・ブースト・返信数が含まれます。ログインした個人のフィードではなく、Mastodon全体のアーカイブでもありません。 | instance | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | 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 |
Mastodonのuser_postsのパラメータはそれぞれどういう意味ですか？
Mastodonアカウント1つの投稿を取得します。アカウントはハンドルまたはuser@instance形式でusernameに指定します。お気に入り・ブースト・返信数、言語、ブーストを示すフラグを取得できます。他のインスタンスにある同名のアカウントは別アカウントとして扱われます。全履歴の取得は保証されません。
username必須- Mastodonのアカウントハンドル、またはuser@instance形式の完全なアカウント名を指定します。先頭の@は任意です。インスタンスを指定せずに短いハンドルを入力した場合は、mastodon.socialが使われます。異なるインスタンス上の同じユーザー名は、別々のアカウントとして扱われます。Mastodon WebFinger：アカウントハンドルにはドメインの解決が必要 — 公式ドキュメントでは、@user
@example.comと@user @example.orgは別のアカウントであり、アカウントはユーザー名とドメインの両方で定義されると明記しています。このドキュメントはアカウントの識別ルールを明確にするものであり、このゲートウェイが公式のAccountメタデータをすべて返すことを意味するものではありません。 · 確認日 instance任意- Mastodonインスタンスのドメインを、スキームやパスを含めずに指定します。デフォルトはtimelineアクションがfosstodon.org、ほかのアクションがmastodon.socialです。明示的に指定したinstanceはusernameに含まれるドメインより優先されるため、2つの値をそろえてください。
Mastodonのprofileのパラメータはそれぞれどういう意味ですか？
Mastodonのハンドルまたはuser@instance形式のアドレスから、1つのアカウントの表示名、完全なhandle、所属インスタンス、プロフィールリンクを取得します。ハンドルのみの場合は、instanceを指定しない限りmastodon.socialで検索されます。一致しても、意図したアカウントであるとは限りません。
username必須- Mastodonのアカウントハンドル、またはuser@instance形式の完全なアカウント名を指定します。先頭の@は任意です。インスタンスを指定せずに短いハンドルを入力した場合は、mastodon.socialが使われます。異なるインスタンス上の同じユーザー名は、別々のアカウントとして扱われます。Mastodon WebFinger：アカウントハンドルにはドメインの解決が必要 — 公式ドキュメントでは、@user
@example.comと@user @example.orgは別のアカウントであり、アカウントはユーザー名とドメインの両方で定義されると明記しています。このドキュメントはアカウントの識別ルールを明確にするものであり、このゲートウェイが公式のAccountメタデータをすべて返すことを意味するものではありません。 · 確認日 instance任意- Mastodonインスタンスのドメインを、スキームやパスを含めずに指定します。デフォルトはtimelineアクションがfosstodon.org、ほかのアクションがmastodon.socialです。明示的に指定したinstanceはusernameに含まれるドメインより優先されるため、2つの値をそろえてください。
Mastodonのhashtagのパラメータはそれぞれどういう意味ですか？
Mastodonのハッシュタグに投稿された内容を閲覧します。ハッシュタグは#を付けずにhashtagに指定します。投稿者、本文、言語、メディアリンク、お気に入り・ブースト・返信数を取得できます。投稿は1つのインスタンスのタグタイムラインから取得され、ブーストされた投稿と返信投稿は含まれないため、連合全体の会話を測るものではありません。
hashtag必須- 対象インスタンスのハッシュタグタイムラインを取得するためのトピックタグを、先頭の#なしで指定します。ブーストと返信は除外されるため、連合ネットワーク全体のタグを網羅したサンプルにはなりません。Mastodon：ハッシュタグのストリームとインスタンスの公開プレビューの制限 — 公式ドキュメントによると、ハッシュタグフィードは指定したタグを含む公開ステータスを取得し、タグのパスには#記号を含めません。また、公開プレビューが無効なインスタンスではアクセスが制限されます。ブーストや返信を除外するEveryInfraのパラメータはこのページに記載されているものであり、公式のクエリキーをすべて再現したものではありません。 · 確認日
instance任意- Mastodonインスタンスのドメインを、スキームやパスを含めずに指定します。デフォルトはtimelineアクションがfosstodon.org、ほかのアクションがmastodon.socialです。明示的に指定したinstanceはusernameに含まれるドメインより優先されるため、2つの値をそろえてください。
Mastodonのtrendingのパラメータはそれぞれどういう意味ですか？
Mastodonインスタンスでトレンドになっている投稿を取得します。instanceで別のインスタンスを指定しない限り、mastodon.socialが対象です。各投稿には投稿者、本文、言語、メディア、お気に入り・ブースト・返信数が含まれます。順位と数値は呼び出し時点のものです。トレンドのアルゴリズムの説明や、Fediverse全体のランキングは含まれません。
instance任意- Mastodonインスタンスのドメインを、スキームやパスを含めずに指定します。デフォルトはtimelineアクションがfosstodon.org、ほかのアクションがmastodon.socialです。明示的に指定したinstanceはusernameに含まれるドメインより優先されるため、2つの値をそろえてください。
Mastodonのtimelineのパラメータはそれぞれどういう意味ですか？
Mastodonインスタンスの公開タイムラインを取得します。デフォルトはfosstodon.orgです。各投稿には投稿者、本文、言語、メディアリンク、お気に入り・ブースト・返信数が含まれます。ログインした個人のフィードではなく、Mastodon全体のアーカイブでもありません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況instance任意- Mastodonインスタンスのドメインを、スキームやパスを含めずに指定します。デフォルトはtimelineアクションがfosstodon.org、ほかのアクションがmastodon.socialです。明示的に指定したinstanceはusernameに含まれるドメインより優先されるため、2つの値をそろえてください。
Mastodon APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
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に関する質問
Mastodon APIでは何を取得できますか？
platformをmastodonに設定します。現在のカタログにはユーザーの投稿、プロフィール、ハッシュタグ、トレンド、タイムラインが掲載されています。これらのアクション名はそれぞれ異なるMastodonのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Mastodonのuser_postsリクエストを開始するには、どの入力を使用しますか？
Mastodonのアカウントハンドル、またはuser@instance形式の完全なアカウント名を指定します。先頭の@は任意です。インスタンスを指定せずに短いハンドルを入力した場合は、mastodon.socialが使われます。異なるインスタンス上の同じユーザー名は、別々のアカウントとして扱われます。params内のusernameとして送信してください。
Mastodonのuser_postsはどのフィールドを返しますか？
宣言されたスキーマにはtext、author_name、author_username、author_urlが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Mastodonのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。