Get YouTube channel insights
curl --request GET \
--url https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"accountId": "<string>",
"breakdown": "<string>",
"dataDelay": "<string>",
"dateRange": {
"since": "2023-12-25",
"until": "2023-12-25"
},
"metricType": "time_series",
"metrics": {},
"platform": "facebook",
"success": true,
"unavailableMetrics": [
{
"message": "<string>",
"metric": "<string>",
"reason": "not_enrolled"
}
]
}{
"error": {
"code": "<string>",
"details": {},
"message": "<string>",
"param": "<string>",
"retryHint": "never",
"retryable": true,
"type": "<string>"
}
}AIsa Social
Get YouTube channel insights
Analytics. Read only; needs social:read. Ids are yours: accounts acc_..., profiles prf_..., posts pst_...; every other object id is checked against your accounts before the call.
Returns channel-scoped aggregate metrics from YouTube Analytics API v2. Saves you
from looping /apis/v1/social/analytics/youtube/daily-views over every video when you only need
channel totals.
Response shape matches /apis/v1/social/analytics/instagram/account-insights so the same client
handling works. Requires yt-analytics.readonly scope (412 with reauthorizeUrl if
missing). Data has a 2-3 day delay (endDate is clamped accordingly). Max 89 days,
defaults to last 30 days.
NOT exposed: impressions (Studio thumbnail impressions) and impressionsClickThroughRate.
YouTube Analytics API v2 does not expose these for any principal type, not channel
owners, not Partner Program channels, not content owners with CMS access. The only way
to get them is Studio CSV export. This is a Google-side limitation.
<!-- aisa-pricing:start -->
当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。
<!-- aisa-pricing:end -->
GET
https://api.aisa.one
/
apis
/
v1
/
social
/
analytics
/
youtube
/
channel-insights
Get YouTube channel insights
curl --request GET \
--url https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"accountId": "<string>",
"breakdown": "<string>",
"dataDelay": "<string>",
"dateRange": {
"since": "2023-12-25",
"until": "2023-12-25"
},
"metricType": "time_series",
"metrics": {},
"platform": "facebook",
"success": true,
"unavailableMetrics": [
{
"message": "<string>",
"metric": "<string>",
"reason": "not_enrolled"
}
]
}{
"error": {
"code": "<string>",
"details": {},
"message": "<string>",
"param": "<string>",
"retryHint": "never",
"retryable": true,
"type": "<string>"
}
}请求规范
- 方法与路径: GET /apis/v1/social/analytics/youtube/channel-insights
- 可用状态: enabled
- 请求 URL 模板:
https://api.aisa.one/apis/v1/social/analytics/youtube/channel-insights - accountId: query; 必填
- metrics: query; 可选
- fromDate: query; 可选
- toDate: query; 可选
- since: query; 可选
- until: query; 可选
- metricType: query; 可选
- Runtime 事实版本: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
{
"operationId": "get_aisa_social_apis_v1_social_analytics_youtube__b123b1",
"method": "GET",
"path": "/apis/v1/social/analytics/youtube/channel-insights",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [
{
"description": "One of your social accounts (acc_...).",
"in": "query",
"name": "accountId",
"required": true,
"schema": {
"pattern": "^acc_[0-9A-Za-z]{22}$",
"type": "string"
}
},
{
"description": "Comma-separated list. Defaults to \"views,estimatedMinutesWatched,subscribersGained,subscribersLost\".\n\nLive YouTube Analytics v2 metrics:\n - views\n - estimatedMinutesWatched\n - averageViewDuration (ratio - weighted mean computed across days)\n - subscribersGained\n - subscribersLost\n\nAIsa-synthesized from daily follower snapshots (cross-platform parity):\n - followers_gained\n - followers_lost",
"in": "query",
"name": "metrics",
"required": false,
"schema": {
"type": "string"
}
},
{
"description": "Start date (YYYY-MM-DD). Defaults to 30 days ago.",
"in": "query",
"name": "fromDate",
"required": false,
"schema": {
"format": "date",
"type": "string"
}
},
{
"description": "End date (YYYY-MM-DD). Defaults to today. YouTube Analytics has a 2-3 day delay,\nso the fetch is internally clamped to 3 days ago; any requested range extending\nbeyond that returns zero values for the tail days. The response's dateRange.until\nfield reflects your requested value.",
"in": "query",
"name": "toDate",
"required": false,
"schema": {
"format": "date",
"type": "string"
}
},
{
"description": "Alias of fromDate, kept for existing callers",
"in": "query",
"name": "since",
"required": false,
"schema": {
"format": "date",
"type": "string"
}
},
{
"description": "Alias of toDate, kept for existing callers",
"in": "query",
"name": "until",
"required": false,
"schema": {
"format": "date",
"type": "string"
}
},
{
"description": "\"total_value\" (default) returns aggregated totals.\n\"time_series\" returns per-day values in the \"values\" array.",
"in": "query",
"name": "metricType",
"required": false,
"schema": {
"default": "total_value",
"enum": [
"time_series",
"total_value"
],
"type": "string"
}
}
],
"security": [
{
"bearerAuth": []
}
],
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"description": "Included with your connected social accounts: AIsa does not charge per call.",
"kind": "no_customer_charge"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
费用与请求规则
当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
查询参数
One of your social accounts (acc_...).
Pattern:
^acc_[0-9A-Za-z]{22}$Comma-separated list. Defaults to "views,estimatedMinutesWatched,subscribersGained,subscribersLost".
Live YouTube Analytics v2 metrics:
- views
- estimatedMinutesWatched
- averageViewDuration (ratio - weighted mean computed across days)
- subscribersGained
- subscribersLost
AIsa-synthesized from daily follower snapshots (cross-platform parity):
- followers_gained
- followers_lost
Start date (YYYY-MM-DD). Defaults to 30 days ago.
End date (YYYY-MM-DD). Defaults to today. YouTube Analytics has a 2-3 day delay, so the fetch is internally clamped to 3 days ago; any requested range extending beyond that returns zero values for the tail days. The response's dateRange.until field reflects your requested value.
Alias of fromDate, kept for existing callers
Alias of toDate, kept for existing callers
"total_value" (default) returns aggregated totals. "time_series" returns per-day values in the "values" array.
可用选项:
time_series, total_value 响应
Channel insights data
Shared account-insights response envelope used by every platform-level analytics endpoint (/apis/v1/social/analytics/{facebook|instagram|youtube|linkedin|tiktok}/*). The name is historical - the shape was first shipped for Instagram and every new platform endpoint reuses it for response-shape consistency. The platform field echoes back which platform served the response.
One of your social accounts (acc_...).
Pattern:
^acc_[0-9A-Za-z]{22}$Breakdown dimension used (only present when breakdown was requested)
Show child attributes
Show child attributes
可用选项:
time_series, total_value Object keyed by metric name.
- For time_series: each metric has "total" (number) and "values" (array of {date, value}).
- For total_value: each metric has "total" (number) and optionally "breakdowns" (array of {dimension, value}).
Monetary metrics also carry "unit" and "currency". AIsa never rescales money: "total" and every "values[].value" are the platform's raw numbers in the stated unit.
Monetary metrics keep "values" even on metricType=total_value, because their "total" is the sum of the daily buckets the platform returned over the range. Keep the series to reconcile that sum against the platform's own reporting before invoicing on it.
A metric that could not be served is absent from this object and listed in "unavailableMetrics" instead, so an unavailable metric is never reported as a zero.
Show child attributes
Show child attributes
Platform that served this response.
可用选项:
facebook, instagram, youtube, linkedin, tiktok Requested metrics that could not be served. Present only when at least one metric is unavailable, absent otherwise.
Each listed metric is OMITTED from "metrics" rather than reported as 0, which is how an unavailable metric is distinguished from a genuine zero. The request itself still succeeds with HTTP 200.
Show child attributes
Show child attributes