プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Substackの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | キーワードに一致するSubstackのニュースレターを見つけ、各パブリケーションの名前、ハンドル、カスタムドメイン、言語、著者、人気の投稿を取得します。投稿本文ではなくパブリケーションを対象に照合します。購読者数がnullの場合は非公開を意味し、0ではありません。 | 1,000リクエストあたり$1.39 | 正常 |
パブリケーションpublication | ホームページのリンクからSubstackのパブリケーションを検索し、名前、ハンドル、カスタムドメイン、言語、著者、人気の投稿、公開されている場合は購読者数を取得します。カスタムドメインは解析できない場合があるため、リンクには識別可能なSubstackハンドルが含まれている必要があります。著者のダッシュボードの情報は取得しません。 | 1,000リクエストあたり$1.39 | 正常 |
パブリケーションの投稿publication_posts | Substackパブリケーションの投稿を一覧で取得します。各投稿にはタイトル、サブタイトル、著者、いいね数、コメント数、単語数、読了時間、有料かどうかが含まれます。content_typeで形式を、sinceとuntilで日付を絞り込めます。ペイウォール内の本文は取得できず、1回の取得でアーカイブ全体を網羅できるとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
投稿詳細post | /p/リンクからSubstackの投稿を1件読み取ります。タイトル、サブタイトル、本文、著者、パブリケーション、エンゲージメント数、有料コンテンツかどうかを取得できます。ペイウォールで保護された本文は閲覧できません。コメントは別のcommentsアクションで取得します。 | 1,000リクエストあたり$1.39 | 正常 |
コメントcomments | Substackの投稿に付いたコメントを取得します。コメント投稿者、いいね数、返信数に加え、返信、ピン留めされたコメント、記事の著者本人によるコメントを示すフラグを取得できます。投稿の/p/リンクを指定してください。1回の取得で会話全体が含まれるとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
プロフィールprofile | ハンドルからSubstackライターのプロフィールを検索します。表示名、自己紹介、アバター、連携しているTwitterユーザー名、アカウントに紐づくパブリケーションを取得できます。ハンドル単体、@handle、substack.com/@リンクのいずれも指定できます。取得できるのは人物の情報で、パブリケーションの情報ではありません。購読データも表示されません。 | 1,000リクエストあたり$1.39 | 正常 |
ノートnotes | SubstackライターのNotes（ニュースレターとは別枠の短文投稿）を、本文、種類、いいね数、公開日時とともに収集します。対象は1人のライターのNotesのみでサイト全体の検索ではなく、全履歴を取得できない場合があります。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Substackの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 キーワードに一致するSubstackのニュースレターを見つけ、各パブリケーションの名前、ハンドル、カスタムドメイン、言語、著者、人気の投稿を取得します。投稿本文ではなくパブリケーションを対象に照合します。購読者数がnullの場合は非公開を意味し、0ではありません。 | keyword | — | Sync配信 | カタログ値：defaultLimit=10、maxLimit=30。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · handle · name · url · custom_domain · bio · language · subscriber_count · payments_enabled · avatar_url · cover_url · platform · author_name · author_username · top_posts |
publicationパブリケーション ホームページのリンクからSubstackのパブリケーションを検索し、名前、ハンドル、カスタムドメイン、言語、著者、人気の投稿、公開されている場合は購読者数を取得します。カスタムドメインは解析できない場合があるため、リンクには識別可能なSubstackハンドルが含まれている必要があります。著者のダッシュボードの情報は取得しません。 | url | — | Sync配信 | — | 1,000リクエストあたり$1.39 | id · handle · name · url · custom_domain · bio · language · subscriber_count · payments_enabled · avatar_url · cover_url · platform · author_name · author_username · top_posts |
publication_postsパブリケーションの投稿 Substackパブリケーションの投稿を一覧で取得します。各投稿にはタイトル、サブタイトル、著者、いいね数、コメント数、単語数、読了時間、有料かどうかが含まれます。 | url | content_type, since, until | Sync配信 | カタログ値：defaultLimit=10、maxLimit=30。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · subtitle · text · author_name · author_username · publication_name · publication_handle · publication_url · like_count · comment_count · repost_count · word_count · reading_time_minutes · post_type · audience · is_paid · podcast_url · image_url · posted_at · updated_at · tags · platform |
post投稿詳細 /p/リンクからSubstackの投稿を1件読み取ります。タイトル、サブタイトル、本文、著者、パブリケーション、エンゲージメント数、有料コンテンツかどうかを取得できます。ペイウォールで保護された本文は閲覧できません。コメントは別の | url | — | Sync配信 | — | 1,000リクエストあたり$1.39 | id · url · title · subtitle · text · author_name · author_username · publication_name · publication_handle · publication_url · like_count · comment_count · repost_count · word_count · reading_time_minutes · post_type · audience · is_paid · podcast_url · image_url · posted_at · updated_at · tags · platform |
commentsコメント Substackの投稿に付いたコメントを取得します。コメント投稿者、いいね数、返信数に加え、返信、ピン留めされたコメント、記事の著者本人によるコメントを示すフラグを取得できます。投稿の/p/リンクを指定してください。1回の取得で会話全体が含まれるとは限りません。 | url | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · text · author_name · author_username · like_count · reply_count · reply_to_id · is_reply · is_pinned · is_author · posted_at · platform |
profileプロフィール ハンドルからSubstackライターのプロフィールを検索します。表示名、自己紹介、アバター、連携しているTwitterユーザー名、アカウントに紐づくパブリケーションを取得できます。ハンドル単体、@handle、substack.com/@リンクのいずれも指定できます。取得できるのは人物の情報で、パブリケーションの情報ではありません。購読データも表示されません。 | username | — | Sync配信 | — | 1,000リクエストあたり$1.39 | user_id · username · display_name · bio · avatar_url · twitter_username · platform · publications |
notesノート SubstackライターのNotes（ニュースレターとは別枠の短文投稿）を、本文、種類、いいね数、公開日時とともに収集します。対象は1人のライターのNotesのみでサイト全体の検索ではなく、全履歴を取得できない場合があります。 | username | — | Sync配信 | カタログ値：defaultLimit=25、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · kind · text · author_username · author_name · like_count · posted_at · platform · restacked_post · attachment_urls |
Substackのsearchのパラメータはそれぞれどういう意味ですか？
キーワードに一致するSubstackのニュースレターを見つけ、各パブリケーションの名前、ハンドル、カスタムドメイン、言語、著者、人気の投稿を取得します。投稿本文ではなくパブリケーションを対象に照合します。購読者数がnullの場合は非公開を意味し、0ではありません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況keyword必須- Substackのニュースレターやパブリケーションを探すための検索クエリ文字列を指定します。投稿本文の全文検索は行いません。Substack：プロフィール、パブリケーションサイト、ダッシュボードデータの区別 — Substackは、公開プロフィール、パブリケーションのWebサイト、パブリッシャー向けダッシュボードを別々に説明しています。このページの検索で見つかるのはパブリケーションのプロフィールのみです。公式ダッシュボードに読者管理や収益統計の機能があっても、このインターフェースでそれらの分析データを取得できるわけではありません。 · 確認日
Substackのpublicationのパラメータはそれぞれどういう意味ですか？
ホームページのリンクからSubstackのパブリケーションを検索し、名前、ハンドル、カスタムドメイン、言語、著者、人気の投稿、公開されている場合は購読者数を取得します。カスタムドメインは解析できない場合があるため、リンクには識別可能なSubstackハンドルが含まれている必要があります。著者のダッシュボードの情報は取得しません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- 対象となるSubstackリソースのリンクを指定します。publicationとpublication_postsではパブリケーションのトップページ、postとcommentsでは/p/形式の投稿の直接リンクを使用してください。publicationアクションには、識別可能なSubstackハンドルを含むURLが必要です（カスタムドメインは解析できない場合があります）。一方、publication_postsはカスタムドメインのリンクをそのまま受け付けます。Substack：著者ページとパブリケーションサイトは別のアドレスオブジェクト — Substackの著者ハンドルはsubstack.com/@handleに対応し、パブリケーションのWebサイトはsubdomain.substack.comを使用できます。この参照情報はオブジェクトとアドレスの違いを確認するものです。カスタムドメインの解決機能は、このページの該当アクションのパラメータ規則に厳密に従います。 · 確認日
Substackのpublication_postsのパラメータはそれぞれどういう意味ですか？
Substackパブリケーションの投稿を一覧で取得します。各投稿にはタイトル、サブタイトル、著者、いいね数、コメント数、単語数、読了時間、有料かどうかが含まれます。content_typeで形式を、sinceとuntilで日付を絞り込めます。ペイウォール内の本文は取得できず、1回の取得でアーカイブ全体を網羅できるとは限りません。
url必須- 対象となるSubstackリソースのリンクを指定します。publicationとpublication_postsではパブリケーションのトップページ、postとcommentsでは/p/形式の投稿の直接リンクを使用してください。publicationアクションには、識別可能なSubstackハンドルを含むURLが必要です（カスタムドメインは解析できない場合があります）。一方、publication_postsはカスタムドメインのリンクをそのまま受け付けます。
content_type任意- パブリケーションの投稿をコンテンツ形式で絞り込みます。all_types、newsletter_posts_only、podcast_episodes_only、threads_onlyを指定できます。フィールドの有無は個々の投稿リンクで確認する必要があります。この値を設定しても、有料限定コンテンツは閲覧できません。指定可能な値:
all_typesnewsletter_posts_onlypodcast_episodes_onlythreads_onlySubstack：記事・音声・動画の形式とコンテンツの閲覧権限 — Substackはテキスト、音声、動画の投稿を別々のコンテンツ形式として分類し、公開コンテンツと非公開記事を厳格に区別しています。このページの`content_type`パラメータは独自の許容値を使用しており、動画タイプを追加するものではなく、すべての実行経路でフィルタリングと取得が検証済みであることを保証するものでもありません。 · 確認日 since任意- 投稿やアクティビティフィードを期間で絞り込むための開始日の文字列を指定します。プロフィールやパブリケーションの共通パラメータに含まれていても、アカウント作成日での絞り込みはできません。
until任意- sinceと組み合わせて投稿やアクティビティフィードを絞り込むための、終了日の文字列を指定します。このパラメータは購読の有効期限を表すものではなく、過去のアーカイブ全体をエクスポートするものでもありません。
Substackのpostのパラメータはそれぞれどういう意味ですか？
/p/リンクからSubstackの投稿を1件読み取ります。タイトル、サブタイトル、本文、著者、パブリケーション、エンゲージメント数、有料コンテンツかどうかを取得できます。ペイウォールで保護された本文は閲覧できません。コメントは別のcommentsアクションで取得します。
url必須- 対象となるSubstackリソースのリンクを指定します。publicationとpublication_postsではパブリケーションのトップページ、postとcommentsでは/p/形式の投稿の直接リンクを使用してください。publicationアクションには、識別可能なSubstackハンドルを含むURLが必要です（カスタムドメインは解析できない場合があります）。一方、publication_postsはカスタムドメインのリンクをそのまま受け付けます。Substack：無料プレビューは有料記事の全文ではない — Substackでは、クリエイターが有料記事の無料プレビューとペイウォールの位置を設定できます。そのため、テキストが空でなくても全文を取得できたことの証明にはならず、is_paidを設定したり有料コンテンツで絞り込んだりしても閲覧権限は付与されません。 · 確認日
Substackのcommentsのパラメータはそれぞれどういう意味ですか？
Substackの投稿に付いたコメントを取得します。コメント投稿者、いいね数、返信数に加え、返信、ピン留めされたコメント、記事の著者本人によるコメントを示すフラグを取得できます。投稿の/p/リンクを指定してください。1回の取得で会話全体が含まれるとは限りません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- 対象となるSubstackリソースのリンクを指定します。publicationとpublication_postsではパブリケーションのトップページ、postとcommentsでは/p/形式の投稿の直接リンクを使用してください。publicationアクションには、識別可能なSubstackハンドルを含むURLが必要です（カスタムドメインは解析できない場合があります）。一方、publication_postsはカスタムドメインのリンクをそのまま受け付けます。Substack：非表示のコメントと削除されたコメント — SubstackのReply Rulesでは、著者は記事のコメントやNotesの返信を完全に削除せずに非表示にできます。公開結果にコメントがないことは、それが削除されたことの証明にはなりません。また、このインターフェースにはモデレーション用ダッシュボードへのアクセス、非表示コンテンツの復元、ルールの変更を行う機能はありません。 · 確認日
Substackのprofileのパラメータはそれぞれどういう意味ですか？
ハンドルからSubstackライターのプロフィールを検索します。表示名、自己紹介、アバター、連携しているTwitterユーザー名、アカウントに紐づくパブリケーションを取得できます。ハンドル単体、@handle、substack.com/@リンクのいずれも指定できます。取得できるのは人物の情報で、パブリケーションの情報ではありません。購読データも表示されません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- profileまたはnotesの対象となるクリエイターのハンドルを指定します。ハンドルのみ（@プレフィックスは任意）またはsubstack.com/@userの完全なリンクを指定できます。notesアクションでは、長文のパブリケーション投稿ではなく、クリエイターの短い投稿を取得します。Substack：著者ハンドル、表示名、公開プロフィール — Substackでは一意のハンドルが著者プロフィールのURLを構成し、表示名と自己紹介はそれとは別に編集できます。このページではこれに従ってusernameとdisplay_nameを区別しており、非公開の購読やいいねのアクティビティを読み取れるとは謳っていません。 · 確認日
Substackのnotesのパラメータはそれぞれどういう意味ですか？
SubstackライターのNotes（ニュースレターとは別枠の短文投稿）を、本文、種類、いいね数、公開日時とともに収集します。対象は1人のライターのNotesのみでサイト全体の検索ではなく、全履歴を取得できない場合があります。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- profileまたはnotesの対象となるクリエイターのハンドルを指定します。ハンドルのみ（@プレフィックスは任意）またはsubstack.com/@userの完全なリンクを指定できます。notesアクションでは、長文のパブリケーション投稿ではなく、クリエイターの短い投稿を取得します。Substack：NotesとRestackの定義 — SubstackはNotesを短文形式の投稿、RestackをNotes内でのコンテンツ共有と定義し、記事単位のニュースレター配信と区別しています。Substackに公式の投稿、エンゲージメント、収益分析の機能があっても、このNotes読み取りエンドポイントがそれらの操作や指標に対応しているわけではありません。 · 確認日
Substack 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":"substack","action":"search","params":{"keyword":"<keyword>"}}'
Substack APIに関する質問
Substack APIでは何を取得できますか？
platformをsubstackに設定します。現在のカタログには検索、パブリケーション、パブリケーションの投稿、投稿詳細、コメント、moreが掲載されています。これらのアクション名はそれぞれ異なるSubstackのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Substackのsearchリクエストを開始するには、どの入力を使用しますか？
Substackのニュースレターやパブリケーションを探すための検索クエリ文字列を指定します。投稿本文の全文検索は行いません。params内のkeywordとして送信してください。
Substackのsearchはどのフィールドを返しますか？
宣言されたスキーマにはhandle、name、custom_domain、bioが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Substackのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。