跳转到主要内容
GET
Get post analytics

请求规范

  • 方法与路径: GET /apis/v1/social/analytics/posts
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/social/analytics/posts
  • postId: query; 可选
  • platform: query; 可选
  • profileId: query; 可选
  • accountId: query; 可选
  • source: query; 可选
  • fromDate: query; 可选
  • toDate: query; 可选
  • limit: query; 可选
  • page: query; 可选
  • sortBy: query; 可选
  • order: query; 可选
  • tags: 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.

查询参数

postId
string

Returns analytics for a single post. Accepts AIsa Post IDs, External Post IDs and the platform's native post ID. AIsa IDs are auto-resolved to External Post analytics.

platform
string

Filter by platform (default "all")

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}$
accountId
string

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
source
enum<string>
默认值:all

Filter by post source: late (posted via AIsa API), external (synced from platform), all (default)

可用选项:
all,
late,
external
fromDate
string<date>

Inclusive lower bound (YYYY-MM-DD). Defaults to 90 days ago if omitted. Max range is 366 days.

toDate
string<date>

Inclusive upper bound (YYYY-MM-DD). Defaults to today if omitted.

limit
integer
默认值:50

Page size (default 50)

必填范围: 1 <= x <= 100
page
integer
默认值:1

Page number (default 1)

必填范围: x >= 1
sortBy
enum<string>
默认值:date

Sort by date, engagement, or a specific metric. Platform-specific metrics (follows, reposts, reels_skip_rate, ig_reels_*, completion_rate, profile_views, website_clicks) sort a null value as 0.

可用选项:
date,
engagement,
impressions,
reach,
likes,
comments,
shares,
saves,
clicks,
views,
follows,
ig_reels_avg_watch_time,
ig_reels_video_view_total_time,
reposts,
reels_skip_rate,
completion_rate,
profile_views,
website_clicks
order
enum<string>
默认值:desc

排序顺序

可用选项:
asc,
desc
tags
string

Comma-separated tags (at most 20). Lists only posts created through AIsa that carry every listed tag, matched exactly and case-sensitively. Up to 200 published posts can match within the date range; more returns 400 asking to narrow fromDate and toDate. Ignored when postId is set.

响应

Analytics result

analytics
object
content
string
isAiGenerated
boolean

Instagram only: whether Instagram labeled the media as AI-generated. Absent when the platform did not report it.

isExternal
boolean
isSharedToFeed
boolean

Instagram reels only: whether the reel is also shared to the main feed. Absent when the platform did not report it.

latePostId
string | null

Original AIsa post ID if scheduled via AIsa

mediaAudioType
string

Instagram only: audio type of the media (MUSIC or ORIGINAL_SOUND). Absent when the platform did not report it.

mediaItems
object[]

All media items for this post. Carousel posts have one entry per slide.

  • Facebook and Instagram images and video covers whose Meta CDN links expired are re-read and served from AIsa storage (non-expiring).
  • Facebook and Instagram video file URLs, and LinkedIn media URLs, stay the platform's signed links and are refreshed on read once they lapse.
mediaProductType
string

Instagram only: the platform media product type (e.g. FEED, REELS, STORY, AD). Absent when the platform did not report it.

mediaType
enum<string> | null
可用选项:
image,
video,
carousel,
text
message
string | null

Human-readable status message for pending, partial, or failed states

platform
string
platformAnalytics
object[]
platformPostUrl
string<uri> | null
postId
string
publishedAt
string<date-time> | null
scheduledFor
string<date-time>
status
enum<string>

Overall post status. "partial" when some platforms published and others failed.

While any platform is still pending or processing, the post's own status is returned instead (usually scheduled or publishing), even if another platform already published.

A post with no published or failed platform (for example every platform cancelled) returns its own status with syncStatus unavailable and no platformAnalytics.

可用选项:
published,
failed,
partial,
scheduled,
publishing,
draft,
cancelled
syncStatus
enum<string>

Overall sync state across all platforms

可用选项:
synced,
pending,
partial,
unavailable
thumbnailUrl
string<uri> | null

Cover image URL. Facebook, Instagram and TikTok covers whose platform CDN link expired are re-read from the platform and served from AIsa storage, so that URL does not expire and can be cached.