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

Medium API

ハンドルや短縮名を使って、著者、パブリケーション、タグからMediumの記事を取得できます。

タグまたはパブリケーションのURLで記事を取得します。メンバー限定ストーリーの全文取得は保証されません。

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

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

過去30日間

利用可能な機能

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

機能できること1,000リクエストあたり24時間の稼働状況
タグtagtagに指定したトピックタグのスラッグ(machine-learningなど)に分類されたMediumのストーリーを一覧表示します。著者、パブリケーション、読了時間、いいね数とコメント数、メンバー限定フラグを取得できます。全文検索ではなく、ペイウォールを回避して本文を取得することもできません。タグ内のすべてのストーリーが返されるとは限りません。1,000リクエストあたり$1.39正常
ユーザーの投稿user_postsMediumの著者1人が公開したストーリーを収集します。著者はハンドルまたはプロフィールURLでusernameに指定します。タイトル、抜粋、パブリケーション、読了時間、いいね数とコメント数を取得できます。下書きは除外され、全アーカイブの取得は保証されません。メンバー限定のストーリーにはフラグが付きますが、ロックは解除されません。1,000リクエストあたり$1.39正常
パブリケーションpublicationMediumのパブリケーションに掲載されたストーリーを閲覧します。パブリケーションはスラッグまたはURLでpublicationに指定します。各ストーリーには著者、読了時間、いいね数とコメント数、メンバー限定フラグが含まれます。記事タイトルや著者のハンドルは入力に使えません。メンバー限定の本文はロックされたままです。1,000リクエストあたり$1.39正常

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

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

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

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

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

タグ

tagに指定したトピックタグのスラッグ(machine-learningなど)に分類されたMediumのストーリーを一覧表示します。著者、パブリケーション、読了時間、いいね数とコメント数、メンバー限定フラグを取得できます。全文検索ではなく、ペイウォールを回避して本文を取得することもできません。タグ内のすべてのストーリーが返されるとは限りません。

tag—Sync配信カタログ値:defaultLimit=10、maxLimit=25。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$1.39id · 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に指定します。タイトル、抜粋、パブリケーション、読了時間、いいね数とコメント数を取得できます。下書きは除外され、全アーカイブの取得は保証されません。メンバー限定のストーリーにはフラグが付きますが、ロックは解除されません。

usernameurlSync配信カタログ値:defaultLimit=10、maxLimit=25。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$1.39id · 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に指定します。各ストーリーには著者、読了時間、いいね数とコメント数、メンバー限定フラグが含まれます。記事タイトルや著者のハンドルは入力に使えません。メンバー限定の本文はロックされたままです。

publicationurlSync配信カタログ値:defaultLimit=10、maxLimit=25。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$1.39id · 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のストーリーを一覧表示します。著者、パブリケーション、読了時間、いいね数とコメント数、メンバー限定フラグを取得できます。全文検索ではなく、ペイウォールを回避して本文を取得することもできません。タグ内のすべてのストーリーが返されるとは限りません。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
tag必須
Mediumのトピックタグのスラッグ(machine-learningなど)を指定します。先頭の#は削除され、テキストは小文字に変換され、スペースはハイフンに置き換えられます。任意の全文検索は行いません。
Medium:トピック別コンテンツフィードと有料記事の範囲 — Mediumの公式ドキュメントでは、著者、パブリケーション、TopicsそれぞれのコンテンツフィードのURLを個別に記載しており、ペイウォール内の記事全文はRSSフィードに含まれないと明記しています。この参照情報はオブジェクトの種類と表示されるコンテンツを明確にするものであり、任意の全文検索やペイウォール内の全文取得まで対応範囲を広げるものではありません。 · 確認日

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

Mediumの著者1人が公開したストーリーを収集します。著者はハンドルまたはプロフィールURLでusernameに指定します。タイトル、抜粋、パブリケーション、読了時間、いいね数とコメント数を取得できます。下書きは除外され、全アーカイブの取得は保証されません。メンバー限定のストーリーにはフラグが付きますが、ロックは解除されません。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
username必須
Mediumの著者ハンドル、または著者プロフィールの完全なURLを指定します。ハンドルのみの場合はhttps://medium.com/@<handle>の形式に変換され、プロフィールのメタデータではなく、著者が公開した投稿の一覧を取得します。
Medium:クラップ数とユニーク読者数の区別 — Mediumでは1人の読者が1つの記事に複数回クラップできるため、クラップの合計数をユニーク読者数として扱うことはできません。このインターフェースは、著者が確認できる個人別のクラップ内訳を提供しません。また、フィールドが存在していても、クラップ数が常に返されることは保証されません。 · 確認日
url任意
user_postsとpublicationで、著者またはパブリケーションの完全なURLを受け付ける互換入力です。必須のusernameまたはpublicationパラメータは引き続き指定する必要があります。返される投稿一覧には閲覧制限のある投稿が含まれることがありますが、有料記事の全文にアクセスできるわけではありません。

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

Mediumのパブリケーションに掲載されたストーリーを閲覧します。パブリケーションはスラッグまたはURLでpublicationに指定します。各ストーリーには著者、読了時間、いいね数とコメント数、メンバー限定フラグが含まれます。記事タイトルや著者のハンドルは入力に使えません。メンバー限定の本文はロックされたままです。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
publication必須
Mediumのパブリケーションのスラッグ、またはパブリケーションの完全なURLを指定します。記事のタイトルや著者ハンドルは指定できません。スラッグのみの場合はmedium.com/<publication>に展開されます。
Medium:パブリケーションと著者ページで異なるコンテンツフィード — Mediumでは、パブリケーションと@username形式の著者ページを区別しており、カスタムドメイン上のパブリケーションには別のコンテンツフィード形式を定めています。この引用はオブジェクトの違いを示すものです。このインターフェースの入力は引き続き上記のパラメータに従い、フィードURLを渡す必要はありません。また、すべてのカスタムドメインが検証済みであることは保証されません。 · 確認日
url任意
user_postsとpublicationで、著者またはパブリケーションの完全なURLを受け付ける互換入力です。必須のusernameまたはpublicationパラメータは引き続き指定する必要があります。返される投稿一覧には閲覧制限のある投稿が含まれることがありますが、有料記事の全文にアクセスできるわけではありません。

Medium APIの使い方

  1. 01公開カタログからプラットフォームのアクションを選択します。
  2. 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
  3. 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
  4. 04アプリケーションで必要なレスポンスフィールドを保存します。
medium_tag.sh
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配信が含まれています。