การค้นพบธุรกิจ

คุณสามารถใช้ API กราฟของ Instagram เพื่อรับเมตาดาต้าและเกณฑ์ชี้วัดพื้นฐานเกี่ยวกับบัญชีธุรกิจและบัญชีครีเอเตอร์อื่นๆ บน Instagram ได้

ข้อจำกัด

ระบบจะไม่ส่งคืนข้อมูลเกี่ยวกับบัญชีธุรกิจบน Instagram ที่มีการควบคุมอายุ

ตำแหน่งข้อมูล

API ประกอบด้วยตำแหน่งข้อมูลดังต่อไปนี้ โปรดดูเอกสารประกอบการอ้างอิงของตำแหน่งข้อมูลเพื่อดูข้อกำหนดของพารามิเตอร์และสิทธิ์การอนุญาต

• GET /{ig-user-id}/business_discovery

ตัวอย่าง

การดึงข้อมูลจำนวนผู้ติดตามและจำนวนสื่อของบัญชี

ตัวอย่างการสืบค้นนี้จะแสดงให้คุณเห็นถึงวิธีการดึงข้อมูลจำนวนผู้ติดตามและจำนวนอ็อบเจ็กต์สื่อที่เผยแพร่แล้วบนบัญชีธุรกิจบน Instagram ของ Blue Bottle Coffee โดยให้สังเกตว่าการสืบค้นของการค้นพบธุรกิจนั้นจะดำเนินการกับ ID ของบัญชีธุรกิจหรือบัญชีครีเอเตอร์บน Instagram (ซึ่งในกรณีนี้คือ 17841405309211844) ไม่ใช่ชื่อผู้ใช้ของบัญชีธุรกิจหรือบัญชีครีเอเตอร์บน Instagram ที่คุณพยายามจะดึงข้อมูล (ซึ่งก็คือ bluebottle ในตัวอย่างนี้)

ตัวอย่างคำขอ

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count}&access_token={access-token}"

ตัวอย่างการตอบกลับ

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram Account ID
  },
  "id": "17841405309211844"  // ID of the Instagram account performing the query
}

การดึงข้อมูลสื่อ

เนื่องจากคุณสามารถสร้างคำขอที่ซ้อนกันได้โดยระบุจุดเชื่อมโยงผ่านพารามิเตอร์ fields คุณสามารถร้องขอจุดเชื่อมโยง media ของบัญชีธุรกิจหรือบัญชีครีเอเตอร์เป้าหมายเพื่อดึงข้อมูลอ็อบเจ็กต์สื่อที่เผยแพร่แล้วทุกรายการของบัญชีดังกล่าวได้

ตัวอย่างคำขอ

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media}&access_token={access-token}"

ตัวอย่างการตอบกลับ

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        ... // results truncated for brevity
      ],
    "id": "17841401441775531"
  },
  },
  "id": "17841405309211844"
}

การดึงข้อมูลเกณฑ์ชี้วัดพื้นฐานของสื่อ

คุณสามารถใช้ทั้งคำขอที่ซ้อนกันและการขยายเงื่อนไขในช่องเพื่อแสดงช่องสาธารณะสำหรับอ็อบเจ็กต์สื่อของบัญชีธุรกิจหรือบัญชีครีเอเตอร์ได้ โปรดทราบว่าการดำเนินการนี้จะไม่ทำให้คุณมีสิทธิ์การอนุญาตในการเข้าถึงอ็อบเจ็กต์สื่อโดยตรง ดังนั้นการดำเนินการ GET กับสื่อบน Instagram ที่ส่งคืนมาจะไม่สำเร็จเนื่องจากมีสิทธิ์การอนุญาตไม่เพียงพอ

ตัวอย่างเช่น นี่คือวิธีการดึงข้อมูลจำนวนความคิดเห็นและการกดถูกใจของอ็อบเจ็กต์สื่อแต่ละรายการที่เผยแพร่โดย Blue Bottle Coffee:

ตัวอย่างคำขอ

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}}&access_token={access-token}"

ตัวอย่างการตอบกลับ

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5841,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2998,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3644,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
        {
          "comments_count": 60,
          "like_count": 9347,
          "id": "17899363132086521"
        },
        {
          "comments_count": 63,
          "like_count": 6913,
          "id": "17893114378137541"
        },
        {
          "comments_count": 16,
          "like_count": 2791,
          "id": "17886057709171561"
        },
        {
          "comments_count": 15,
          "like_count": 3895,
          "id": "17856337633208377"
        },
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405976406927"
}