当社独自のアクセス統計は常に有効です。Google Analyticsは、公開ページ(ログイン後のワークスペースは対象外)の利用状況を把握するためのもので、許可をいただいた場合のみ有効になります。詳しくは プライバシーポリシーをご覧ください。

Lemmy API

キーワード、コミュニティ、インスタンスのタイムラインのいずれかを使って、Lemmyの投稿とネストされたコメントを取得します。

クエリごとに対象インスタンスのドメインを指定してください。連合しているすべてのインスタンスを網羅することは保証されません。

プラットフォームの稼働状況

24時間の稼働状況
正常
正常

過去30日間

利用可能な機能

Lemmyの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。

機能できること1,000リクエストあたり24時間の稼働状況
検索search1つのインスタンス上のLemmyの投稿をkeywordで検索します。コミュニティ、投稿者、スコア、賛成票と反対票、コメント数、外部リンク、NSFW・ロック・注目のフラグを取得できます。検索は選択したinstance(デフォルトはlemmy.world)で実行され、Fediverse全体は対象になりません。1,000リクエストあたり$1.39正常
コミュニティcommunity名前またはname@instance形式で指定したLemmyコミュニティの投稿を取得します。スコア、投票数、コメント数、リンク、投稿フラグを取得でき、デフォルトではhot順に並びます。他のインスタンスにある同名のコミュニティは統合されません。top_rangeはtopで並べ替えた場合にのみ適用されます。1,000リクエストあたり$1.39正常
ニュースフィードfeedLemmyインスタンス(デフォルトはlemmy.world)の投稿フィードを閲覧します。各投稿にはコミュニティ、スコア、投票数、コメント数、フラグが含まれ、デフォルトではアクティビティ順に並びます。パーソナライズされたタイムラインでも、Fediverse全体を網羅したものでもありません。1,000リクエストあたり$1.39正常
コメントcommentsLemmyコミュニティの投稿からコメントを取得します。スコア、投票数、階層の深さ、親コメントID、削除フラグ、各コメントが属する投稿が含まれます。max_commentsはリクエスト全体ではなく投稿ごとのコメント数の上限で、1〜200の範囲で指定でき、デフォルトは50です。1,000リクエストあたり$1.39正常

機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。

Lemmyの各アクションではどのような入力を指定できますか?

以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。

公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。

アクション必須任意提供方式上限1,000件あたりレスポンスフィールド
search

検索

1つのインスタンス上のLemmyの投稿をkeywordで検索します。コミュニティ、投稿者、スコア、賛成票と反対票、コメント数、外部リンク、NSFW・ロック・注目のフラグを取得できます。検索は選択したinstance(デフォルトはlemmy.world)で実行され、Fediverse全体は対象になりません。

keywordinstance, sort, top_rangeSync配信カタログ値:defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$1.39id · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform
community

コミュニティ

名前またはname@instance形式で指定したLemmyコミュニティの投稿を取得します。スコア、投票数、コメント数、リンク、投稿フラグを取得でき、デフォルトではhot順に並びます。他のインスタンスにある同名のコミュニティは統合されません。top_rangeはtopで並べ替えた場合にのみ適用されます。

communityinstance, sort, top_rangeSync配信カタログ値:defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$1.39id · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform
feed

ニュースフィード

Lemmyインスタンス(デフォルトはlemmy.world)の投稿フィードを閲覧します。各投稿にはコミュニティ、スコア、投票数、コメント数、フラグが含まれ、デフォルトではアクティビティ順に並びます。パーソナライズされたタイムラインでも、Fediverse全体を網羅したものでもありません。

instance, sort, top_rangeSync配信カタログ値:defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$1.39id · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform
comments

コメント

Lemmyコミュニティの投稿からコメントを取得します。スコア、投票数、階層の深さ、親コメントID、削除フラグ、各コメントが属する投稿が含まれます。max_commentsはリクエスト全体ではなく投稿ごとのコメント数の上限で、1〜200の範囲で指定でき、デフォルトは50です。

communityinstance, max_comments, sort, top_rangeSync配信カタログ値:defaultLimit=10、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$1.39id · text · author_username · author_url · score · upvote_count · downvote_count · depth · parent_comment_id · is_deleted · post_url · post_title · community · posted_at · platform

Lemmyのsearchのパラメータはそれぞれどういう意味ですか?

1つのインスタンス上のLemmyの投稿をkeywordで検索します。コミュニティ、投稿者、スコア、賛成票と反対票、コメント数、外部リンク、NSFW・ロック・注目のフラグを取得できます。検索は選択したinstance(デフォルトはlemmy.world)で実行され、Fediverse全体は対象になりません。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
keyword必須
Lemmyのsearchアクションで使用する検索語を指定します。検索は指定したインスタンス上で実行され、連合しているすべてのインスタンスを網羅した検索は保証されません。
Lemmy:インスタンスの可視範囲とFediverse全体の違い — 公式の入門ガイドでは、インスタンスはそれぞれ別の運営者が管理しており、通常の閲覧ではローカルインスタンスが認識しているコミュニティのみが表示され、他インスタンスのオブジェクトは別途解決する必要があると説明しています。この説明はインスタンスごとの視点と投稿オブジェクトを理解するためのものであり、Web検索の機能全体をゲートウェイのパラメータに反映するものではありません。 · 確認日
instance任意
Lemmyインスタンスのドメインを選択します(例:lemmy.world。デフォルトもlemmy.worldです)。インスタンスの完全なURLも受け付けますが、ホスト名のみが使用されます。クエリの起点となるインスタンスを選ぶもので、コミュニティ名を指定するものではありません。
sort任意
投稿の並び順をhot、active、new、top、most_comments、new_commentsのいずれかで指定します。デフォルトはsearchとcommunityがhot、feedがactive、commentsがmost_commentsです。
指定可能な値:activehotmost_commentsnewnew_commentstop
top_range任意
sortがtopの場合にのみ、スコアの集計期間を設定します。指定できる値はhour、sixhour、twelvehour、day、week(デフォルト)、month、threemonths、sixmonths、ninemonths、year、allです。コメントの公開日によるフィルターではありません。
指定可能な値:alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear

Lemmyのcommunityのパラメータはそれぞれどういう意味ですか?

名前またはname@instance形式で指定したLemmyコミュニティの投稿を取得します。スコア、投票数、コメント数、リンク、投稿フラグを取得でき、デフォルトではhot順に並びます。他のインスタンスにある同名のコミュニティは統合されません。top_rangeはtopで並べ替えた場合にのみ適用されます。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
community必須
コミュニティ名、またはname@instance形式のインスタンス横断識別子を指定します。communityアクションでは、コミュニティの投稿を一覧表示します。commentsアクションでは、単一の投稿URLを直接照会するのではなく、コミュニティから投稿を取得してそのコメントを展開します。
Lemmy:コミュニティ識別子とインスタンス間のアクセス — 公式ガイドでは、コミュニティURLと!name@instance形式の識別子を示し、ローカルコミュニティと連合コミュニティを区別しています。EveryInfraではこのパラメータをnameまたはname@instanceと定めています。公式UIで使われる!プレフィックスやURL形式は、このインターフェースでは自動的にはサポートされません。 · 確認日
instance任意
Lemmyインスタンスのドメインを選択します(例:lemmy.world。デフォルトもlemmy.worldです)。インスタンスの完全なURLも受け付けますが、ホスト名のみが使用されます。クエリの起点となるインスタンスを選ぶもので、コミュニティ名を指定するものではありません。
sort任意
投稿の並び順をhot、active、new、top、most_comments、new_commentsのいずれかで指定します。デフォルトはsearchとcommunityがhot、feedがactive、commentsがmost_commentsです。
指定可能な値:activehotmost_commentsnewnew_commentstop
top_range任意
sortがtopの場合にのみ、スコアの集計期間を設定します。指定できる値はhour、sixhour、twelvehour、day、week(デフォルト)、month、threemonths、sixmonths、ninemonths、year、allです。コメントの公開日によるフィルターではありません。
指定可能な値:alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear

Lemmyのfeedのパラメータはそれぞれどういう意味ですか?

Lemmyインスタンス(デフォルトはlemmy.world)の投稿フィードを閲覧します。各投稿にはコミュニティ、スコア、投票数、コメント数、フラグが含まれ、デフォルトではアクティビティ順に並びます。パーソナライズされたタイムラインでも、Fediverse全体を網羅したものでもありません。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
instance任意
Lemmyインスタンスのドメインを選択します(例:lemmy.world。デフォルトもlemmy.worldです)。インスタンスの完全なURLも受け付けますが、ホスト名のみが使用されます。クエリの起点となるインスタンスを選ぶもので、コミュニティ名を指定するものではありません。
sort任意
投稿の並び順をhot、active、new、top、most_comments、new_commentsのいずれかで指定します。デフォルトはsearchとcommunityがhot、feedがactive、commentsがmost_commentsです。
指定可能な値:activehotmost_commentsnewnew_commentstop
top_range任意
sortがtopの場合にのみ、スコアの集計期間を設定します。指定できる値はhour、sixhour、twelvehour、day、week(デフォルト)、month、threemonths、sixmonths、ninemonths、year、allです。コメントの公開日によるフィルターではありません。
指定可能な値:alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear

Lemmyのcommentsのパラメータはそれぞれどういう意味ですか?

Lemmyコミュニティの投稿からコメントを取得します。スコア、投票数、階層の深さ、親コメントID、削除フラグ、各コメントが属する投稿が含まれます。max_commentsはリクエスト全体ではなく投稿ごとのコメント数の上限で、1〜200の範囲で指定でき、デフォルトは50です。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
community必須
コミュニティ名、またはname@instance形式のインスタンス横断識別子を指定します。communityアクションでは、コミュニティの投稿を一覧表示します。commentsアクションでは、単一の投稿URLを直接照会するのではなく、コミュニティから投稿を取得してそのコメントを展開します。
instance任意
Lemmyインスタンスのドメインを選択します(例:lemmy.world。デフォルトもlemmy.worldです)。インスタンスの完全なURLも受け付けますが、ホスト名のみが使用されます。クエリの起点となるインスタンスを選ぶもので、コミュニティ名を指定するものではありません。
max_comments任意
commentsアクションで投稿ごとに取得するコメントの最大数を設定します。デフォルトは50で、指定できる範囲は1〜200です。リクエスト全体の投稿数やコメント総数ではなく、投稿ごとのコメント数を制限します。範囲外の値は自動的に範囲内に収められます。
Lemmy:ネストされたコメント階層と上限の扱い — 公式ドキュメントでは、トップレベルのコメント、ネストされた返信の階層、スコアの計算方法(高評価数から低評価数を引いた値)を説明しています。EveryInfraの投稿あたりのコメント上限は当社独自の設定であり、公式の並べ替えオプションではありません。上限に達しても、すべての親ノードと子ノードが含まれることは保証されません。 · 確認日
sort任意
投稿の並び順をhot、active、new、top、most_comments、new_commentsのいずれかで指定します。デフォルトはsearchとcommunityがhot、feedがactive、commentsがmost_commentsです。
指定可能な値:activehotmost_commentsnewnew_commentstop
top_range任意
sortがtopの場合にのみ、スコアの集計期間を設定します。指定できる値はhour、sixhour、twelvehour、day、week(デフォルト)、month、threemonths、sixmonths、ninemonths、year、allです。コメントの公開日によるフィルターではありません。
指定可能な値:alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear

Lemmy APIの使い方

  1. 01公開カタログからプラットフォームのアクションを選択します。
  2. 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
  3. 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
  4. 04アプリケーションで必要なレスポンスフィールドを保存します。
lemmy_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"lemmy","action":"search","params":{"keyword":"<keyword>"}}'

Lemmy APIに関する質問

Lemmy APIでは何を取得できますか?

platformをlemmyに設定します。現在のカタログには検索、コミュニティ、ニュースフィード、コメントが掲載されています。これらのアクション名はそれぞれ異なるLemmyのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。

Lemmyのsearchリクエストを開始するには、どの入力を使用しますか?

Lemmyのsearchアクションで使用する検索語を指定します。検索は指定したインスタンス上で実行され、連合しているすべてのインスタンスを網羅した検索は保証されません。params内のkeywordとして送信してください。

Lemmyのsearchはどのフィールドを返しますか?

宣言されたスキーマにはtitle、body、external_url、communityが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。

Lemmyのアクションはすべて即座に結果を返しますか?

非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。