🥞
Instagram Graph API で投稿データを取得する
はじめに
Instagram Graph API で投稿を取得するスクリプトを Python で作成。
Instagram Graph API を使う機会がある方の参考になれば幸いです。
対応した時の API version は、v18.0 です。
アクセストークンの取得については、他の記事がわかりやすく、今回は自身が残しておきたいポイントだけをまとめております。
事前準備
アクセストークン生成
他に参考にしていただいた記事がわかりやすく、今回は自身がつまったポイントだけをまとめております。
-
ビジネスアカウントを作成する必要がある
Instagram, facebook アカウント連携する工程が必要...
-
アクセス許可をアプリに付与
v18.0 では、以下のアクセス許可が必要. 公式にも使いたい API によって、必要なアクセス許可が記載されていました。
No 名称 Endpoints 用途 1 IG Hashtag Search GET /ig_hashtag_search?user_id={user-id}&q={q} IGハッシュタグ検索
※ No.2 の {ig-hashtag-id} を入れるため2 IG Hashtag Recent Media GET /{ig-hashtag-id}/recent_media?user_id={user-id}&fields={fields} IGハッシュタグの最近のメディア取得 3 Business Discovery GET /{ig-user-id}/business_discovery ビジネスアカウント取得 ## アクセス許可 8つ - pages_show_list - ads_management - business_management - instagram_basic - instagram_manage_comments - instagram_manage_insights - instagram_content_publish - instagram_manage_messages -
アクセストークン延長をする
こちらを参考にさせていただきました🙏
参考_3つのアクセストークンの違い
# １つ目のアクセストークン
アプリを作成した際のデフォルト状態のアクセストークンです。
インスタグラムへのアクセス許可を追加していないので、連携に使う事はできません。
# ２つ目のアクセストークン
期間限定でインスタグラムへのアクセス許可を追加した状態のアクセストークンです。
短期的にしか使用できません。
# ３つ目のアクセストークン
期間制限のない、長期的に使用できるアクセストークンです。
これを使用します。
-
以下の アクセストークンを使用する
-
ビジネスアカウント取得
me?fields=accounts{instagram_business_account}
ここまでやって、やっと投稿を取得できるようになります 🍵 🍵 🍵
気を取り直して、Python で実装した内容です !!
動作環境
- Mac M1
- 仮想環境
- Python 3.9 系
- Instagram Graph API v18.0
リポジトリ
README にも記載していますが、以下のリポジトリにコードをまとめています。
clone して、興味があれば access token を発行して実行してみてください。
検証
1. 実行結果
-
コマンド実行
limitパラメータがあり Max 50 件 まで取得できることを確認. 公式ドキュメントからは読み取れなかった ...# 3件で取得 (.venv) ~/code/external_api_app (🍁🍡main *=) $ python main.py -query bluebottle -limit 3 2023-10-29 00:49:50,503 - INFO - instagram(49) - 200 2023-10-29 00:49:50,505 - INFO - instagram(55) - {'query': 'bluebottle', 'id': '17843857450040591'} 2023-10-29 00:49:51,627 - INFO - instagram(77) - {'response code': 200} 2023-10-29 00:49:51,632 - INFO - instagram(120) - 投稿数: 3 2023-10-29 00:49:52,346 - INFO - instagram(102) - {'response code': 200} 2023-10-29 00:49:52,354 - INFO - instagram(120) - 投稿数: 3 -
取得データイメージ
JSON, CSV でファイル出力できるようにしています。JSONの出力結果イメージ{ "data": [ { "id": "xxxxxxxxxxxxxxxxx", "username": "bluebottle", "caption": "Our ...", "comments_count": 21, "like_count": 283, "media_product_type": "FEED", "media_url": "https://scon...", "permalink": "https://www.instagram.com/p/...", "timestamp": "2023-10-26T19:05:20+0000" }, { # ... } ], "paging": { "cursors": { "after": "QVF..." } } }
2. API 叩きすぎるとアカウント一時停止
意図的に、レート制限を超えるまでリクエスト. アカウント一時停止!!?
異議申請をして復旧させましたが、やはりシビアですね... 🧨
これから
- リクエスト制限を超えないようにする
- ig-hashtag-search で取得した
{ig-hashtag-id}は、一度取得したら、DB, 設定ファイルに保存するなどして再利用する
- ig-hashtag-search で取得した
- トークンの有効期限が切れたら、自動で更新するようにする. 多分今のままだと、無期限トークンが取得できてないので
- ハッシュタグ, ビジネスアカウントの起動コマンドを分ける. 今は一度に取得する動きになっている
- API 化して、フロントエンドからも使えるようにする
- エラーハンドリングを入れる
- 本格的に使うなら、アプリ申請も必要になりそう
参考
Discussion