Imgur APIのClient ID取得方法｜登録手順・API活用・エラー対処を完全解説

Imgur APIを使えば、プログラムから画像のアップロード・取得・削除が自動化できます。SNS自動投稿ツールや画像管理システムの構築に欠かせないAPIですが、登録画面が英語のみで手順に迷う方も多いです。

本記事では、Imgurアカウント登録からClient ID取得、APIの基本的な使い方、レート制限の対処法まで、図解付きで解説します。

SNS運用を自動化したい方は、あわせてSNS予約投稿ツールまとめもご覧ください。Imgur APIと組み合わせることで、画像付き投稿の自動化がさらに効率的になります。

Imgurとは？APIで何ができるか

Imgurは世界最大級の画像ホスティングサービスです。無料で利用でき、REST API v3を通じてプログラムから画像の操作が可能です。

Imgurの主な特徴

Imgur APIでできること

• 画像のアップロード（URL指定 or Base64）
• 画像情報の取得（URL、サイズ、閲覧数等）
• アルバムの作成・管理
• 画像の削除
• アカウント情報の取得

Anonymous APIとOAuth APIの違い

SNS運用でImgur APIを活用する場合、Threads APIと組み合わせると、画像をImgurにホスティングしてからThreadsに自動投稿する仕組みも構築できます。

Imgurアカウントの登録方法

Imgur APIを利用するには、まずImgurアカウントが必要です。Googleアカウント連携が最も手軽な方法です。

ステップ1: Imgur公式サイトにアクセスする

1. imgur.com にアクセス
2. 右上の「Sign up」をクリック

ステップ2: Googleアカウントで登録する

1. 「Continue with Google」を選択
2. Googleアカウントでログイン
3. ユーザー名を入力（英数字、3〜20文字）
4. 「Next」をクリック

Client ID（APIキー）の取得手順

アカウント登録が完了したら、API利用に必要なClient IDを取得します。取得は無料で、数分で完了します。

ステップ1: API登録ページにアクセスする

ログイン状態で以下のURLにアクセスします。

https://api.imgur.com/oauth2/addclient

ステップ2: アプリケーション情報を入力する

ステップ3: Client IDをコピーして保存する

1. 「Submit」をクリック
2. 「Client ID」と「Client Secret」が表示される
3. 両方をメモ帳等に保存する

Imgur APIの基本的な使い方

Client IDを取得したら、実際にAPIリクエストを送ってみましょう。ここではcurlコマンドを使った基本的な操作例を紹介します。

APIリクエストの基本形

Imgur APIのエンドポイントは以下です。

https://api.imgur.com/3/

すべてのリクエストに認証ヘッダーが必要です。

Authorization: Client-ID {YOUR_CLIENT_ID}

画像をアップロードする（Anonymous）

curlを使った画像アップロードのリクエスト例です。

curl -X POST https://api.imgur.com/3/image \
  -H "Authorization: Client-ID {YOUR_CLIENT_ID}" \
  -F "image=@/path/to/image.png"

Base64エンコードした画像データやURLを指定することもできます。

curl -X POST https://api.imgur.com/3/image \
  -H "Authorization: Client-ID {YOUR_CLIENT_ID}" \
  -F "image=https://example.com/photo.jpg" \
  -F "type=url"

成功時のJSONレスポンス例です。

{
  "data": {
    "id": "abc123",
    "link": "https://i.imgur.com/abc123.png",
    "deletehash": "xYz789DeleteHash"
  },
  "success": true,
  "status": 200
}

アップロード済み画像の情報を取得する

curl -X GET https://api.imgur.com/3/image/{imageHash} \
  -H "Authorization: Client-ID {YOUR_CLIENT_ID}"

画像を削除する

Anonymous（deletehash使用）での削除リクエストです。

curl -X DELETE https://api.imgur.com/3/image/{deleteHash} \
  -H "Authorization: Client-ID {YOUR_CLIENT_ID}"

レート制限（429エラー）の仕組みと対処法

Imgur APIにはリクエスト数の制限があります。制限を超えると429 Too Many Requestsエラーが返されます。安定した運用のためにレート制限の仕組みを理解しておきましょう。

Imgur APIのレート制限一覧

429 Too Many Requestsエラーの対処法

429エラーが発生した場合、以下の手順で対処してください。

1. レスポンスヘッダーで残りリクエスト数を確認

2. リトライ戦略を実装する

• 429エラー受信時は最低60秒待機
• 指数バックオフ: 60秒 → 120秒 → 240秒
• X-RateLimit-UserResetを確認してリセット後にリトライ

3. 運用のコツ

• 複数のClient IDを用意してローテーション
• アップロード間隔を3秒以上空ける
• 1Googleアカウント → 1Imgurアカウント → 1Client ID の関係

よくあるエラーと対処法

Imgur API利用時に遭遇しやすいエラーとその対処法をまとめます。

401 Unauthorized

403 Forbidden / Over Capacity

400 Bad Request

アプリケーション登録ページが表示されない

しんたろ。

Excel歴10年以上 → アプリ開発者

Profile

大手メーカーに15年以上勤務。製造部門で海外拠点の立ち上げ支援や、現場責任者として採算管理・納期管理・設備オペレートを経験。 2023年にDX人材育成プログラム第1期生として活動後、現在は製造現場のスケジュール運用を支えるアプリの企画・開発をメインに活動中。工程表示表作成の内製化SaaSを構築し、年間1,300万円のコスト改善を実現。 Excelによる業務改善で年間240時間の残業削減を達成した経験を活かし、ブログやSNSでも情報発信しています。

プロフィールを読む

XYouTubeLINEContact

まとめ

Imgur APIのClient ID取得から基本的な使い方までを解説しました。全体の流れを振り返ります。

Client IDの取得自体は5分程度で完了します。Anonymous APIなら画像アップロードがすぐに使えます。より高度な操作（アルバム管理、ユーザー画像の管理）が必要な場合はOAuth 2.0認証を設定してください。

Imgur APIはSNS自動投稿の画像ホスティング先として非常に便利です。SNS予約投稿ツールと組み合わせて、投稿の完全自動化を目指しましょう。Threads APIの設定方法もあわせて参考にしてください。

しんたろ。

Excel歴10年以上 → アプリ開発者

XYouTubeLINEContact

大手メーカーに15年以上勤務。製造部門で海外拠点の立ち上げ支援や、現場責任者として採算管理・納期管理・設備オペレートを経験。 2023年にDX人材育成プログラム第1期生として活動後、現在は製造現場のスケジュール運用を支えるアプリの企画・開発をメインに活動中。工程表示表作成の内製化SaaSを構築し、年間1,300万円のコスト改善を実現。 Excelによる業務改善で年間240時間の残業削減を達成した経験を活かし、ブログやSNSでも情報発信しています。