跳转到主要内容
GET
Get an analytics dashboard

请求规范

  • 方法与路径: GET /apis/v1/social/analytics/dashboard
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/social/analytics/dashboard
  • profileId: query; 可选
  • platform: query; 可选
  • fromDate: query; 必填
  • toDate: query; 必填
  • compare: query; 可选
  • topPosts: query; 可选
  • recentPosts: query; 可选
  • Runtime 事实版本: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

当前未提供请求参考价格;请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

profileId
string

One of your profiles (prf_...). Defaults to your default profile when neither profileId nor accountId is sent.

Pattern: ^prf_[0-9A-Za-z]{22}$
platform
string
默认值:all

Platform to cover (e.g. "instagram"), or "all".

fromDate
string<date>
必填

First day of the window (YYYY-MM-DD, inclusive).

toDate
string<date>
必填

Last day of the window (YYYY-MM-DD, inclusive). May equal fromDate. The window covers at most 366 days.

compare
enum<string>

Set to "previous_period" to also return previousTotals and previousFollowers for the window of the same length that ends the day before fromDate.

可用选项:
previous_period
topPosts
integer
默认值:5

How many top posts to return, ranked by engagement (likes, comments, shares and saves, the same sum as daily engagement).

必填范围: 0 <= x <= 25
recentPosts
integer
默认值:10

How many of the most recently published posts to return.

必填范围: 0 <= x <= 25

响应

Dashboard for the window

daily
object[]
必填

One entry per day of the window, days without data included as zeros.

dataAsOf
string<date-time> | null
必填

When the most recently synced account in scope was last synced. Null if none has synced yet.

dateRange
object
必填
followers
object
必填
recentPosts
object[]
必填
topPosts
object[]
必填
totals
object
必填
previousFollowers
object
previousTotals
object