การค้นพบธุรกิจของผู้ใช้ Instagram

ช่วยให้คุณได้รับข้อมูลเกี่ยวกับผู้ใช้ Instagram อื่นที่เป็นบัญชี Instagram Business หรือครีเอเตอร์

การสร้าง

ระบบไม่รองรับการดำเนินการนี้

การอ่าน

GET /{ig-user-id}?fields=business_discovery.username({username})

ส่งคืนข้อมูลเกี่ยวกับผู้ใช้ Instagram อื่นที่เป็นบัญชี Instagram Business หรือครีเอเตอร์ ดำเนินการตามคำขอนี้กับผู้ใช้ Instagram ที่เป็น Instagram Business หรือครีเอเตอร์ที่ทำการสืบค้น และระบุธุรกิจเป้าหมายด้วยพารามิเตอร์ username

ข้อจำกัด

ระบบจะไม่ส่งคืนข้อมูลเกี่ยวกับผู้ใช้ Instagram ที่เป็น Instagram Business ที่มีการควบคุมอายุ

พารามิเตอร์สตริงการสืบค้น

  • {username} (จำเป็นต้องระบุ) - ชื่อผู้ใช้ของผู้ใช้ Instagram ที่เป็นธุรกิจหรือครีเอเตอร์บน Instagram ซึ่งคุณต้องการข้อมูล

สิทธิ์การอนุญาต

โทเค็นการเข้าถึงผู้ใช้ Facebook ที่มีสิทธิ์การอนุญาตต่อไปนี้

  • instagram_basic
  • instagram_manage_insights
  • pages_read_engagement หรือ pages_show_list

หากโทเค็นมาจากผู้ใช้ที่ได้รับอนุญาตให้มีบทบาทในเพจผ่านตัวจัดการธุรกิจ คุณจำเป็นต้องมีสิทธิ์การอนุญาตอย่างใดอย่างหนึ่งต่อไปนี้ด้วย

  • ads_management
  • pages_read_engagement
  • business_management

การขยายเงื่อนไขในช่อง

คุณสามารถใช้การขยายเงื่อนไขในช่องเพื่อรับช่องสาธารณะของผู้ใช้ Instagram เป้าหมายได้ โปรดดูรายการช่องสาธารณะในข้อมูลอ้างอิงของผู้ใช้ Instagram

ตัวอย่างคำขอที่มีการขยายเงื่อนไขในช่อง

การรับข้อมูลเกี่ยวกับ "Blue Bottle Coffee" ซึ่งเป็นผู้ใช้ Instagram ที่เป็น Instagram Business และใช้การขยายเงื่อนไขในช่องเพื่อส่งคำขอดูผู้ติดตามและจำนวนของสื่อ

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count}

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

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

การเข้าถึงจุดเชื่อมโยงด้วยการขยายเงื่อนไขในช่อง

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

การเรียกเวอร์ชั่น 10.0 และเวอร์ชั่นก่อนหน้าจนถึงวันที่ 7 กันยายน 2021: ช่อง like_count ในสื่อบน IG จะส่งคืนค่าเป็น 0 หากเจ้าของสื่อได้ซ่อนจำนวนการกดถูกใจของสื่อเอาไว้

การเรียกเวอร์ชั่น 11.0 ขึ้นไป และทุกเวอร์ชั่นในวันที่ 7 กันยายน 2021: หากสืบค้นสื่อบน IG ทางอ้อมผ่านตำแหน่งข้อมูลหรือการขยายเงื่อนไขช่องอื่น ระบบจะไม่ใส่ช่อง like_count ในการตอบกลับ API หากเจ้าของสื่อได้ซ่อนจำนวนการกดถูกใจของสื่อไว้ อย่างไรก็ตาม การสืบค้นสื่อบน IG โดยตรง (ซึ่งเจ้าของสื่อบน IG เท่านั้นที่ทำได้) จะส่งคืนจำนวนการกดถูกใจตามจริง แม้ว่าจะมีการซ่อนจำนวนการกดถูกใจก็ตาม

ตัวอย่างคำขอที่มีจุดเชื่อมโยง

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count,media}

ตัวอย่างการตอบกลับที่มีจุดเชื่อมโยง

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        {
          "id": "17911489846004508"
        }
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

การแบ่งหน้า

จุดเชื่อมโยง /media รองรับการแบ่งหน้าโดยอิงจากเคอร์เซอร์ ดังนั้นเมื่อเข้าถึงจุดเชื่อมโยงผ่านการขยายเงื่อนไขในช่อง การตอบกลับจะมีเคอร์เซอร์ before และ after หากการตอบกลับมีข้อมูลหลายหน้า อย่างไรก็ตาม การตอบกลับจะไม่เหมือนกับการแบ่งหน้าโดยอิงจากเคอร์เซอร์แบบมาตรฐาน เพราะจะไม่มีช่อง previous หรือ next ดังนั้นคุณจะต้องใช้เคอร์เซอร์ before และ after เพื่อสร้างสตริงการสืบค้น previous และ next ด้วยตนเองเพื่อเปิดดูชุดข้อมูลที่ส่งคืนมาในหน้าต่างๆ

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

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){media{comments_count,like_count}}

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

{
  "business_discovery": {
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5837,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2997,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3643,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
     ],
   },
   "id": "17841401441775531"
  },
  "id": "17841405976406927"
}

การอัพเดต

ระบบไม่รองรับการดำเนินการนี้

การลบ

ระบบไม่รองรับการดำเนินการนี้