Instagram APIの使い方

Data365のInstagram APIは、ハッシュタグや場所で投稿を検索し、必要なパラメータ（言語を含む）で結果をフィルタリングするのに役立つツールです。Instagram APIを使用すると、多くのInstagram公開プロフィールデータを収集できます。また、投稿からも多くの情報を取得できます。したがって、Instagram APIはマーケティングリサーチや分析に従事する企業に特に役立ちます。

それでは、Instagram APIの使い方を詳しく見ていきましょう。この記事では、POSTおよびGETリクエストの機能とそれらを正しく適用する方法について説明します。また、ユーザーのURLに直接データを取得できるcallback_urlパラメータについても紹介し、APIレスポンスの形式と取得できるデータについてお話しします。投稿検索の詳細な例を使用して、Data365.coからInstagram APIを使用する方法を示します。最後に、Webhookとは何か、その目的、そしてData365のInstagram APIがこの機能をどのように提供するかを学びます。

Instagram APIリクエスト

Data365のInstagram APIは、HTTPに基づいています。これはインターネットリソース間で通信するためのアプリケーション層プロトコルです。したがって、このタイプのAPIのすべての主要な利点（キャッシング、スケーリング、最小オーバーヘッド、標準エラーコード）を持っています。私たちのInstagram APIは、POSTおよびGETリクエストなどのインタラクションメソッドを使用します。

POSTリクエストはデータを更新するタスクであり、つまりData365データベースに新しいInstagramデータを追加するか、既存のデータを更新するタスクです。POSTリクエストには料金が発生し、メンション数でカウントされます。

GETリクエストは、POSTリクエストが完了した後に収集されたデータを取得するためにData365データベースに対して行うクエリです。1秒あたり最大100のGETリクエストを送信できます。GETリクエストには料金は発生しません。

Instagram APIへのリクエストを作成するには？

リクエストを作成する際は、データを取得または検索したい要素ID（例えば、Instagram投稿ID、プロフィールID、場所ID、ハッシュタグなど）を必ず指定してください。

POSTリクエストでは、Instagram APIクエリをパーソナライズしてダウンロードするデータの量を増減させることができる追加のパラメータを指定できます。
たとえば、データが必要な期間を指定する（パラメータfrom_dateおよびto_date）、投稿のコメントを追加でダウンロードする、プロフィール上の投稿や検索による投稿を選択する（パラメータload_commentsおよびload_post）、自動データ更新を設定する（パラメータauto_update_interval）またはユーザーのURLにデータを送信する（callback_urlパラメータ）など、多くのことが可能です。

GETリクエストでも、受信データをフィルタリングおよびソートするための追加のパラメータを指定できます。

Instagram callback url

callback_urlパラメータの使用についてもう少し詳しく見てみましょう。このパラメータはPOSTリクエスト内で直接指定でき、POSTリクエストが完了した後、指定したリンクにデータを含むレスポンスを受け取ります。

callback_urlパラメータを指定した場合、タスクのステータスを確認し、データを受け取るためにGETリクエストを送信する必要はありません。

"callback_url"パラメータの機能についての詳細は、https://data365.co/ja/guides/callback-guideでお読みいただけます。

Instagram JSONでAPIレスポンスを取得する

リクエストが完了すると、ユーザーはJSON形式のレスポンスを受け取ります。JSONは、他の形式に対して重要な利点があり、その人気の理由を説明します。まず第一に、データ交換時に非常に重要なコンパクトさがあります。第二に、JSONは使いやすく、読み書きが非常に簡単です。もともとはJavaScript用に作成されましたが、他の多くの言語にもそれを扱うライブラリがあります。したがって、クライアントがJavaScriptを使用している場合でも、サーバーがRuby/PHP/Javaまたは他の言語で書かれている場合でも、データ交換にJSONを簡単に使用できます。

私たちのInstagram APIを使用すると、ターゲットプロフィールやInstagram投稿のIDまたはユーザー名のデータベースに基づいて、公開InstagramプロフィールからInstagram JSONデータを取得できます。私たちが提供する最も人気のあるデータには、ID、ユーザー名、バイオグラフィー、プロフィール写真、ビジネスカテゴリ、言語、性別、ユーザーの最新の写真による年齢認識などがあります。

Instagram APIの例

この例では、ハッシュタグでInstagramの投稿を検索し、それに関するすべてのデータを取得する方法を示します。

https://api.data365.co/v1.1/instagram/tag/bitcoins/update?max_posts_count=100&load_comments=1&max_comments=50&access_token=TOKEN

このリクエストでは、

• bitcoins – 検索するハッシュタグ;
• max_posts_count=100 – ダウンロードするbitcoinsハッシュタグの最大投稿数;
• load_comments=1 – 各投稿のコメントをダウンロードすることを有効にします;
• max_comments=50 – 各投稿に対してダウンロードされる最大コメント数です。
  

ステータス「accepted」は、リクエストが処理のために受け入れられたことを意味します。

その概算コストは = 7 + 100 * 5 = 507メンションです。7メンションは検索リクエスト自体の料金、100メンションは受信することを期待する投稿数、5はコメント付き投稿の推定コストです。したがって、507はリクエストの推定コストです。

ただし、タグに対して20件の投稿しかなく、これらの20件の投稿にコメントがない場合、そのリクエストのコストは7 + 20 * 1 = 27メンションになります。つまり、7メンションは検索リクエスト自体のコスト、20は見つかった投稿数、1はコメントなしの投稿のコストです。

したがって、POSTリクエストを作成した後に実際に受け取ったデータに対してのみ料金を請求します。
‍

リクエストのステータスには5つのオプションがあります：created（作成済み）、pending（保留中）、finished（完了）、unknown（リクエストがまだ作成されていない、存在しない場合）、fail（リクエストがエラーのために完了しなかった）です。通常、リクエストの実行プロセスは、created → pending → finishedで、約1〜5分かかります。この時間は、リクエストの総数やリクエスト内のデータ量によって増加する可能性があります。つまり、タグによる100件の投稿をダウンロードするリクエストは約1分かかりますが、コメント付きの1000件の投稿をダウンロードするには約5分かかります。
‍

レスポンスとして、段落1で作成したリクエストによって見つかった投稿のリストが返されます。
‍

https://api.data365.co/v1.1/instagram/post/2509278369173225328/comments?access_token=TOKEN

• 2509278369173225328はダウンロードされた投稿IDで、コメントを受け取りたい投稿です。

Instagram Webhook

Webhookは、公式のInstagram APIとData365のInstagram APIの両方で利用できる機能です。Webhookは、設定の変更、新しいユーザーの追加、メッセージの削除など、さまざまなイベントに関するメッセージを簡素化するために特別に作成されました。公式のInstagram Webhookを使用すると、リアルタイム通知を受け取ることができます。ただし、特定の条件が満たされている場合に限ります。Instagram用のWebhookは、適切なフィールドへのサブスクリプションで構成されている必要があります。また、アプリケーションは実行中で、適切な権限が付与されている必要があります。たとえば、メディアオブジェクトが非公開アカウントの所有者によって作成された場合、公式のInstagram Webhookは送信されません。また、公式のInstagram WebhookはReels動画をサポートしていません。

Data365のInstagram APIを使用すると、新しいデータに関する情報を定期的に受け取ることもできます。新しいデータを監視するauto_update_intervalパラメータを指定するだけで済みます。そして、新しいデータをユーザーのアドレス（URL）に送信するcallback_urlパラメータを指定します。たとえば、私たちのAPIを使用すると、フォローしているハッシュタグや場所の新しい投稿、ユーザーが残した投稿の新しいコメントなどを取得できます。
Instagram APIのさらなる例は、リソースページでご覧いただけます。

結論として、Data365のInstagram APIは、多くの公開データを取得するのに役立つ信頼できるツールです。私たちは、これはあなたのビジネス成長にとって素晴らしい選択であると確信しています。