Skip to main content
GET
此端點會取得目前驗證使用者或 User Profile 的詳細資訊,包括:
  • 所有已連結社群媒體帳號的完整清單
  • 社群媒體使用者名稱與個人檔案資訊
  • 帳號狀態與用量指標
回傳的資料反映的是上次重新整理時已連結社群網路的狀態,並會在使用者連結或解除連結社群媒體帳號時更新。
回應快取。 回應最多會快取 60 秒。lastUpdated 與 nextUpdate 欄位描述的是該快取視窗:lastUpdated 是此快照建立的時間,nextUpdate 是它到期的時間。nextUpdate 是快取到期標記,而非就緒訊號。 每一次回應都會標上這個欄位,即使該回應的 displayNames 尚未列出你剛才收到通知的帳號,因此它無法告訴你新連結的帳號何時完成傳播。如果你正在為剛建立連結的 social webhook 進行對帳,請持續輪詢,直到你預期的帳號真的出現在 displayNames 中——不要把單次回應,或 nextUpdate 的到來,視為連結不存在或已完成的確認。
Threads 的 username 與 displayName。 在 displayNames 的 Threads 項目中,username 是帳號的 handle(例如 ayrshare),displayName 是個人檔案上顯示的名稱(例如 Ayrshare)。兩者可能不同,因此請使用 username 或 profileUrl 來找到 Threads 帳號。
若未連結任何社群帳號,則不會回傳 activeSocialAccounts。 若要取得特定 User Profile 的資料,請在標頭中加入 Profile-Key。
  • 若你的業務需要一次取得所有 User Profile 的資料,請改用 /user/batch 端點。
  • 若你需要在使用者連結或解除連結社群帳號時收到通知,請參閱 /webhooks 端點。

標頭參數

Query 參數

boolean
預設值:false
回傳額外的 Instagram 詳細資訊,例如帳號類型(business 或 creator)及已使用配額。 除非你需要這些額外資料,否則不建議使用,因為會拖慢回應時間。

每月發文配額

回應會顯示此個人資料的每月發文配額已使用多少:
  • monthlyPostCount:本月已計入配額的貼文數。
  • monthlyPostQuota:每月上限。當配額為 10,000 或以上時(例如 Business 方案),會省略此欄位。上限仍然適用。
計數會在每月 1 日 00:07 UTC 重設,而非你的帳單日期。失敗的發文嘗試也會計入。monthlyApiCalls 是另一個計數器,並非發文配額。關於哪些項目會計入,以及配額用完時會發生什麼情況,請參閱我可以發多少貼文與呼叫多少 API?。