Skip to main content
GET
Lấy các quảng cáo đã được boost cho một bài đăng Instagram cụ thể. Endpoint boosted ads này cung cấp thông tin chi tiết về các quảng cáo đã boost, bao gồm trạng thái, chi phí hiện tại, các chỉ số hiệu suất (phân tích) và liên kết xem trước.
  • Các chỉ số là tổng thời gian thực cho quảng cáo. Nếu bạn cần dữ liệu lịch sử, hãy sử dụng endpoint get ad history.
  • URL previewLink cho phép bạn chia sẻ quảng cáo xem trước với đồng nghiệp, để họ sẽ thấy quảng cáo trong 24 giờ trên các định dạng Instagram khác nhau. Lượt xem quảng cáo của đồng nghiệp sẽ không được tính vào chi phí quảng cáo của bạn.

Tham số Header

Tham số Query

string
bắt buộc
Lấy tất cả quảng cáo trong tài khoản có ID này.ID tài khoản quảng cáo, có hoặc không có tiền tố act_ (1234567890 hoặc act_1234567890).Bắt buộc nếu adId, socialPostId, hoặc postId không được đặt.
string
bắt buộc
Lấy một quảng cáo với ad ID.Bắt buộc nếu accountId, socialPostId, hoặc postId không được đặt.
string
bắt buộc
Lấy các quảng cáo với ID bài đăng xã hội Instagram.Bắt buộc nếu accountId, adId, hoặc postId không được đặt.
number
mặc định:25
Lấy tối đa limit quảng cáo. Tối đa là 300; các giá trị cao hơn sẽ bị giới hạn ở mức 300.
string
bắt buộc
Lấy các quảng cáo với Ayrshare post ID.Bắt buộc nếu accountId, adId, hoặc socialPostId không được đặt.
string
mặc định:"all"
Lọc quảng cáo theo trạng thái. Bỏ qua tham số này để trả về quảng cáo thuộc mọi trạng thái. Các giá trị hợp lệ:
  • active
  • paused
  • deleted
  • archived