Chuyển đến nội dung chính
GET
Endpoint này cho phép bạn lấy thông tin về bất kỳ hồ sơ mạng xã hội công khai nào, ngay cả khi hồ sơ đó không được liên kết với tài khoản Ayrshare của bạn. Tính năng này khả dụng cho Bluesky, Facebook, Instagram, LinkedIn, X và YouTube. Đối với các hồ sơ đã liên kết với tài khoản Ayrshare của bạn, chúng tôi khuyến nghị sử dụng endpoint /analytics thay thế, vì nó cung cấp phân tích chi tiết hơn. Quan trọng: Để tìm kiếm một hồ sơ trên một nền tảng mạng xã hội cụ thể, tài khoản Ayrshare của bạn phải liên kết mạng xã hội đó. Ví dụ, để tìm kiếm bất kỳ hồ sơ Instagram nào, ví dụ @taylorswift, bạn phải liên kết Instagram với tài khoản Ayrshare của mình.
Tài khoản được tìm kiếm phải là công khai để truy cập dữ liệu. Các tài khoản mạng xã hội riêng tư không khả dụng.Dữ liệu vị trí chỉ khả dụng đối với các doanh nghiệp có vị trí công khai. Việc gắn thẻ vị trí trong Facebook hoặc Instagram yêu cầu có một vị trí khả dụng.

Tham số Header

Tham số Query

platforms
array
bắt buộc
Mảng chuỗi các nền tảng: bluesky, instagram, facebook, linkedin, twitter, hoặc youtube.
blueskyUser
string
Handle Bluesky đã được mã hóa URL. Ví dụ: “@ayrshare” hoặc “ayrshare”. Bắt buộc nếu “bluesky” có trong mảng platforms.
facebookUser
string
Tên Facebook Page đã được mã hóa URL. Ví dụ “@newyorkgiants” hoặc “newyorkgiants”. Facebook không cho phép các tài khoản cá nhân.Bắt buộc nếu “facebook” có trong mảng platforms.
instagramUser
string
Handle Instagram đã được mã hóa URL. Ví dụ: “@nygiants” hoặc “nygiants”. Lưu ý: Chỉ các tài khoản Instagram Business và Creator mới có thể được trả về.Bắt buộc nếu “instagram” có trong mảng platforms.
linkedinUser
string
Tên vanity của công ty LinkedIn (tổ chức) chẳng hạn như Linkedin hoặc linkedin-marketing-solutions.Bạn cũng có thể tra cứu một người bằng ID cá nhân LinkedIn của họ được lấy từ endpoint history, ví dụ những người đã thích một bài đăng. Một ID mẫu: urn:li:person:Z_yXaxh_EtBắt buộc nếu “linkedin” có trong mảng platforms.
twitterUser
string
Handle Twitter đã được mã hóa URL. Ví dụ: “@ayrshare” hoặc “ayrshare”.Bắt buộc nếu “twitter” có trong mảng platforms.
youtubeUser
string
Tên người dùng YouTube đã được mã hóa URL, ID kênh hoặc ID danh sách phát. Lưu ý, ID kênh thường bắt đầu bằng “UC” và ID danh sách phát bắt đầu bằng “PL”. Ví dụ, gửi tên người dùng “MelissaEtheridgeVEVO” hoặc ID kênh dưới dạng “UCpSUQewzOXg1F0zLmieKCqQ”.Bạn cũng có thể sử dụng handle YouTube được tìm thấy trong URL YouTube. Ví dụ, handle cho https://www.youtube.com/@mkbhd là “@mkbhd”. Hãy nhớ giữ ký hiệu @ để chỉ định handle.Bắt buộc nếu “youtube” có trong mảng platforms.