Patreon詳細API
APIの稼働状況
- 24時間の稼働状況
- 正常
- 24時間の平均応答時間
- —
- 良好/正常
- 利用可能
- 制限あり
- ほぼ停止
過去24時間
過去30日間
usernameでPatreonのクリエイターページを取得します。概要、メンバーシップのティア、パトロン数、月額または作品ごとの課金方式、ソーシャルリンク、メンバーシップのオプションが含まれます。クリエイターが非表示にしている場合、paid_member_countはnullになり、0を意味するものではありません。収益は推定されず、限定ティアの内容は非公開のままです。
料金は1,000リクエストあたり$1.39(1回あたり$0.001389)です。失敗した呼び出しと空の結果には課金されません。 同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。
AIプロンプト
EveryInfraのPatreon 詳細エンドポイント(patreon/profile)を使ったデータ収集スクリプトの作成を手伝ってください。
エンドポイントの仕組み:
- リクエスト:ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにpatreon、actionにprofileを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ:
- username: profileおよびuser_postsアクションで使用するクリエイターのカスタムURLスラッグを指定します。@slug、ハンドル名そのまま、または/c/slugを含むPatreonのURLを指定できます。取得できるのは公開されているクリエイターのプロフィール情報、ティア構成、公開投稿のみで、購読者限定のコンテンツにはアクセスしません。
- 1つのオブジェクトを返します。主なフィールド: id、name、vanity、url、creation_name、one_liner、summary、currency、patron_count、paid_member_count、post_count、pay_per。フィールドは全部で24個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=patreonを参照してください。.
- リクエストボディの例:
{
"platform": "patreon",
"action": "profile",
"params": {
"username": "kurzgesagt"
}
}
- 料金:1,000リクエストあたり$1.39。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。
コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。リクエストパラメータ
| 名前 | 場所 | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|---|
Authorization | header | string | はい | - | Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。 |
platform | body | string | はい | patreon | プラットフォームの識別子です。値は固定です。 |
action | body | string | はい | profile | 機能の識別子です。値は固定です。 |
username | body.params | string | はい | - | profileおよびuser_postsアクションで使用するクリエイターのカスタムURLスラッグを指定します。@slug、ハンドル名そのまま、または/c/slugを含むPatreonのURLを指定できます。取得できるのは公開されているクリエイターのプロフィール情報、ティア構成、公開投稿のみで、購読者限定のコンテンツにはアクセスしません。 |
コードサンプル
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "patreon",
"action": "profile",
"params": {
"username": "kurzgesagt"
}
}'OpenAPI定義(JSON)サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。
レスポンス例
October 24, 2026 at 22:01(UTC)に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報(名前、ハンドル、アバター、プロフィールリンク、連絡先)を削除したものです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。
{
"id": "req_…",
"platform": "patreon",
"action": "profile",
"results": {
"id": "73401",
"name": "Kurzgesagt – In a Nutshell",
"vanity": "Kurzgesagt",
"url": "https://www.patreon.com/Kurzgesagt",
"creation_name": "Creating Science Animation Videos",
"one_liner": "Science Videos made with Love.",
"summary": "Hello! We are kurzgesagt, one of the largest sciency channels on YouTube. We believe that nothing is boring if you tell a good story and we try to tell these stories. Our core mission is to spark curiosity and inspire people all around the world to go out and learn more about spa…",
"currency": "USD",
"post_count": 535,
"pay_per": "month",
"is_monthly": true,
"is_nsfw": false,
"published_at": "2013-08-30T16:09:54+00:00",
"pledge_url": "https://www.patreon.com/checkout/Kurzgesagt",
"avatar_url": "https://c10.patreonusercontent.com/•••",
"cover_url": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/73401/e648561d635d45e7abf9a3cb68098e83/eyJ3IjoxOTIwLCJ3ZSI6MX0%3D/1.png?token-hash=LJ_8XtEuk7fh0N3mcws2ZuXFVrePObKqMxZeqNHkHEM%3D&token-time=1793750400",
"main_video_url": "https://youtu.be/1x-i9z617z4",
"platform": "patreon",
"tiers": [
{
"title": "Free",
"amount_cents": 0,
"amount_usd": 0,
"currency": "USD",
"is_free": true,
"post_count": 8,
"url": "https://www.patreon.com/checkout/Kurzgesagt?rid=10010522"
},
{
"title": "Trainee Producer",
"description": "Perks: You're helping ensure the survival of high-quality content! AdBlock absolution ❤️ Early access to special product launches (like our calendar!) Occasional behind-the-scenes images or notes from the studio",
"amount_cents": 314,
"amount_usd": 3.14,
"currency": "USD",
"is_free": false,
"post_count": 1,
"url": "https://www.patreon.com/checkout/Kurzgesagt?rid=22201322"
},
{
"title": "Producer",
"description": "You receive all the perks from the Trainee Producer tier PLUS: Access to 1,100+ exclusive wallpapers over 24h of music! Video teasers one day before release Your name in the video description on the first month of subscription A personalized certificate from Duck 💌 Regular update…",
"amount_cents": 1500,
"amount_usd": 15,
"currency": "USD",
"is_free": false,
"post_count": 64,
"url": "https://www.patreon.com/checkout/Kurzgesagt?rid=28691"
}
],
"tier_count": 4,
"socials": {
"twitter": "Kurz_Gesagt",
"youtube": "https://www.youtube.com/channel/UCsXVk37bltHxD1rDPwtNM8Q",
"facebook": "https://www.facebook.com/Kurzgesagt?ref=hl",
"instagram": "https://www.instagram.com/kurzgesagt"
}
},
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}レスポンスフィールド
業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。
| フィールド | 意味 |
|---|---|
id | プラットフォーム上でのレコードの一意なIDです。一意性は1つのプラットフォーム内に限られ、プラットフォームが異なるとIDが重複する場合があります。 |
name | 対象そのものの名前です(アカウント・商品・ビジネス系の機能で使用)。 |
vanity | プラットフォーム上の意味のまま |
url | プラットフォーム上のレコードへのリンクです。 |
creation_name | プラットフォーム上の意味のまま |
one_liner | プラットフォーム上の意味のまま |
summary | プラットフォーム上の意味のまま |
currency | 価格の通貨コードです(例:CNY、USD)。priceフィールドが存在してもcurrencyがnullの場合は、通貨を推測しないでください。 |
patron_count | プラットフォーム上の意味のまま |
paid_member_count | プラットフォーム上の意味のまま |
post_count | 総投稿数です。nullは0ではなく、非公開であることを示します。 |
pay_per | プラットフォーム上の意味のまま |
is_monthly | プラットフォーム上の意味のまま |
is_nsfw | プラットフォーム上の意味のまま |
offers_free_membership | プラットフォーム上の意味のまま |
offers_paid_membership | プラットフォーム上の意味のまま |
published_at | プラットフォーム上の意味のまま |
pledge_url | プラットフォーム上の意味のまま |
avatar_url | アバター画像のリンクです。一部のプラットフォームでは、サイズ指定付きで有効期限が切れる可能性のあるCDNリンクが返されます。 |
cover_url | プラットフォーム上の意味のまま |
main_video_url | プラットフォーム上の意味のまま |
platform | 取得元プラットフォームの識別子で、リクエストのplatformと同じです(例:xiaohongshu、tiktok)。 |
tiers | プラットフォーム上の意味のまま |
tier_count | プラットフォーム上の意味のまま |
socials | プラットフォーム上の意味のまま |
エラーと課金
- 401
- キーが未指定か無効です。
- 402
- 残高が不足しています。先にチャージしてください。
- 422
- パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
- 429
- 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
- 503
- 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
- 200(空)
- データがありません。課金はされません。
公式リファレンス
対象と用語の確認にのみ使用しています。プラットフォームによるEveryInfraの承認や推奨を意味するものではありません。
- Patreon:メンバー数のスナップショットは処理済み収益ではない ↗
Patreonはメンバー数と収益の概要を特定時点のスナップショットとして扱い、処理済みの収益は専用のレポートに記載しています。公開されているpaid_member_count、課金単位、通貨からは取引の詳細はわからず、これらを単純に掛け合わせて実際の収益や確定額を算出することはできません。
確認日:2026-09-04