プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Mediumの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
タグtag | tagに指定したトピックタグのスラッグ(machine-learningなど)に分類されたMediumのストーリーを一覧表示します。著者、パブリケーション、読了時間、いいね数とコメント数、メンバー限定フラグを取得できます。全文検索ではなく、ペイウォールを回避して本文を取得することもできません。タグ内のすべてのストーリーが返されるとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
ユーザーの投稿user_posts | Mediumの著者1人が公開したストーリーを収集します。著者はハンドルまたはプロフィールURLでusernameに指定します。タイトル、抜粋、パブリケーション、読了時間、いいね数とコメント数を取得できます。下書きは除外され、全アーカイブの取得は保証されません。メンバー限定のストーリーにはフラグが付きますが、ロックは解除されません。 | 1,000リクエストあたり$1.39 | 正常 |
パブリケーションpublication | Mediumのパブリケーションに掲載されたストーリーを閲覧します。パブリケーションはスラッグまたはURLでpublicationに指定します。各ストーリーには著者、読了時間、いいね数とコメント数、メンバー限定フラグが含まれます。記事タイトルや著者のハンドルは入力に使えません。メンバー限定の本文はロックされたままです。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Mediumの各アクションではどのような入力を指定できますか?
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
tagタグ
| tag | — | Sync配信 | カタログ値:defaultLimit=10、maxLimit=25。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform · tags |
user_postsユーザーの投稿 Mediumの著者1人が公開したストーリーを収集します。著者はハンドルまたはプロフィールURLで | username | url | Sync配信 | カタログ値:defaultLimit=10、maxLimit=25。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform · tags |
publicationパブリケーション Mediumのパブリケーションに掲載されたストーリーを閲覧します。パブリケーションはスラッグまたはURLで | publication | url | Sync配信 | カタログ値:defaultLimit=10、maxLimit=25。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform · tags |
Mediumのtagのパラメータはそれぞれどういう意味ですか?
tagに指定したトピックタグのスラッグ(machine-learningなど)に分類されたMediumのストーリーを一覧表示します。著者、パブリケーション、読了時間、いいね数とコメント数、メンバー限定フラグを取得できます。全文検索ではなく、ペイウォールを回避して本文を取得することもできません。タグ内のすべてのストーリーが返されるとは限りません。
tag必須- Mediumのトピックタグのスラッグ(machine-learningなど)を指定します。先頭の#は削除され、テキストは小文字に変換され、スペースはハイフンに置き換えられます。任意の全文検索は行いません。Medium:トピック別コンテンツフィードと有料記事の範囲 — Mediumの公式ドキュメントでは、著者、パブリケーション、TopicsそれぞれのコンテンツフィードのURLを個別に記載しており、ペイウォール内の記事全文はRSSフィードに含まれないと明記しています。この参照情報はオブジェクトの種類と表示されるコンテンツを明確にするものであり、任意の全文検索やペイウォール内の全文取得まで対応範囲を広げるものではありません。 · 確認日
Mediumのuser_postsのパラメータはそれぞれどういう意味ですか?
Mediumの著者1人が公開したストーリーを収集します。著者はハンドルまたはプロフィールURLでusernameに指定します。タイトル、抜粋、パブリケーション、読了時間、いいね数とコメント数を取得できます。下書きは除外され、全アーカイブの取得は保証されません。メンバー限定のストーリーにはフラグが付きますが、ロックは解除されません。
username必須- Mediumの著者ハンドル、または著者プロフィールの完全なURLを指定します。ハンドルのみの場合はhttps://medium.com/@<handle>の形式に変換され、プロフィールのメタデータではなく、著者が公開した投稿の一覧を取得します。Medium:クラップ数とユニーク読者数の区別 — Mediumでは1人の読者が1つの記事に複数回クラップできるため、クラップの合計数をユニーク読者数として扱うことはできません。このインターフェースは、著者が確認できる個人別のクラップ内訳を提供しません。また、フィールドが存在していても、クラップ数が常に返されることは保証されません。 · 確認日
url任意- user_postsとpublicationで、著者またはパブリケーションの完全なURLを受け付ける互換入力です。必須のusernameまたはpublicationパラメータは引き続き指定する必要があります。返される投稿一覧には閲覧制限のある投稿が含まれることがありますが、有料記事の全文にアクセスできるわけではありません。
Mediumのpublicationのパラメータはそれぞれどういう意味ですか?
Mediumのパブリケーションに掲載されたストーリーを閲覧します。パブリケーションはスラッグまたはURLでpublicationに指定します。各ストーリーには著者、読了時間、いいね数とコメント数、メンバー限定フラグが含まれます。記事タイトルや著者のハンドルは入力に使えません。メンバー限定の本文はロックされたままです。
publication必須- Mediumのパブリケーションのスラッグ、またはパブリケーションの完全なURLを指定します。記事のタイトルや著者ハンドルは指定できません。スラッグのみの場合はmedium.com/<publication>に展開されます。Medium:パブリケーションと著者ページで異なるコンテンツフィード — Mediumでは、パブリケーションと@username形式の著者ページを区別しており、カスタムドメイン上のパブリケーションには別のコンテンツフィード形式を定めています。この引用はオブジェクトの違いを示すものです。このインターフェースの入力は引き続き上記のパラメータに従い、フィードURLを渡す必要はありません。また、すべてのカスタムドメインが検証済みであることは保証されません。 · 確認日
url任意- user_postsとpublicationで、著者またはパブリケーションの完全なURLを受け付ける互換入力です。必須のusernameまたはpublicationパラメータは引き続き指定する必要があります。返される投稿一覧には閲覧制限のある投稿が含まれることがありますが、有料記事の全文にアクセスできるわけではありません。
Medium 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":"medium","action":"tag","params":{"tag":"<tag>"}}'
Medium APIに関する質問
Medium APIでは何を取得できますか?
platformをmediumに設定します。現在のカタログにはタグ、ユーザーの投稿、パブリケーションが掲載されています。これらのアクション名はそれぞれ異なるMediumのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Mediumのtagリクエストを開始するには、どの入力を使用しますか?
Mediumのトピックタグのスラッグ(machine-learningなど)を指定します。先頭の#は削除され、テキストは小文字に変換され、スペースはハイフンに置き換えられます。任意の全文検索は行いません。params内のtagとして送信してください。
Mediumのtagはどのフィールドを返しますか?
宣言されたスキーマにはtitle、text、author_name、author_usernameが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Mediumのアクションはすべて即座に結果を返しますか?
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。