跳转到主要内容
GET
此端點可讓您擷取任何公開社群媒體個人檔案的資訊,即使該個人檔案並未連結至您的 Ayrshare 帳號。此功能支援 Bluesky、Facebook、Instagram、LinkedIn、 X 與 YouTube。 若是已連結到您 Ayrshare 帳號的個人檔案,我們建議改用 /analytics 端點,因為它可提供更詳細的分析資料。 重要:若要在特定社群平台上搜尋個人檔案,您的 Ayrshare 帳號必須連結該社群網路。 例如,若要搜尋任何 Instagram 個人檔案(例如 @taylorswift),您必須先將 Instagram 連結到您的 Ayrshare 帳號。
被搜尋的帳號必須是公開的,才能存取其資料。私人社群帳號不支援。位置資料僅適用於具有公開位置的商家。 在 Facebook 或 Instagram 中標記位置也需要有可用的位置資料。

標頭參數

查詢參數

platforms
array
必填
平台字串陣列:blueskyinstagramfacebooklinkedintwitteryoutube
blueskyUser
string
經 URL 編碼的 Bluesky 帳號代號。例如:“@ayrshare” 或 “ayrshare”。如果 platforms 陣列中包含 “bluesky” 則為必填。
facebookUser
string
經 URL 編碼的 Facebook Page 名稱。例如 “@newyorkgiants” 或 “newyorkgiants”。 Facebook 個人帳戶不被 Facebook 允許使用。如果 platforms 陣列中包含 “facebook” 則為必填。
instagramUser
string
經 URL 編碼的 Instagram 帳號代號。例如:“@nygiants” 或 “nygiants”。 注意:只能回傳 Instagram Business 與 Creator 帳號。如果 platforms 陣列中包含 “instagram” 則為必填。
linkedinUser
string
LinkedIn 公司(組織)的專屬名稱(vanity name),例如 Linkedinlinkedin-marketing-solutions您也可以使用從 history 端點取得的 LinkedIn person ID 來查詢個人,例如對貼文按讚的使用者。範例 ID:urn:li:person:Z_yXaxh_Et如果 platforms 陣列中包含 “linkedin” 則為必填。
twitterUser
string
經 URL 編碼的 Twitter 帳號代號。例如:“@ayrshare” 或 “ayrshare”。如果 platforms 陣列中包含 “twitter” 則為必填。
youtubeUser
string
經 URL 編碼的 YouTube 使用者名稱、頻道 ID 或播放清單 ID。注意,頻道 ID 通常以 “UC” 開頭,播放清單 ID 則以 “PL” 開頭。例如,可傳送使用者名稱 “MelissaEtheridgeVEVO” 或 頻道 ID “UCpSUQewzOXg1F0zLmieKCqQ”。您也可以使用 YouTube URL 中的 handle。 例如,https://www.youtube.com/@mkbhd 的 handle 就是 “@mkbhd”。 請務必保留 @ 符號以標示這是 handle。如果 platforms 陣列中包含 “youtube” 則為必填。