Tổng quan Ayrshare API - Ayrshare API Documentation

Social Media REST API cung cấp cho developer quyền truy cập lập trình đến nhiều mạng xã hội thông qua một giao diện hợp nhất duy nhất. Thông qua social API của Ayrshare, bạn có thể quản lý các hoạt động mạng xã hội bao gồm tạo và xóa bài đăng, truy xuất phân tích, tương tác với bình luận và đánh giá, quản lý tin nhắn trực tiếp, tạo quảng cáo Facebook, và thực hiện các hành động mạng xã hội khác trên các nền tảng. API hiện hỗ trợ 13 mạng xã hội lớn: Bluesky, Facebook, Google Business Profile, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Telegram, Threads, TikTok, X (trước đây là Twitter), và YouTube. Bằng cách tích hợp với API này, developer có thể tự động hóa các tác vụ quản lý mạng xã hội trên tất cả các nền tảng này đồng thời. Dữ liệu yêu cầu và phản hồi API ở định dạng JSON, cho phép phân tích cú pháp và xử lý dễ dàng trong hầu hết các ngôn ngữ lập trình. Nếu bạn đang sử dụng Launch, Business, hoặc Enterprise Plan, xem Tổng quan Business Plan, Tổng quan Launch Plan, và endpoint /profiles API.

Chức năng chính

13 mạng xã hội được hỗ trợ.
Truy cập API an toàn bằng API Key duy nhất của bạn.
Đăng bài theo lịch đến các nền tảng mạng xã hội được kết nối.
Đăng bài tự động dựa trên lịch được xác định trước.
Hỗ trợ nội dung hình ảnh và video, bao gồm Reels, Stories, và Spotlight.
Xóa bài đăng trên các mạng xã hội được liên kết.
Phân tích tương tác bài đăng toàn diện (likes, shares, v.v.).
Chỉ số tài khoản mạng xã hội, bao gồm số người theo dõi và dữ liệu nhân khẩu học.
Quản lý bình luận: xem, thêm, và xóa bình luận bài đăng.
Rút gọn liên kết tùy chọn cho tất cả hoặc các URL cụ thể trong bài đăng.
Tích hợp Unsplash: thêm các hình ảnh cụ thể hoặc chọn ngẫu nhiên dựa trên từ khóa.
Tùy chọn tạo hashtag tự động bằng các từ khóa liên quan.
Theo dõi lịch sử bài đăng, bao gồm các bài đăng không phải qua Ayrshare.
Quản lý đánh giá: truy xuất, trả lời, và xóa các phản hồi đánh giá.
Tích hợp RSS feed để đăng nội dung tự động.
Thư viện phương tiện: tải lên và lưu trữ ảnh và video để sử dụng trong bài đăng.
Social Post Verification System để giữ an toàn cho tài khoản mạng xã hội của bạn.

Business Plan và Launch Plan

Các tính năng Business Plan và Launch Plan để quản lý nhiều người dùng và khách hàng:

Cho phép người dùng liên kết tài khoản mạng xã hội của riêng họ với nền tảng của bạn.
Đăng nhập một lần an toàn bằng OAuth để liên kết tài khoản nhanh chóng.
Tạo và xóa user profile lập trình qua API.
Truy cập phân tích người dùng nâng cao.
Hỗ trợ webhook cho các bản cập nhật thời gian thực.
Quản lý tin nhắn trực tiếp trên các nền tảng được hỗ trợ.
Tạo quảng cáo Facebook từ các bài đăng hiện có.

Liên hệ với chúng tôi để tìm hiểu thêm về Business Plan.

Ads API

Ads API cho phép bạn tạo quảng cáo Facebook từ các bài đăng hiện có.

Boost bài đăng để tiếp cận nhiều người hơn.
Quản lý quảng cáo và theo dõi hiệu suất.
Phân tích chi tiêu quảng cáo và tối ưu hóa chiến dịch.

Ads API

Khám phá Ads API

Messages API

Một Messaging API hợp nhất để tương tác với người dùng trong các cuộc trò chuyện trên các kênh mạng xã hội lớn: Facebook, Instagram, và X.

Gửi tin nhắn văn bản, hình ảnh, và video.
Truy xuất lịch sử cuộc trò chuyện hoàn chỉnh.
Thiết lập phản hồi tin nhắn tự động.
Nhận cập nhật thời gian thực qua webhooks cho các tin nhắn được nhận, phản ứng tin nhắn, xác nhận đã đọc.

API này đơn giản hóa việc tương tác với người dùng bằng cách tập trung hóa các thao tác nhắn tin cho nhiều kênh mạng xã hội. Tìm hiểu thêm…

Messages API

Khám phá API nhắn tin hợp nhất

Max Pack

Nhận thêm nhiều khả năng với add-on Max Pack:

Max Pack

Mở khóa các tính năng nâng cao như tạo nội dung bằng AI, phân tích nâng cao, và mở rộng hỗ trợ nền tảng với add-on Max Pack của chúng tôi.

Nếu bạn đang phát triển bằng Node.js, hãy xem video này về cách kết nối và xuất bản bài đăng lên X và Facebook.

Nếu bạn sử dụng Node.js, hãy xem code demo social API để bắt đầu xây dựng tích hợp social API của riêng bạn.

Social API Demo

Khám phá code demo Node.js của chúng tôi để khởi động tích hợp social API của bạn

Base URL

Base URL cho Ayrshare API giống nhau cho tất cả các endpoint. https://api.ayrshare.com/api

Cấp phép (Authorization)

Ayrshare xác thực các yêu cầu API qua một token Authorization được truyền trong HTTP header. Vui lòng chắc chắn gửi Bearer với API Key. API Key có thể được tìm thấy trong Ayrshare Dashboard bằng cách chuyển sang Primary Profile của bạn. Nếu bạn là người dùng Business hoặc Enterprise, bạn có thể tạo User Profile với Profile Key để quản lý nhiều khách hàng. Profile Key được sử dụng trong header của các yêu cầu. API Key cũng phải được sử dụng trong header của các yêu cầu cho User Profile.

Các gói Premium chỉ nên sử dụng API Key trong header của yêu cầu. Business và Enterprise plans nên sử dụng Profile Key trong header của yêu cầu khi tương tác thay mặt cho một User Profile.

Định dạng API Key

Authorization: Bearer API_KEY thay API_KEY bằng API Key Primary Profile của bạn, có thể tìm thấy trong Ayrshare Dashboard.

curl -H "Authorization: Bearer API_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

$headers = ["Authorization" => "Bearer API_KEY"];

headers := map[string]string{"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

Lấy API Key bí mật của bạn trong bảng điều khiển Ayrshare tại trang API Key được tìm thấy trong bảng điều hướng bên trái.Ví dụ, nếu API Key của bạn là 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAHeader của bạn nên bao gồm:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA

Định dạng Profile Key

Profile Key được sử dụng để tương tác thay mặt cho một User Profile. Điều này chỉ khả dụng cho các gói Business hoặc Enterprise. Profile-Key: PROFILE_KEY thay PROFILE_KEY bằng Profile Key của người dùng. Bao gồm Profile Key trong header là bắt buộc để tương tác thay mặt cho một User Profile. Thiếu API Key Primary Profile hoặc sử dụng Profile Key thay cho API Key trong header sẽ dẫn đến lỗi. Đây là cách cấu trúc header cho các yêu cầu API:

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

Tìm Profile Key trong Ayrshare Dashboard tại trang Profile Key được tìm thấy trong bảng điều hướng bên trái. Chuyển sang Profile bạn muốn sử dụng trong trang User Profile. Ngoài ra, Profile Key được trả về trong phản hồi của endpoint Create a User Profile.Sau đó bạn có thể sử dụng Profile Key trong header của các yêu cầu:Ví dụ, nếu Profile Key của bạn là AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EAHeader của bạn nên bao gồm cả API và Profile Key:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAProfile-Key: AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA

Thông tin xác thực X/Twitter BYO

Bắt đầu từ ngày 31 tháng 3 năm 2026, tất cả các thao tác X/Twitter qua Ayrshare yêu cầu thông tin xác thực OAuth 1.0a của riêng bạn. Sau khi liên kết tài khoản X của bạn qua OAuth, hãy truyền 2 header này cùng với các header Authorization (và Profile-Key tùy chọn) cho bất kỳ yêu cầu nào nhắm đến X/Twitter:

Header	Mô tả
`X-Twitter-OAuth1-Api-Key`	OAuth 1.0a API Key (Consumer Key) của bạn
`X-Twitter-OAuth1-Api-Secret`	OAuth 1.0a API Key Secret (Consumer Secret) của bạn

Các header này là bắt buộc sau ngày 31 tháng 3 năm 2026. Các yêu cầu đến các endpoint X/Twitter mà không có thông tin xác thực BYO hợp lệ sẽ bị từ chối.

Một cặp khóa, được sử dụng cho mọi yêu cầu. Bạn tạo một X Developer App cho mỗi tài khoản Ayrshare và sử dụng cùng các giá trị X-Twitter-OAuth1-Api-Key và X-Twitter-OAuth1-Api-Secret trên mỗi yêu cầu nhắm đến X, bất kể yêu cầu đó dành cho sub-profile nào (Profile-Key). Bạn không tạo hoặc xoay vòng khóa cho mỗi khách hàng hoặc mỗi người dùng cuối.

Xem Hướng dẫn thiết lập X BYO Key để biết hướng dẫn từng bước, ví dụ code, và khắc phục sự cố. Cùng hai header này áp dụng khi điều khiển X/Twitter qua MCP Server — xem Connect & Setup.

Content Type

Content Type luôn phải được đặt là Content-Type: "application/json" trừ khi endpoint chỉ định khác.

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

Nén

Ayrshare hỗ trợ nén cho tất cả các yêu cầu API. Để bật nén, hãy đặt header Accept-Encoding thành deflate, gzip, br.

  Accept-Encoding: "deflate, gzip, br"

Điều này được khuyến nghị khi gọi các phản hồi lớn hơn như endpoint /history.

Chỉ các phản hồi trên 1024 byte (1KB) mới được nén.
Thứ tự nén được sử dụng: Brotli (br) trước, sau đó gzip, rồi deflate. Brotli là thuật toán nén hiệu quả nhất.
Header phản hồi chứa mã hóa nội dung được sử dụng. Ví dụ: content-encoding: br nếu Brotli được sử dụng.
Tìm hiểu thêm về nén và lợi ích của việc sử dụng nén trong Ayrshare Blog.

Đừng quên giải nén phản hồi đúng cách bằng cách sử dụng mã hóa nội dung.

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -H "Accept-Encoding: deflate, gzip, br" \ 
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json",
  "Accept-Encoding" => "deflate, gzip, br"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

Các loại ID

Có nhiều loại ID được trả về, có thể được sử dụng trong nhiều endpoint khác nhau:

Ayrshare Post ID

ID này được Ayrshare tạo ra và được trả về từ endpoint /post trong trường id. ID này giúp dễ dàng lấy phân tích về bài đăng trên các mạng xã hội, thêm bình luận vào bài đăng, xóa bài đăng, v.v. Đây là ID bạn sẽ sử dụng thường xuyên nhất. Mỗi mạng xã hội gán ID duy nhất của riêng họ cho các bài đăng và bình luận. Các ID này được trả về trong trường postIds của endpoint /post hoặc /comments. Bạn có thể sử dụng các ID này, hoặc các ID bạn nhận được trực tiếp từ các mạng xã hội, để truy xuất dữ liệu, chẳng hạn như với analytics social post ID.

Ayrshare Comment ID

ID này được Ayrshare tạo ra và được trả về từ endpoint /comments trong trường id. ID này giúp dễ dàng lấy phân tích về bình luận trên các mạng xã hội, thêm phản hồi vào bình luận, xóa bình luận, v.v. Đây là ID bạn sẽ sử dụng thường xuyên nhất. Điều này thường được sử dụng nếu bạn muốn lấy chi tiết về một bình luận cụ thể được xuất bản qua Ayrshare. Mỗi mạng xã hội gán ID duy nhất của riêng họ cho các bình luận. Các ID này được trả về trong trường commentId của endpoint GET /comments. Điều này thường được sử dụng nếu bạn muốn lấy chi tiết về một bình luận cụ thể được xuất bản bên ngoài Ayrshare.

Mã lỗi

Lỗi sẽ trả về với mã trạng thái HTTP tiêu chuẩn. Để biết thêm thông tin:

Mã trạng thái HTTP

Tìm hiểu thêm về mã trạng thái HTTP

Lỗi chi tiết nằm trong phản hồi REST API cụ thể cho từng loại lệnh gọi. Để biết thêm thông tin:

Mã lỗi Ayrshare

Tìm hiểu thêm về mã lỗi dành riêng cho Ayrshare

Định dạng Timestamp

Ayrshare sử dụng Zulu Time, còn được gọi là UTC (Coordinated Universal Time) hoặc một chuỗi ngày được định dạng ISO 8601, để tham chiếu thời gian chính xác và rõ ràng trên các múi giờ khác nhau. Ví dụ, sử dụng định dạng YYYY-MM-DDThh:mm:ssZ và gửi dưới dạng 2026-07-08T12:30:00Z. Vui lòng xem utctime để biết thêm ví dụ. Bạn có thể chuyển đổi định dạng UTC sang thời gian địa phương của bạn trong ngôn ngữ lập trình bạn chọn. Ví dụ trong JavaScript:

const convertToLocalTime = (isoString) => {
  // Create a new Date object from the ISO string
  const date = new Date(isoString);

  // Extract local time components
  const localDate = date.toLocaleDateString();
  const localTime = date.toLocaleTimeString();

  // Combine the local date and time
  const localDateTime = `${localDate} ${localTime}`;

  return localDateTime;
};

Postman

Bạn có thể sử dụng Postman để kiểm thử các lệnh gọi REST API của mình.

Postman

Tìm hiểu cách sử dụng Postman với API của chúng tôi

Bài đăng, hình ảnh, và video ngẫu nhiên

Xem hướng dẫn khởi động nhanh về cách gửi bài đăng, hình ảnh, hoặc video ngẫu nhiên khi kiểm thử.

Packages

Chúng tôi có cả các gói Node.js & Python, hướng dẫn Bubble.io, Airtable, và Make có sẵn để giúp thực hiện các lệnh gọi RESTful dễ dàng hơn.

Node NPM Package

Tích hợp bằng gói NodeJS của chúng tôi

Python PyPI Package

Tích hợp bằng gói Python của chúng tôi

Airtable Guide

Tìm hiểu cách sử dụng Ayrshare với Airtable

Bubble Plugin & Guide

Tìm hiểu cách sử dụng Ayrshare với Bubble.io

Make Guide

Tìm hiểu cách sử dụng Ayrshare với Make

Notion Guide

Tìm hiểu cách sử dụng Ayrshare với Notion

FlutterFlow Guide

Tìm hiểu cách sử dụng Ayrshare với FlutterFlow

Retool Guide

Tìm hiểu cách sử dụng Ayrshare với Retool

​Chức năng chính

​Business Plan và Launch Plan

​Ads API

Ads API

​Messages API

Messages API

​Max Pack

Max Pack

​Xem cách sử dụng Social API

​Social API Demo

Social API Demo

​Base URL

​Cấp phép (Authorization)

​Định dạng API Key

​Định dạng Profile Key

​Thông tin xác thực X/Twitter BYO

​Content Type

​Nén

​Các loại ID

​Ayrshare Post ID

​Social Post ID

​Ayrshare Comment ID

​Social Comment ID

​Mã lỗi

Mã trạng thái HTTP

Mã lỗi Ayrshare

​Định dạng Timestamp

​Postman

Postman

​Bài đăng, hình ảnh, và video ngẫu nhiên

​Packages

Node NPM Package

Python PyPI Package

Airtable Guide

Bubble Plugin & Guide

Make Guide

Notion Guide

FlutterFlow Guide

Retool Guide

Chức năng chính

Business Plan và Launch Plan

Ads API

Messages API

Max Pack

Xem cách sử dụng Social API

Social API Demo

Base URL

Cấp phép (Authorization)

Định dạng API Key

Định dạng Profile Key

Thông tin xác thực X/Twitter BYO

Content Type

Nén

Các loại ID

Ayrshare Post ID

Social Post ID

Ayrshare Comment ID

Social Comment ID

Mã lỗi

Định dạng Timestamp

Postman

Bài đăng, hình ảnh, và video ngẫu nhiên

Packages