Instagram APIの使用方法

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

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

Instagram APIリクエスト

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

POSTリクエストはデータを更新するためのタスク、つまり新しいInstagramデータをData365データベースに追加するか、既存のデータを更新するためのタスクです。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コールバック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ウェブフック

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

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

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