IGハッシュタグ付きのトップメディア

ハッシュタグが付けられた最も人気のある写真および動画IGメディアオブジェクトのコレクションを表します。

人気度は、www.instagram.comのハッシュタグ検索でのトップ投稿を決定するのと同じ手法を使用して、閲覧と閲覧者のやり取りの両方から決定します。

作成

この操作はサポートされていません。

読み取り

ハッシュタグの付いた最も人気のあるメディアを取得する

GET /{ig-hashtag-id}/top_media?user_id={user-id}&fields={fields}

ハッシュタグでタグ付けされている人気上位の写真および動画IGメディアオブジェクトを返します。

クエリ文字列パラメーター

• {user_id} (必須) — クエリを実行するInstagram BusinessまたはクリエイターアカウントのID。
• {fields} -値を返したいフィールドのコンマ区切りリスト。「値が返されるフィールド」をご覧ください。

制限

• このエッジは公開写真および公開動画のみ返します。
• 宣伝/広告メディアは返しません。
• 応答は、ページあたりの結果が最大50件のlimitでページネーションされます。
• クエリできる一意のハッシュタグは7日間で最大30件です。
• 返されたメディアオブジェクトのusernameフィールドをリクエストすることはできません。
• このエンドポイントは、ページネーション結果のafterカーソルのみを返します。beforeカーソルは含まれません。また、afterカーソル値は各ページで常に同じですが、結果セットにおける結果の次のページの取得にも使用できます。

要件

応答

IGメディアオブジェクトの配列。結果が多い場合はページネーションされます。

値が返されるフィールド

fieldsパラメーターを使用して、返されたメディアオブジェクトの以下のフィールドをリクエストすることができます:

• caption
• children (アルバムIGメディアの場合のみ返されます)
• comments_count
• id
• like_count (v10.0以前の呼び出し: メディア所有者が「いいね！」数を非表示にしている場合、値は0になります。v11.0以降の呼び出し: メディア所有者が「いいね！」数を非表示にしている場合、フィールドは省略されます。)
• media_type
• media_url (アルバムIGメディアの場合は返されません)
• permalink
• timestamp (v7.0以降でのみ使用可能)

リクエストの例

GET graph.facebook.com/17873440459141021/top_media
  ?user_id=17841405309211844
  &fields=id,media_type,comments_count,like_count

応答の例

{
  "data": [
    {
      "id": "17880997618081620",
      "media_type": "IMAGE",
      "comments_count": 84,
      "like_count": 177
    },
    {
      "id": "17871527143187462"
      "media_type": "IMAGE",
      "comments_count": 24,
      "like_count": 57
    },
    {       
      "id": "17896450804038745"
      "media_type": "IMAGE",
      "comments_count": 19,
      "like_count": 36
    },
    ... // Results truncated for clarity
  ],
  "paging":
    {
      "cursors":
        {
          "after": "NTAyYmE4..."
        },
      "next": "https://graph.facebook.com/..."
    }
}

更新

この操作はサポートされていません。

削除

この操作はサポートされていません。