> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Analytics zu einem sozialen Netzwerk
> Erhalten Sie Analytics und demografische Daten zum Social-Profil eines Nutzers, etwa Impressionen, Aufrufe und Follower
export const XByoNotice = () =>
Targeting X/Twitter? Starting March 31, 2026, all X operations require your own API credentials. After linking X via OAuth, include these 2 headers in your request:
X-Twitter-OAuth1-Api-Key — Your API Key (Consumer Key)
X-Twitter-OAuth1-Api-Secret — Your API Key Secret (Consumer Secret)
One-time setup per Ayrshare account. You create one X Developer App and reuse the same API Key and Secret across every sub-profile / end-user you link. You do not create a new app per customer.
Not linked yet? See the full setup guide to connect your X account.
Your keys are never logged or stored by Ayrshare.
;
export const PlansAvailable = ({plans = [], maxPackRequired}) => {
let displayPlans = plans;
if (plans && plans.length === 1) {
const lowerCasePlan = plans[0].toLowerCase();
if (lowerCasePlan === "business") {
displayPlans = ["Launch", "Business", "Enterprise"];
} else if (lowerCasePlan === "premium") {
displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
}
}
return
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.
{maxPackRequired && window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
Max Pack required
}
;
};
export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <>
API Key of the Primary Profile.
Format: Authorization: Bearer API_KEY
{!noProfileKey && (profileKeyRequired ?
Profile Key of a User Profile.
Format: Profile-Key: PROFILE_KEY
:
Profile Key of a User Profile.
Format: Profile-Key: PROFILE_KEY
)}
;
Erhalten Sie Analytics und demografische Daten zum Social-Profil eines Nutzers, etwa Impressionen, Aufrufe und Follower.
Derzeit verfügbar für Bluesky, Facebook Pages, Google My Business, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok, X/Twitter und YouTube.
**Facebook: Einige Reach- und Video-Kennzahlen wurden von Meta eingestellt (15. Juni 2026).** Meta hat die Insights-Kennzahlen für Unique Impressions und 3-Sekunden-Videoaufrufe (Unique) in allen Graph-API-Versionen entfernt. Das Facebook-`analytics`-Objekt liefert daher weder die Familie `pagePostsImpressions*` (`pagePostsImpressions`, `pagePostsImpressionsPaid`, `pagePostsImpressionsUnique`, `pagePostsImpressionsOrganicUnique`, `pagePostsImpressionsViral*`, `pagePostsImpressionsNonviral*`, `pagePostsServedImpressionsOrganicUnique`) noch `pageVideoViewsUnique` zurück. Verwenden Sie `pageMediaView` für Reach (ein Nachfolger für Total Unique Media Views ist geplant). `pagePostEngagements`, `pageVideoViews` und `pageVideoViewsPaid` sind nicht betroffen. Referenz: [Upcoming API Changes — June 15, 2026](/whatsnew/upcoming-api-changes#june-15-2026).
-
Analytics für Facebook-Seiten (etwa Demografie) sind nur für Seiten mit 100 oder mehr Likes verfügbar. Facebook aktualisiert seine Kennzahlen in der Regel alle 24 Stunden.
-
Instagram kann bis zu 48 Stunden benötigen, um die Analytics-Daten zu berechnen. Analytics zur Follower-Anzahl sind bei weniger als 100 Followern nicht verfügbar. Bei demografischen Kennzahlen werden nur die Top 45 zurückgegeben; in die Berechnungen fließen ausschließlich Betrachter ein, für die uns demografische Daten vorliegen. Demografische Daten werden nicht zurückgegeben, wenn der Instagram-Nutzer in den letzten 30 Tagen weniger als 100 Engagements hatte.
-
Beim Abruf von Instagram Social Analytics können demografische Informationen für bestimmte Kennzahlen in der Antwort fehlen. Demografische Informationen erscheinen, sobald die Kennzahlen in jeder Aufschlüsselung mehr als 100 Personen umfassen. Weitere Informationen finden Sie unter [Instagram Analytics Demographics Warning](/help-center/technical-support/instagram_analytics_demographics_warning).
-
LinkedIn unterstützt sowohl Analytics für Company Pages als auch für persönliche (Member-)Profile. Für persönliche Profile enthält das `analytics`-Objekt einen `followersCount` (Lifetime), das tägliche Follower-Wachstum in `followersDaily[]` sowie aggregierte Post-Kennzahlen (`impressionCount`, `uniqueImpressionsCount`, `likeCount`, `commentCount`, `shareCount`). Die `count`-Summen von LinkedIn sind eventuell konsistent, aber nicht unmittelbar; in manchen Fällen kann es 24–48 Stunden dauern. Die aggregierten Werte `shareCount`, `likeCount` und `commentCount` für persönliche Profile sind Best-Effort und können geringfügig von den in der LinkedIn-UI angezeigten Werten abweichen.
-
TikTok kann 24–48 Stunden benötigen, um seine Analytics-Daten zu aktualisieren, etwa Videoaufrufe, Demografie, Likes, Shares und Kommentare.
-
Weitere Informationen finden Sie im [Post-Analytics-Endpunkt](/apis/analytics/post).
## Header-Parameter
## Body-Parameter
Social-Media-Plattformen, für die Analytics abgerufen werden sollen. Akzeptiert ein Array von Strings mit den folgenden Werten:
```json theme={"system"}
{
"platforms": ["bluesky", "instagram", "facebook",
"gmb", "linkedin", "pinterest", "reddit",
"snapchat", "threads", "tiktok", "twitter", "youtube"]
}
```
Gibt an, wie viele Quartale historische Daten zurückgegeben werden sollen. Ein Quartal umfasst:
* 85 Tage für Facebook
* 90 Tage für Instagram, TikTok und YouTube
* 90 Tage für Snapchat (aufgrund von Snapchat-API-Einschränkungen auf max. 1 Quartal / 90 Tage begrenzt)
Verfügbar für die Plattformen Facebook, Instagram, Snapchat, TikTok und YouTube. Gültige Werte: 1–4.
Nur Werte größer als 0 aktivieren die Datumsfilterung.
**Datumsfilterung (Instagram & TikTok):** Die Datumsfilterung ist aktiv, wenn `daily=true` ODER `quarters > 0`.
Wenn weder `daily` noch `quarters` angegeben wird, werden alle Daten ohne Datumsfilter zurückgegeben.
Hinweis: `quarters: 0` wird jetzt so behandelt, als wäre kein Datumsbereich angegeben (alle Daten). Zuvor wurde `quarters: 0`
wie `quarters: 1` behandelt.
Wenn auf `true` gesetzt, werden Analytics-Daten als tägliche Zeitreihenwerte statt als aggregierte
Summen zurückgegeben. Diese Option ist nur für die Plattformen Facebook, Instagram, Snapchat, TikTok und YouTube verfügbar. Aufgrund
der größeren Datenmenge wird die Verwendung von [Kompression](/apis/overview#compression) empfohlen.
Für Instagram und TikTok aktiviert `daily=true` außerdem die Datumsfilterung mit einem standardmäßig
kürzeren Quartalsfenster.
**Instagram-Reach:** Bei `daily=true` gibt die Instagram-Antwort ein verschachteltes `reach`-Objekt zurück
(mit `period` und einer Zeitreihe `values`) anstelle des skalaren Felds `reachCount`,
das im Nicht-Daily-Modus zurückgegeben wird.
Bei TikTok-Analytics werden, wenn dieser Wert auf true gesetzt ist, nur die aggregierten 60-Tage-Summen für Kommentare, Shares und Aufrufe zurückgegeben (`commentCountTotal`, `shareCountTotal`, `viewCountTotal`).
Das führt im Vergleich zum Abruf der gesamten Analytics-Historie zu schnelleren Antwortzeiten.
Hinweis: Verwenden Sie diesen Parameter nicht zusammen mit `daily=true`, da beide inkompatibel sind.
Wichtig: Seit dem 1. März 2025 verwendet TikTok 60-Tage-Summen. Seit April 2026 nutzt TikTok
die quartalbasierte Datumsfilterung – verwenden Sie den Parameter `quarters`, um das Zeitfenster zu steuern (z. B. `quarters: 1` = 90 Tage, `quarters: 2` = 180 Tage). Details finden Sie unter [upcoming changes](/whatsnew/upcoming-api-changes#march-1-2025).
Plattformspezifische Optionen für YouTube-Analytics.
**`lifetime`** (boolean, Standard: `false`): Wenn auf `true` gesetzt, wird `lifetimeLikes` in die Antwort aufgenommen – die Summe der Likes aller öffentlichen Videos auf dem Kanal. Dieser Wert wird berechnet, indem alle Videos abgerufen und deren Like-Zahlen addiert werden. Bei Kanälen mit vielen Videos kann das länger dauern.
**Schwellenwert:** Kanäle mit mehr als 1.000 Videos geben `lifetimeLikes: null` sowie eine Warnung im obersten Array [`warnings`](#warnings) zurück. Das verhindert eine übermäßige API-Nutzung.
**Caching:** Pro Kanal, mit kürzeren TTLs für nicht-erfolgreiche Ergebnisse, damit Wiederholungen Zustandsänderungen zeitnah erkennen:
* Erfolgreicher `lifetimeLikes`-Wert: **24 Stunden**.
* Abbruch bei 1.000 Videos (Warnung `code: 445`): **1 Stunde** — kurz genug, damit ein Kanal, der Videos löscht, um unter den Schwellenwert zu fallen, keinen ganzen Tag auf einen echten Wert warten muss.
* Vorübergehende Fehler der YouTube Data API (Warnung `code: 446`): **nicht gecacht** — die nächste Anfrage versucht es erneut.
**Hinweis:** Gelöschte oder private Videos werden aus der Summe ausgeschlossen. Bei Kanälen, die Videos entfernt haben, kann die Summe daher von den „tatsächlichen" Lifetime-Likes abweichen.
**Anfragebeispiel:**
```json theme={"system"}
{
"platforms": ["youtube"],
"youtube": { "lifetime": true }
}
```
Nur X/Twitter. Mit diesem Parameter können Sie Beiträge eines bestimmten X/Twitter-Nutzers anhand seiner numerischen ID abrufen – statt aus Ihrem verknüpften Konto.
Um zum Beispiel alle Beiträge des Handles `@Google` zu erhalten, würden Sie die numerische userId `20536157` verwenden.
Die numerische userId eines beliebigen X/Twitter-Nutzers finden Sie über den Endpunkt [Brands Get User](/apis/listen/brand-user).
Hinweis: Verwenden Sie für diese Anfrage nur den API KEY im Header. Fügen Sie den Profile Key nicht hinzu.
Nur X/Twitter. Mit diesem Parameter können Sie Beiträge eines bestimmten X/Twitter-Nutzers anhand seines Handles abrufen – statt aus Ihrem verknüpften Konto.
Zum Beispiel, um alle Beiträge des Handles `@Google` zu erhalten.
Hinweis: Verwenden Sie für diese Anfrage nur den API KEY im Header. Fügen Sie den Profile Key nicht hinzu.
```bash cURL theme={"system"}
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"platforms": ["bluesky", "facebook", "gmb", "instagram", "linkedin",
"pinterest", "reddit", "snapchat", "threads", "tiktok", "twitter", "youtube"],
"quarters": 1}' \
-X POST https://api.ayrshare.com/api/analytics/social
```
```javascript JavaScript theme={"system"}
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/analytics/social", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${API_KEY}`
},
body: JSON.stringify({
platforms: [
"bluesky",
"facebook",
"gmb",
"instagram",
"linkedin",
"pinterest",
"reddit",
"snapchat",
"threads",
"tiktok",
"twitter",
"youtube"
],
quarters: 1
})
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
```
```python Python theme={"system"}
import requests
payload = {'platforms': ['bluesky', 'facebook', 'gmb', 'instagram',
'linkedin', 'pinterest', 'reddit', 'snapchat',
'threads', 'tiktok', 'twitter', 'youtube']}
headers = {'Content-Type': 'application/json',
'Authorization': 'Bearer API_KEY'}
r = requests.post('https://api.ayrshare.com/api/analytics/social',
json=payload,
headers=headers)
print(r.json())
```
```php PHP theme={"system"}
['bluesky', 'facebook', 'gmb', 'instagram', 'linkedin',
'pinterest', 'reddit', 'snapchat', 'threads', 'tiktok', 'twitter', 'youtube'] // required
]);
$curl = curl_init($apiUrl);
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_POSTFIELDS => $data
]);
$response = curl_exec($curl);
if ($response === false) {
echo 'Curl error: ' . curl_error($curl);
} else {
echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}
curl_close($curl);
```
```go Go theme={"system"}
package main
import (
"bytes"
"encoding/json"
"log"
"net/http"
)
func main() {
message := map[string]interface{}{
"platforms": []string{"bluesky", "facebook", "gmb", "instagram", "linkedin",
"pinterest", "reddit", "snapchat", "threads", "tiktok", "twitter", "youtube"},
}
bytesRepresentation, err := json.Marshal(message)
if err != nil {
log.Fatalln(err)
}
req, _ := http.NewRequest("POST", "https://api.ayrshare.com/api/social",
bytes.NewBuffer(bytesRepresentation))
req.Header.Add("Content-Type", "application/json; charset=UTF-8")
req.Header.Add("Authorization", "Bearer API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal("Error:", err)
}
res.Body.Close()
}
```
```csharp C# theme={"system"}
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
namespace SocialPOSTRequest_csharp
{
class Social
{
private static readonly HttpClient client = new HttpClient();
static async Task Main(string[] args)
{
string API_KEY = "API_KEY";
string url = "https://api.ayrshare.com/api/analytics/social";
client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);
string json = "{\"platforms\": [\"bluesky\", \"facebook\", \"gmb\", \"instagram\", " +
"\"linkedin\", \"pinterest\", \"reddit\", \"snapchat\", \"threads\", \"tiktok\", \"twitter\", \"youtube\"]}";
try
{
var content = new StringContent(json, Encoding.UTF8, "application/json");
HttpResponseMessage response = await client.PostAsync(url, content);
response.EnsureSuccessStatusCode();
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseBody);
}
catch (HttpRequestException e)
{
Console.WriteLine($"Error: {e.Message}");
}
}
}
}
```
Wenn kumulative Kennzahlen (z. B. Follower, Likes) vom sozialen Netzwerk vorübergehend nicht verfügbar sind, füllt die API sie automatisch aus gespeicherten Daten auf. Im plattformspezifischen `analytics`-Objekt können zwei optionale Felder erscheinen:
* **`backfilledFrom`** (String, ISO 8601) — Vorhanden, wenn eine oder mehrere kumulative Kennzahlen aus gespeicherten Daten ersetzt wurden. Der Zeitstempel gibt an, wann die gespeicherten Daten zuletzt aktualisiert wurden.
* **`recoveredFrom`** (String, ISO 8601) — Vorhanden, wenn die gesamte Analytics-Antwort aufgrund eines vollständigen API-Ausfalls aus gespeicherten Daten wiederhergestellt wurde. Der Zeitstempel gibt an, wann die gespeicherten Daten zuletzt aktualisiert wurden.
Gespeicherte Daten, die älter als 4 Tage sind, gelten als veraltet und werden nicht für Backfill oder Wiederherstellung verwendet.
**LinkedIn `reactions`:** Die auf Beitragsebene kumulative Kennzahl `reactions` (ein Objekt mit Reaktionszählungen pro Typ) unterliegt diesem ausschließlich auf leere Werte bezogenen Backfill. Wenn LinkedIn den Abruf der Reaktionen ratenbegrenzt, wird der Wert aus dem letzten erfolgreichen Snapshot übernommen – und `backfilledFrom` wird auf den Zeitstempel dieses Snapshots gesetzt – anstatt auf leer zurückzufallen.
**LinkedIn-Personal (Member) Analytics — erneute Verknüpfung erforderlich.** Persönliche LinkedIn-Profile, die vor der Einführung der Member-Analytics verknüpft wurden, verfügen nicht über die erforderlichen Analytics-Scopes. Social-Analytics-Anfragen für diese Profile liefern [Fehlercode `475`](/errors/errors-ayrshare#linkedin-analytics-errors) („Verknüpfen Sie Ihr LinkedIn-Profil erneut, um Analytics zu aktivieren"). Der Kontoinhaber muss sein LinkedIn-Profil auf der Seite Social Accounts erneut verknüpfen, um die neuen Scopes zu gewähren. Rechnen Sie nach der erneuten Verknüpfung mit einigen Minuten, bis Code `475` verschwindet (Ayrshare und LinkedIn cachen den Berechtigungsstatus jeweils kurz, in der Regel ca. 5–10 Minuten). Das Posten ist nicht betroffen.
**`warnings`** (Array von Objekten, optionales Feld auf oberster Ebene) — Nur vorhanden, wenn Ayrshare den Aufrufer über eine nicht-fatale Bedingung informieren muss (z. B. wurde eine Opt-in-Berechnung übersprungen). Fehlt in der Antwort, wenn nichts zu melden ist.
Jeder Eintrag ist ein strukturiertes Objekt, kein freier Text:
| Feld | Typ | Beschreibung |
| --------- | ------ | ------------------------------------------------------------------------------ |
| `action` | string | Operationskontext, der die Warnung erzeugt hat (z. B. `"analytics"`). |
| `status` | string | Immer `"warning"` für Einträge im Array `warnings`. |
| `code` | number | Stabiler Ayrshare-Warnungscode. Kann sicher im Client-Code abgeglichen werden. |
| `message` | string | Menschenlesbare Beschreibung. |
| `details` | string | Optionaler zusätzlicher Kontext zu dieser Warnungsinstanz. |
Bekannte Warnungscodes:
* `445` — `lifetimeLikes` wurde übersprungen, weil der YouTube-Kanal den Schwellenwert von 1.000 Videos überschreitet.
* `446` — `lifetimeLikes` nicht verfügbar, da die YouTube Data API für die Uploads-Playlist oder jeden `videos.list`-Batch Fehler zurückgab.
```json 200: Success Aggregate {3, 29, 121, 138, 203, 265, 275, 353, 390, 459, 478, 556, 596} theme={"system"}
{
"status": "success",
"bluesky": {
"analytics": {
"associated": { // Group of associated features and capabilities
"lists": 0, // Number of lists created by the user
"feedgens": 0, // Number of custom feeds generated by the user
"starterPacks": 0, // Number of starter packs created by the user
"labeler": false // Whether the user can create content labels
},
"avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:n7atr", // URL to user's profile picture
"created": "2024-12-14T20:39:21.343Z", // Timestamp when the account was created
"displayName": "Jumping Jack", // User's chosen display name
"followersCount": 15, // Number of users following this account
"followsCount": 5, // Number of users this account follows
"handle": "jack.bsky.social", // User's unique handle/username
"id": "did:plc:n7atrjd22xgkmgwig6dzlh", // Bluesky Social ID
"indexedAt": "2024-12-14T20:39:21.343Z", // Timestamp when this data was last indexed
"labels": [], // Array of content labels applied to the account
"postsCount": 20, // Number of posts made by the user
"viewer": { // Information about the viewing user's relationship
"muted": false, // Whether the viewing user has muted this account
"blockedBy": false // Whether this account has blocked the viewing user
}
},
"lastUpdated": "2025-01-11T20:05:05.214Z",
"nextUpdate": "2025-01-11T20:16:05.214Z"
},
"facebook": {
/* See specific time ranges - Lifetime unless otherwise noted */
"analytics": {
"about": "The best site to watch movies online.",
"birthday": "11/20/1985", // Applicable to Pages representing people
"caterory": "Movie", // The Page's category. e.g. Product/Service, Computers/Technology.
"emails": ["john@example.com"],
"engagement": { // If available, otherwise use fanCount
"count": 587, // Page like count, same as fanCount
"socialSentence": "587 people like this."
},
"fanCount": 587,
"followersCount": 587,
"id": "102619320979033",
"instagramBusinessAccount": {
"id": "17841452212707498" // Present if an Instagram account is linked with the Facebook page
},
"isPublished": true, // If the FB Page is publicly visable.
"link": "https://www.facebook.com/102619320979033",
"location": { // If a location is set
"street": "142 W 57th St",
"zip": "10019"
},
"name": "theGoodone",
"pageFollows": 2,
"pageMediaView": 929, // The number of times your content was played or displayed. Content includes videos, posts, stories and ads.
"pageMediaViewIsFromAds": 1, // The number of times your content was played or displayed from ads.
"pageMediaViewIsFromFollowers": 18, // The number of times your content was played or displayed from followers.
"pagePostEngagements": 20, // The number of interactions with your posts such as reactions, comments, shares and more.
// The pagePostsImpressions* family and pagePostsServedImpressionsOrganicUnique were retired by Meta (June 15, 2026); see the note at the top of this page.
// --- Page Video Data ---
"pageVideoCompleteViews30s": 32, // The number of times your Page's videos played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds. During a single instance of a video playing, we'll exclude any time spent replaying the video.
"pageVideoCompleteViews30sAutoplayed": 19, // Autoplayed 30s complete.
"pageVideoCompleteViews30sClickToPlay": 5, // Click to play 30s complete.
"pageVideoCompleteViews30sOrganic": 23, // Organic 30s complete.
"pageVideoCompleteViews30sPaid": 2, // Paid 30s complete.
"pageVideoCompleteViews30sRepeatViews": 3, // Repeat 30s complete.
"pageVideoCompleteViews30sUnique": 3, // Unique 30s complete.
"pageVideoRepeatViews": 4, // The number times of repeat views.
"pageVideoViews": 31, // The number of times your Page's videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds. During a single instance of a video playing, we'll exclude any time spent replaying the video.
"pageVideoViewsAutoplayed": 115, // Number of views that autoplayed on a user's screen
"pageVideoViewsOrganic": 32, // The number of organic video views.
"pageVideoViewsPaid": 6, // The number of times your Page's promoted videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds. For each impression of a video, we'll count video views separately and exclude any time spent replaying the video.
"pageVideoViewsByPaidNonPaid": { // Breakdown of view views by paid and non-paid
"total": 32,
"unpaid": 5,
"paid": 27
},
"pageVideoViewsByUploadedHosted": { // Daily video views on a page-level broken down by all variants of page-uploaded and page-hosted variants.
"pageUploaded": 147,
"pageUploadedFromCrossposts": 0,
"pageUploadedFromShares": 3,
"pageHostedCrosspost": 0,
"pageHostedShare": 0,
"pageOwned": 144
},
"pageVideoViewsClickToPlay": 32, // The number of times your Page's videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds, after people clicked play. During a single instance of a video playing, we'll exclude any time spent replaying the video.
"pageVideoViewsOrganic": 147, // The number of times your Page's videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds, by organic reach. During a single instance of a video playing, we'll exclude any time spent replaying the video.
"pageVideoViewsPaid": 0, // The number of times your Page's promoted videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds. For each impression of a video, we'll count video views separately and exclude any time spent replaying the video.
// pageVideoViewsUnique was retired by Meta (June 15, 2026); see the note at the top of this page.
"reactions": { // Total over past 180 days
"like": 1, // Like reactions - The "like" reaction counts include both "like" and "care" reactions.
"love": 1, // Love reactions
"anger": 1, // Anger reactions
"haha": 1, // Haha reactions
"wow": 1, // Wow reactions
"sorry": 1, // Sorry reactions
"total": 6 // Total number of reactions
},
"unreadMessageCount": 12, // Total unread FB Messages - if applicable
"username": "ayrshare",
"verified": true, // verified Facebook Page
"website": "https://www.theGoodone.com"
},
"quarters": 4,
"lastUpdated": "2024-04-25T21:28:10.877Z",
"nextUpdate": "2024-04-25T21:39:10.877Z"
},
/*
* Google Business Profile analytics totals are for the past 24 months.
*/
"gmb": {
"analytics":
{
"businessBookings": 0, // The number of bookings received from the business profile.
"businessConversations": 0, // The number of message conversations received on the business profile.
"businessDirectionRequests": 328, // The number of times a direction request was requested to the business location.
"businessFoodOrders": 0, // The number of food orders received from the business profile.
"businessImpressionsDesktopMaps": 153, // Business impressions on Google Maps on Desktop devices. Multiple impressions by a unique user within a single day are counted as a single impression.
"businessImpressionsDesktopSearch": 9675, // Business impressions on Google Search on Desktop devices. Multiple impressions by a unique user within a single day are counted as a single impression.
"businessImpressionsMobileMaps": 65, // Business impressions on Google Maps on Mobile devices. Multiple impressions by a unique user within a single day are counted as a single impression.
"businessImpressionsMobileSearch": 2070, // Business impressions on Google Search on Mobile devices. Multiple impressions by a unique user within a single day are counted as a single impression.
"callClicks": 2, // The number of times the business profile call button was clicked.
"websiteClicks": 134 // The number of times the business profile website was clicked.
},
"lastUpdated": "2024-04-25T21:28:10.877Z",
"nextUpdate": "2024-04-25T21:39:10.877Z"
},
"instagram": {
"analytics": {
/*
* Demographics: The following audience demographic data is only available
* for Intagram Users with at least 100 followers and engagements (last 30 days).
* Additionally, audience demographic data is only available when
* there is more than 100 people in each demographic category.
*/
"audienceCity": {
"Sydney, New South Wales": 2,
"London, England": 2,
"Bridgewater, New Jersey": 1,
"Puli, Nantou": 1
},
"audienceCityEngagedAudienceDemographics": {
"KIRKLAND, WASHINGTON": 3,
"LAKE BOSWORTH, WASHINGTON": 6,
"WASHOUGAL, WASHINGTON": 1,
"SEATTLE, WASHINGTON": 1,
"BURLINGTON, WASHINGTON": 2
},
"audienceCountry": {
"TW": 1,
"HK": 5,
"SG": 1,
"AU": 2
},
"audienceCountryEngagedAudienceDemographics": {
"DE": 0,
"GB": 0,
"US": 161
},
"audienceGenderAge": {
"F.18-24": 1,
"F.25-34": 6,
"F.35-44": 13,
"F.45-54": 16
},
"audienceGenderAgeEngagedAudienceDemographics": {
"F.13-17": 2,
"F.18-24": 11,
"F.25-34": 15,
"F.35-44": 24
},
"biography": "What to watch next? Get recommendations from your friends.",
"commentsCount": 6, // Total comments of the past 500 posts
"followersCount": 2, // Current total of followers - must have at least 100 followers to show
"followsCount": 19, // Current total of users followed
"id": "17941424040207809",
"igId": 24372260340, // legacy Instagram user ID - only available when Instagram is linked via Facebook Page
"igLoginId": "84739261504829371", // Instagram native user ID - only available when Instagram is linked via direct Instagram login
"likeCount": 116, // Total like of the past 500 posts
"mediaCount": 266, // Total media count on the account, always lifetime. Not filtered by `quarters` or `daily`.
"name": "theGoodone",
"profilePictureUrl": "https://scontent.fphl1-1.fna.fbcdn.net/v/t51.2885-15/74638883_536953567098493_7984001172816003072_n.jpg?_nc_cat=102&ccb=1-5&_nc_sid=86c713&_nc_ohc=krzDDPMjIZQAX-m1PsT&_nc_ht=scontent.fphl1-1.fna&edm=AL-3X8kEAAAA&oh=00_AT9uZhfkQyHWuThTgktvXxB8XEK_xV1_z72frRwtyGwHTA&oe=6246E46D",
"reachCount": 1, // 180 day period - Total number of unique users who have viewed at least one media. Scalar value returned in non-daily mode; when daily=true a nested `reach` object is returned instead (see the Daily success example).
"shareCount": 234, // Total number of shares on the Instagram account's content (posts, stories, reels, videos, live videos) aggregated per-day over the active date window. Follows the same 90-day rolling maximum as `viewsCount` and respects `quarters` / `daily`. Defaults to `0` for accounts where Meta does not return the `shares` metric.
"username": "thegoodone",
"viewsCount": 123212, // 90 day rolling window (maximum Meta allows on the User Metrics endpoint) - Total number of times the IG User's media have been viewed
"website": "https://www.mywebsite.com/"
},
"lastUpdated": "2022-05-09T00:52:30.530Z",
"nextUpdate": "2022-05-09T02:07:30.530Z"
},
/* LinkedIn Corporate: Lifetime analytics since start of account */
"linkedin": {
// The likeCount and commentCount fields do not count likes or comments made by companies, including the company that authored the share and are not decremented when a like or comment is deleted.
"analytics": {
"clickCount": 10,
"clicks": { // Only available for organizations that have career pages. This is a paid product.
"mobileCareersPageClicks": {
"careersPageJobsClicks": 2,
"careersPagePromoLinksClicks": 0,
"careersPageEmployeesClicks": 0
},
"careersPageClicks": {
"careersPagePromoLinksClicks": 5,
"careersPageBannerPromoClicks": 0,
"careersPageJobsClicks": 0,
"careersPageEmployeesClicks": 3
}
},
"commentCount": 12,
"engagement": 0.06060606060606061, // Number of organic clicks, likes, comments, and shares over impressions.
"followers": {
"organicFollowerCount": 7,
"paidFollowerCount": 2,
"totalFollowerCount": 12 // Total numuber might be higher than organic + paid. For total use this field.
},
"impressionCount": 264,
"likeCount": 6, // Number of likes. This field can become negative when members who liked a sponsored share later unlike it.
"shareCount": 3, // Number of mentions of the company in a share across LinkedIn
"uniqueImpressionsCount": 51,
"views": {
"aboutPageViews": 2,
"allDesktopPageViews": 8,
"allMobilePageViews": 8,
"allPageViews": 16,
"careersPageViews": 0, // Only available for organizations that have career pages
"desktopAboutPageViews": 0,
"desktopCareersPageViews": 0,
"desktopInsightsPageViews": 0,
"desktopJobsPageViews": 0,
"desktopLifeAtPageViews": 0,
"desktopOverviewPageViews": 8,
"desktopPeoplePageViews": 0,
"desktopProductsPageViews": 0,
"insightsPageViews": 0,
"jobsPageViews": 0,
"lifeAtPageViews": 0,
"mobileAboutPageViews": 2,
"mobileCareersPageViews": 0,
"mobileInsightsPageViews": 0,
"mobileJobsPageViews": 0,
"mobileLifeAtPageViews": 0,
"mobileOverviewPageViews": 6,
"mobilePeoplePageViews": 0,
"mobileProductsPageViews": 0,
"overviewPageViews": 14,
"peoplePageViews": 0,
"productsPageViews": 0
}
},
"lastUpdated": "2022-05-09T00:52:30.530Z",
"nextUpdate": "2022-05-09T02:07:30.530Z"
},
/* LinkedIn Personal (member) */
"linkedin": {
"description": "Founder",
"id": "Z_yXaxh_Et", // LinkedIn Personal ID
"name": "John Doe",
"platform": "linkedin",
"profileImageUrl": "https://media.licdn.com/dms/image/v2/C5103AQHORT70jVfKVA/profile",
"url": "https://www.linkedin.com/in/johndoe",
"userName": "johndoe",
"analytics": {
"commentCount": 410, // Aggregate comments
"followersCount": 4210, // Lifetime follower count
"followersDaily": [ // Daily follower growth (trailing 30 days)
{ "memberFollowersCount": 12, "dateRange": { "start": { "year": 2026, "month": 6, "day": 9 } } }
],
"impressionCount": 98000, // Aggregate impressions across posts
"likeCount": 2300, // Aggregate reactions
"shareCount": 190, // Aggregate reshares
"uniqueImpressionsCount": 41000 // Aggregate unique members reached
}
},
/* 90 days summary and daily details, board analytics full history */
"pinterest": {
"analytics": {
"board": {
"boardPinsModifiedAt": "2023-03-14T22:32:06Z",
"collaboratorCount": 0,
"createdAt": "2019-03-07T22:02:22Z",
"description": "",
"followerCount": 24,
"id": "4299544013183293",
"media": {
"pinThumbnailUrls": [
"https://i.pinimg.com/150x150/62/08/8b/62088b44a6152de7198efd3c2bc5c0.jpg",
"https://i.pinimg.com/150x150/ac/b7/c9/acb7c9f8096317180c20022e9b9b8a.jpg",
"https://i.pinimg.com/150x150/5a/d7/56/5ad756fb64a688934bd06853dff3a2.jpg",
"https://i.pinimg.com/150x150/5a/d7/56/5ad755db64a688934bd06853dff3a2.jpg",
"https://i.pinimg.com/150x150/a9/22/b6/a922ef5289639b617c24704d806998.jpg"
],
"imageCoverUrl": "https://i.pinimg.com/400x300/f8/ec/14/f8ec14e7770a53b2e3595773564950.jpg"
},
"name": "Places to Retire",
"pinCount": 64,
"privacy": "PUBLIC",
"username": "glueUp"
},
"clickthrough": 23,
"clickthroughRate": 0.34,
"closeup": 3,
"closeupRate": 0.43,
"engagement": 54,
"engagementRate": 0.43,
"fullScreenPlay": 23,
"fullScreenPlaytime": 42,
"impression": 12231,
"outboundClick": 256,
"outboundClickRate": 0.0.23,
"pinClick": 32,
"pinClickRate": 0.23,
"quartile95PercentView": 42,
"save": 45,
"saveRate": 23,
"video10sView": 902,
"videoAvgWatchTime": 234,
"videoMrcView": 23,
"videoStart": 34,
"videoV50WatchTime": 343,
"daily": [
{
"date": "2021-09-28",
"metrics": {
"SAVE_RATE": 0,
"OUTBOUND_CLICK_RATE": 0,
"IMPRESSION": 0,
"CLOSEUP_RATE": 0,
"ENGAGEMENT_RATE": 0,
"VIDEO_10S_VIEW": 0,
"VIDEO_AVG_WATCH_TIME": 0,
"ENGAGEMENT": 0,
"CLOSEUP": 0,
"FULL_SCREEN_PLAY": 0,
"SAVE": 0,
"PIN_CLICK_RATE": 0,
"OUTBOUND_CLICK": 0,
"VIDEO_MRC_VIEW": 0,
"VIDEO_V50_WATCH_TIME": 0,
"QUARTILE_95_PERCENT_VIEW": 0,
"VIDEO_START": 0,
"CLICKTHROUGH": 0,
"PIN_CLICK": 0,
"CLICKTHROUGH_RATE": 0,
"FULL_SCREEN_PLAYTIME": 0
}
}
]
},
"lastUpdated": "2022-05-09T00:52:30.530Z",
"nextUpdate": "2022-05-09T02:07:30.530Z"
},
/* Lifetime analytics since start of account */
"reddit": {
"analytics": {
"acceptFollowers": true, // Whether the user accepts new followers
"awardeeKarma": 125, // Karma points received from Reddit awards given by others
"awarderKarma": 45, // Karma points earned from giving awards to others
"canCreateSubreddit": true, // Whether the user has permission to create new subreddits
"coins": 250, // Number of Reddit coins the user currently has
"commentKarma": 2847, // Karma points earned from comments
"created": "2023-03-15T14:22:30.000Z", // Account creation date in ISO format
"friends": 12, // Number of Reddit friends the user has added
"hasSubscribed": true, // Whether the user has subscribed to any subreddits
"hasVerifiedEmail": true, // Whether the user has verified their email address
"hideFromRobots": false, // Whether the user has opted to hide their profile from search engines
"iconImg": "https://www.redditstatic.com/avatars/default_5.png", // URL to the user's avatar image
"id": "abc123def456", // Unique Reddit user ID
"inboxCount": 3, // Number of unread messages in the user's inbox
"isEmployee": false, // Whether the user is a Reddit employee
"isGold": false, // Whether the user has Reddit Gold/Premium subscription
"isMod": false, // Whether the user is a moderator of any subreddits
"isSponsor": false, // Whether the user is a Reddit sponsor
"isSuspended": false, // Whether the user's account is currently suspended
"linkKarma": 1567, // Karma points earned from submitted links/posts
"linkedIdentities": [ // Array of external identity providers linked to the account
"https://accounts.google.com"
],
"name": "RedditUser_Example123", // Reddit username
"over18": true, // Whether the user is over 18 (affects NSFW content visibility)
"profileImageSize": null, // Dimensions of the profile image (null if using default avatar)
"profileImageUrl": "https://i.redd.it/1234567890.png", // URL to custom profile image (empty if using default avatar)
"suspensionExpiration": null, // When account suspension expires (null if not suspended)
"totalKarma": 4414, // Total karma points (sum of link karma and comment karma)
"url": "https://www.reddit.com/user/RedditUser_Example123", // Direct URL to the user's Reddit profile
"verified": true // Whether the user has a verified Reddit account
},
"lastUpdated": "2025-07-29T00:31:47.080Z",
"nextUpdate": "2025-07-29T00:42:47.080Z"
},
"snapchat": {
"analytics": [
{
"adsSubscribes": 6, // Number of new subscribers acquired through ads
"avgViewTime": 5430, // Average view time in milliseconds per viewer
"favorites": 42, // Number of times content was favorited
"interactions": 156, // Number of times users interacted with content (taps, swipes)
"lensAvgViewTime": 8720, // Average view time in milliseconds for lens content
"lensPlays": 387, // Number of times lenses were played
"lensSubscribers": 18, // Total number of lens subscribers
"lensSubscribes": 5, // New lens subscribers
"lensUniques": 342, // Unique users who viewed lenses
"lensViewTime": 2832800, // Total lens view time in milliseconds
"lensViews": 432, // Total number of lens views
"mediaId": "43548e97-edf1-44f9-984a-0a38470875bc",
"playTime": 4268700, // Total play time in milliseconds
"profilePaidViews": 176, // Profile views from paid promotions
"profileViews": 834, // Total profile views
"replies": 23, // Number of replies to snaps/stories
"savedStoryAvgViewTime": 4950, // Average view time for saved stories in milliseconds
"savedStoryFavorites": 19, // Number of favorites on saved stories
"savedStorySnapCombinedUniques": 523, // Combined unique viewers of saved stories
"savedStorySnapCombinedViews": 712, // Combined views of saved stories
"savedStorySnapPaidUniques": 142, // Unique paid viewers of saved stories
"savedStorySnapPaidViews": 178, // Number of paid views of saved stories
"savedStorySubscribes": 8, // Number of subscribes from saved stories
"savedStoryUniques": 381, // Unique viewers of saved stories
"savedStoryViewTime": 1925850, // Total view time of saved stories in milliseconds
"savedStoryViews": 534, // Total views of saved stories
"scans": 98, // Number of Snapcode scans
"screenshots": 12, // Total number of screenshots taken
"shares": 36, // Number of times content was shared
"snapCombinedUniques": 734, // Combined unique viewers across snaps
"snapCombinedViews": 912, // Combined total views across snaps
"snapPaidUniques": 203, // Unique users who viewed snaps through paid promotion
"snapPaidViews": 267, // Number of paid snap views
"snapViewTime": 3784200, // Total snap view time in milliseconds
"socialUnlocks": 54, // Number of social unlocks
"spotlightAvgViewTime": 7230, // Average view time for Spotlight content in milliseconds
"spotlightCombinedUniques": 1247, // Combined unique viewers of Spotlight content
"spotlightCombinedViews": 1672, // Combined views of Spotlight content
"spotlightFavorites": 89, // Number of favorites on Spotlight content
"spotlightPaidUniques": 324, // Unique paid viewers of Spotlight content
"spotlightPaidViews": 412, // Number of paid views of Spotlight content
"spotlightSubscribes": 17, // Number of subscribes from Spotlight content
"spotlightUniques": 923, // Unique viewers of Spotlight content
"spotlightViewTime": 6765290, // Total view time of Spotlight content in milliseconds
"spotlightViews": 1260, // Total views of Spotlight content
"storyAvgViewTime": 5180, // Average view time for stories in milliseconds
"storyFavorites": 37, // Number of favorites on stories
"storySubscribers": 63, // Total number of story subscribers
"storySubscribes": 9, // New story subscribers
"storyUniques": 532, // Unique viewers of stories
"storyViews": 687, // Total views of stories
"subscribers": 143, // Total number of subscribers
"subscribes": 12, // New subscribers in the period
"swipeDowns": 21, // Number of swipe downs
"swipeUps": 43, // Number of swipe ups
"uniqueScreenshots": 9, // Number of unique users who took screenshots
"uniqueSessions": 672, // Number of unique sessions
"unsubscribes": 3, // Number of unsubscribes in the period
"viewTime": 4568300, // Total view time in milliseconds
"viewers": 723, // Number of unique viewers
"views": 879 // Total number of views
}
],
"lastUpdated": "2025-05-21T20:24:02.787Z",
"nextUpdate": "2025-05-21T20:35:02.787Z"
},
"threads": {
"analytics": {
"biography": "Post to social media with an API for yourself or your users: Instagram, Facebook, Twitter, TikTok, YouTube, and more",
"followersCount": 123,
"id": "92732926562",
"isEligibleForGeoRestrictions": true,
"isVerified": true,
"likes": 1121,
"name": "Ayrshare",
"profileImageUrlHttps": "https://scontent.cdninstagram.com/v/t51.2885-15/357665262_1390047998231434_3968630539537390629_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=104&ccb=1-7&_nc_sid=18de74&_nc_ohc=CHlHbGcrCaAQ7kNvwFqZTDz&_nc_oc=Adkj3ocdD7bHn5qffGIB20t1C7icONIg8CS7t4Bcf6sssxxve-k94PkCEFDXGsY6ND0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&edm=AP4hL3IEAAAA&oh=00_AfTPLboqmm2iSOGMfvS29exnVLn5U8y9QPnL6cwLQIcZ9g&oe=68915ECD",
"quotes": 2,
"replies": 196,
"reposts": 3,
"username": "ayrshare",
"views": 36721
},
"lastUpdated": "2025-04-27T15:40:28.885Z",
"nextUpdate": "2025-04-27T15:51:28.885Z"
},
"tiktok": {
"analytics": {
"addressClicks": 2, // Number of clicks collected on the Address button past 60 days
"appDownloadClicks": 1, // Number of clicks collected on the App Download button past 60 days
"audienceAges": [ // Updated by TikTok every 24-48 hours. Only available for TikTok accounts with at least 100 followers.
{
"percentage": 0.125,
"age": "45-54"
},
{
"percentage": 0.053,
"age": "55+"
},
{
"percentage": 0.138,
"age": "18-24"
},
{
"percentage": 0.36,
"age": "25-34"
},
{
"percentage": 0.324,
"age": "35-44"
}
],
"audienceCountries": [ // Updated by TikTok every 24-48 hours.
{
"percentage": 0.25,
"country": "NG"
},
{
"percentage": 0.75,
"country": "US"
}
],
"audienceGenders": [ // Updated by TikTok every 24-48 hours.
{
"percentage": 0.25,
"gender": "Female"
},
{
"percentage": 0.5,
"gender": "Male"
},
{
"percentage": 0.25,
"gender": "Other"
}
],
"bio": "My tiktok account",
"bioLinkClicks": 2, // Number of clicks collected on the Bio Link button past 60 days
"commentCountPeriod": "90 days",// quarters × 90 days when date range is active (e.g., "90 days", "180 days"); "60 days" when no date filter
"commentCountTotal": 1807, // TikTok caps profile-level lookback at 60 days. When `quarters` is set, this is the sum of lifetime engagement on posts created within the window (not engagement that occurred within the window).
"displayName": "Me and You",
"durationAverage": "10.72", // Deprecated. Will be removed in the future. Updated every 12 hours
"emailClicks": 0, // Number of clicks collected on the Email button past 60 days
"followerCount": 34, // Current follower count
"followingCount": 39, // Current following count
"leadSubmissions": 0, // Number of leads submitted past 60 days
"isBusinessAccount": true, // Whether the account is a business account
"isVerified": false, // Whether TikTok has provided a verified badge to the account after confirming that it belongs to the user it represents
"likeCountTotal": 2, // Genuine all-time total - the only TikTok profile metric that returns true lifetime data (sourced from TikTok's `total_likes` field).
"phoneNumberClicks": 0, // Number of clicks collected on the Phone Number button past 60 days
"profileViews": 79346, // Total profile views past 60 days
"shareCountPeriod": "90 days", // quarters × 90 days when date range is active (e.g., "90 days", "180 days"); "60 days" when no date filter
"shareCountTotal": 4, // TikTok caps profile-level lookback at 60 days. When `quarters` is set, this is the sum of lifetime engagement on posts created within the window (not engagement that occurred within the window).
"url": "https://vm.tiktok.com/ZTRuw5kM6/",
"userImage": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f123c4b57351e266",
"username": "@funnyone",
"videoCountTotal": 18, // Video total video count
"viewCountPeriod": "90 days", // quarters × 90 days when date range is active (e.g., "90 days", "180 days"); "60 days" when no date filter
"viewCountTotal": 1493 // TikTok caps profile-level lookback at 60 days. When `quarters` is set, this is the sum of lifetime engagement on posts created within the window (not engagement that occurred within the window).
},
"lastUpdated": "2022-05-09T00:52:30.530Z",
"nextUpdate": "2022-05-09T02:07:30.530Z"
},
/* Lifetime analytics since start of handle */
"twitter": {
"analytics": {
"created": "2019-11-12T15:22:57Z",
"description": "The best X account",
"displayName": "Ayrshare",
"followersCount": 11253,
"followingCount": 4242,
"id": 11842743387998232,
"isIdentityVerified": false, // Whether the account is a verified account
"likeCount": 561, // The number of likes created by this user
"listedCount": 17, // The number of lists that include this user
"location": "New York, NY",
"mostRecentTweetId": "1848848832072667321",
"name": "ayrshare",
"parody": false, // Whether the account is a parody account
"pinnedTweet": {
"text": "Happy Days!",
"id": "184884883207266733342",
"editHistoryTweetIds": [
"18488488320726673223"
]
},
"profileBannerUrl": "https://pbs.twimg.com/profile_banners/87253/15041912",
"profileImageUrl": "http://pbs.twimg.com/profile_images/1184/lvQZPpt_normal.png",
"protected": false, // User has chosen to protect their posts (private posts)
"receivesYourDM": true, // User has chosen to receive direct messages from others
"subscription": {
"subscribesToYou": false
},
"subscriptionType": "Premium", // Premium, PremiumPlus, None
"tweetCount": 2930, // The number of Tweets (including retweets) issued by the user
"url": "https://t.co/2XqeJiBy",
"username": "ayrshare",
"verified": true, // When true, indicates that the user has a verified account
"verifiedType": "blue", // "blue", "business", "none"
"website": "https://www.wondrouswaffles.com/"
},
"lastUpdated": "2022-05-09T00:52:30.530Z",
"nextUpdate": "2022-05-09T02:07:30.530Z"
},
"youtube": {
/* Lifetime analytics since start of channel */
"analytics": {
"averageViewDuration": 99, // The average length, in seconds, of video playbacks.
"averageViewPercentage": 127.06, // The average percentage of a video watched during a video playback.
"comments": 8,
"created": "2010-01-10T15:30:57Z",
"description": "This is the channel you want",
"dislikes": 1, // The number of times that users indicated that they disliked a video by giving it a negative rating.
"estimatedMinutesWatched": 72, // The number of minutes that users watched videos for the specified channel, content owner, video, or playlist.
"hiddenSubscriberCount": false, // Indicates whether the channel's subscriber count is publicly visible.
"isLinked": true,
"likes": 3, // Sum of likes across all videos on the channel within the date window determined by `quarters` (default: last 360 days). YouTube does not expose a lifetime channel-wide like counter. For a lifetime total, pass `youtube: { lifetime: true }` to get the `lifetimeLikes` field.
"lifetimeLikes": 8750, // Opt-in lifetime sum of likes across every public video on the channel. Shown here because this sample assumes the request included `youtube: { lifetime: true }` — the broad request example at the top of this page does NOT include that flag, so `lifetimeLikes` will be absent from responses to that example request. May be `null` if channel exceeds 1,000-video threshold. Cached for 24 hours per channel. Deleted and private videos are excluded.
"longUploadsStatus": "allowed",
"playlistId": "UUsp6CnxiNbUUYKZwXQ", // Primary playlist
"playlists": [ // All playlists associated with the connected channel
{
"description": "Playlist 1",
"id": "PLcLpmVOb3fDaf7",
"publishedAt": "2022-10-21T21:05:55Z",
"title": "Super Playlist",
"url": "https://www.youtube.com/playlist?list=PLcLpmVOb3fDaf7"
},
{
"description": "Playlist 2",
"id": "FLsp6CnxiNbU",
"publishedAt": "2012-02-26T19:16:55Z",
"title": "Favorites",
"url": "https://www.youtube.com/playlist?list=FLsp6CnxiNbU"
}
],
"privacyStatus": "public", // "public", "private", or "unlisted"
"shares": 34, // The number of times that users shared a video through the Share button
"subscriberCount": "67", // The number of subscribers that the channel has.
"subscribersGained": 34, // The number of times that users subscribed to a channel.
"subscribersLost": 2, // The number of times that users unsubscribed from a channel.
"thumbnailUrl": "https://yt3.ggpht.com/ytc/AMLnZu_lgyzY2EFDAP-no-rj",
"title": "The Best Channel",
"url": "https://www.youtube.com/@youtube53", // The Channel URL using the custom handle
"videoCount": "202",
"videosAddedToPlaylists": 23,
"videosRemovedFromPlaylists": 2,
"viewCount": "5", // The sum of the number of times all the videos in all formats have been viewed for a channel for all time.
"views": 44 // The number of video views that occurred in the last time period (quarters)
},
"quarters": 4,
"lastUpdated": "2022-05-09T00:52:30.530Z",
"nextUpdate": "2022-05-09T02:07:30.530Z"
}
// The top-level `warnings` array (see the "warnings" Info block above)
// would appear here as a sibling of `youtube`/`instagram`/etc. only when
// a non-fatal condition applies — e.g. `lifetimeLikes` being skipped
// because a channel exceeds the 1,000-video threshold. It is omitted in
// this success example because `lifetimeLikes: 8750` was computed
// successfully above.
}
```
```json 200: Success Daily {4, 612, 671, 1590, 1832} theme={"system"}
// Available for Facebook, Instagram, Snapchat, TikTok, and YouTube
// Recommended: https://www.ayrshare.com/docs/apis/overview#compression
{
"facebook": {
"analytics": {
"about": "One of the best stie ever",
"category": "Local Business",
"emails": [ "hello@ayrshare.com" ],
"fanCount": 48519,
"followersCount": 48681,
"id": "885526541490222",
"instagramBusinessAccount": {
"id": "1784145407231999"
},
"isPublished": true,
"link": "https://www.facebook.com/885526541490222",
"location": { // Physical location details for the Page
"city": "Rome",
"country": "Italy",
"latitude": 41.853696407098,
"longitude": 12.573806071995,
"street": "Via Vincenzo",
"zip": "00174"
},
"name": "Super Site",
"overallStarRating": 0, // The average star rating of the page.
"pageFollows": {
"period": "day",
"values": [
{
"value": 3,
"endTime": "2025-08-12T07:00:00.000Z"
},
{
"value": 3,
"endTime": "2025-08-13T07:00:00.000Z"
},
],
"total": 3
},
"pageMediaView": {
"period": "day",
"values": [
{
"value": 100,
"endTime": "2025-08-12T07:00:00.000Z"
},
{
"value": 200,
"endTime": "2025-08-13T07:00:00.000Z"
}
],
"total": 300
},
"pageMediaViewIsFromAds": {
"period": "day",
"values": [
{
"value": 22,
"endTime": "2025-08-12T07:00:00.000Z"
},
{
"value": 41,
"endTime": "2025-08-13T07:00:00.000Z"
}
],
"total": 63
},
"pageMediaViewIsFromFollowers": {
"period": "day",
"values": [
{
"value": 67,
"endTime": "2025-08-12T07:00:00.000Z"
},
{
"value": 29,
"endTime": "2025-08-13T07:00:00.000Z"
}
],
"total": 96
},
"pagePostEngagements": { // The number of interactions with your posts such as likes, comments, shares and more
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoCompleteViews30S": { // The number of times videos played for at least 30 seconds
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoCompleteViews30SAutoplayed": { // The number of times videos played for at least 30 seconds when autoplayed
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoCompleteViews30SClickToPlay": { // The number of times videos played for at least 30 seconds after clicking play
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoCompleteViews30SOrganic": { // The number of times videos played for at least 30 seconds through organic reach
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoCompleteViews30SPaid": { // The number of times videos played for at least 30 seconds through paid reach
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoCompleteViews30SRepeatViews": { // The number of times videos were replayed after playing for at least 30 seconds
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoCompleteViews30SUnique": { // The number of unique people who watched your videos for at least 30 seconds
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoRepeatViews": { // The number of times videos were replayed
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViewTime": { // Total time in seconds that videos were viewed
"period": "day",
"total": 2.33,
"values": [
{
"value": 2.33,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViews": { // The number of times your videos were viewed
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViews10S": { // The number of times videos played for at least 10 seconds
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViews10SAutoplayed": { // The number of times videos played for at least 10 seconds when autoplayed
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViews10SClickToPlay": { // The number of times videos played for at least 10 seconds after clicking play
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViews10SOrganic": { // The number of times videos played for at least 10 seconds through organic reach
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViews10SPaid": { // The number of times videos played for at least 10 seconds through paid reach
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViews10SRepeatViews": { // The number of times videos were replayed after playing for at least 10 seconds
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViews10SUnique": { // The number of unique people who watched your videos for at least 10 seconds
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViewsAutoplayed": { // The number of times your videos autoplayed
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViewsByPaidNonPaid": { // Breakdown of video views by paid vs non-paid distribution
"period": "day",
"values": [
{
"value": {
"total": 0,
"unpaid": 0,
"paid": 0
},
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": {
"total": 0,
"unpaid": 0,
"paid": 0
},
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViewsByUploadedHosted": { // Breakdown of video views by uploaded vs hosted content
"period": "day",
"values": [
{
"value": {
"pageUploaded": 0,
"pageUploadedFromCrossposts": 0,
"pageUploadedFromShares": 0,
"pageHostedCrosspost": 0,
"pageHostedShare": 0,
"pageOwned": 0
},
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": {
"pageUploaded": 0,
"pageUploadedFromCrossposts": 0,
"pageUploadedFromShares": 0,
"pageHostedCrosspost": 0,
"pageHostedShare": 0,
"pageOwned": 0
},
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViewsClickToPlay": { // The number of times people clicked play to view your videos
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViewsOrganic": { // The number of times your videos were viewed through organic reach
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
"pageVideoViewsPaid": { // The number of times your videos were viewed through paid reach
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-11-03T07:00:00.000Z"
},
{
"value": 0,
"endTime": "2024-11-04T08:00:00.000Z"
}
]
},
// pageVideoViewsUnique was retired by Meta (June 15, 2026); see the note at the top of this page.
"phone": "+39067265341",
"reactions": { // Breakdown of reactions on your Page's content
"like": 142,
"love": 9,
"wow": 1,
"haha": 0,
"sorry": 0,
"anger": 0,
"total": 152
},
"unreadMessageCount": 0,
"username": "ayrshare",
"verified": false,
"website": "http://www.ayrshare.com"
},
"quarters": 1,
"lastUpdated": "2024-03-19T17:48:21.329Z",
"nextUpdate": "2024-03-19T17:59:21.329Z"
},
"instagram": {
"analytics": {
"audienceCity": {
"KIRKLAND, WASHINGTON": 7,
"LAKE BOSWORTH, WASHINGTON": 20,
"BURLINGTON, WASHINGTON": 5,
"SEATTLE, WASHINGTON": 22,
"ARLINGTON HEIGHTS, WASHINGTON": 7,
},
"audienceCountry": {
"MM": 1,
"CA": 2,
"US": 2201,
"LK": 1
},
"audienceGenderAge": {
"F.13-17": 11,
"F.18-24": 83,
"M.13-17": 9,
"M.18-24": 85,
"M.65+": 10,
"U.55-64": 25,
"U.65+": 12
},
"biography": "Official Instagram feed for the best IG account",
"commentsCount": 552,
"followersCount": 2299,
"followsCount": 26,
"id": "17841407938064444",
"igId": 79483284444, // legacy Instagram user ID - only available when Instagram is linked via Facebook Page
"igLoginId": "84739261504829371", // Instagram native user ID - only available when Instagram is linked via direct Instagram login
"likeCount": 30808,
"mediaCount": 537,
"name": "Best IG Account",
"profilePictureUrl": "https://scontent-lga3-1.xx.fbcdn.net/v/t51.2885-15",
"reach": { // Returned only when daily=true (replaces the scalar `reachCount` from non-daily mode)
"period": "day", // Granularity of the time-series buckets
"values": [ // Per-day reach time-series
{
"value": 387,
"endTime": "2024-07-23T07:00:00.000Z"
},
{
"value": 46,
"endTime": "2024-07-24T07:00:00.000Z"
},
{
"value": 4,
"endTime": "2024-07-25T07:00:00.000Z"
}
]
},
"username": "instagram",
"website": "https://www.instagram.com"
},
"lastUpdated": "2024-07-25T16:09:33.608Z",
"nextUpdate": "2024-07-25T16:20:33.608Z"
},
"snapchat": {
"analytics": [
{
"adsSubscribes": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 0
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 0
}
],
"total": 0
},
"avgViewTime": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 7126
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 7003
}
],
"total": 14129
},
"favorites": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 4
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 3
}
],
"total": 7
},
"interactions": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 8
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 22
}
],
"total": 30
},
"lensAvgViewTime": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 3712
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 7837
}
],
"total": 11549
},
"lensDauOverMau": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 0.074
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 0.042
}
],
"total": 0.116
},
"lensDauOverWau": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 0.194
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 0.251
}
],
"total": 0.445
},
"lensPlays": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 11
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 45
}
],
"total": 56
},
"lensSubscribers": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 206
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 207
}
],
"total": 413
},
"lensSubscribersGained": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 3
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 1
}
],
"total": 4
},
"lensSubscribes": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 3
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 2
}
],
"total": 5
},
"lensUniques": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 30
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 5
}
],
"total": 35
},
"lensViewTime": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 1153
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 2231
}
],
"total": 3384
},
"lensViews": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 29
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 25
}
],
"total": 54
},
"mediaId": "6e9193cd-5013-478e-a272-d3d0e881f53f",
"playTime": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 5273
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 5763
}
],
"total": 11036
},
"profilePaidViews": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 2
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 0
}
],
"total": 2
},
"profileViews": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 25
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 44
}
],
"total": 69
},
"replies": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 0
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 2
}
],
"total": 2
},
"savedStoryAvgViewTime": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 5471
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 3408
}
],
"total": 8879
},
"savedStoryFavorites": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 2
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 0
}
],
"total": 2
},
"savedStorySnapCombinedUniques": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 19
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 22
}
],
"total": 41
},
"savedStorySnapCombinedViews": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 13
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 39
}
],
"total": 52
},
"savedStorySnapPaidUniques": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 3
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 0
}
],
"total": 3
},
"savedStorySnapPaidViews": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 8
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 4
}
],
"total": 12
},
"savedStorySubscribes": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 2
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 2
}
],
"total": 4
},
"savedStoryUniques": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 16
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 23
}
],
"total": 39
},
"savedStoryViewTime": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 2287
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 4385
}
],
"total": 6672
},
"savedStoryViews": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 14
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 12
}
],
"total": 26
},
"scans": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 4
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 5
}
],
"total": 9
},
"screenshots": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 0
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 6
}
],
"total": 6
},
"shares": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 4
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 2
}
],
"total": 6
},
"snapCombinedUniques": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 39
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 32
}
],
"total": 71
},
"snapCombinedViews": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 88
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 111
}
],
"total": 199
},
"snapPaidUniques": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 15
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 7
}
],
"total": 22
},
"snapPaidViews": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 10
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 16
}
],
"total": 26
},
"snapViewTime": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 3455
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 2858
}
],
"total": 6313
},
"socialUnlocks": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 2
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 0
}
],
"total": 2
},
"spotlightAvgViewTime": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 8990
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 5401
}
],
"total": 14391
},
"spotlightCombinedUniques": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 44
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 25
}
],
"total": 69
},
"spotlightCombinedViews": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 45
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 84
}
],
"total": 129
},
"spotlightFavorites": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 3
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 2
}
],
"total": 5
},
"spotlightPaidUniques": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 9
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 4
}
],
"total": 13
},
"spotlightPaidViews": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 13
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 4
}
],
"total": 17
},
"spotlightSubscribes": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 0
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 0
}
],
"total": 0
},
"spotlightUniques": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 33
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 18
}
],
"total": 51
},
"spotlightViewTime": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 6286
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 5193
}
],
"total": 11479
},
"spotlightViews": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 24
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 33
}
],
"total": 57
},
"storyAvgViewTime": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 6740
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 6862
}
],
"total": 13602
},
"storyFavorites": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 4
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 2
}
],
"total": 6
},
"storySubscribers": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 546
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 547
}
],
"total": 1093
},
"storySubscribersGained": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 3
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 3
}
],
"total": 6
},
"storySubscribes": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 2
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 1
}
],
"total": 3
},
"storyUniques": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 9
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 13
}
],
"total": 22
},
"storyViews": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 18
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 25
}
],
"total": 43
},
"subscribers": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 273
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 274
}
],
"total": 547
},
"subscribersGained": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 4
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 2
}
],
"total": 6
},
"subscribes": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 3
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 3
}
],
"total": 6
},
"swipeDowns": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 6
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 4
}
],
"total": 10
},
"swipeUps": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 5
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 11
}
],
"total": 16
},
"uniqueScreenshots": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 3
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 0
}
],
"total": 3
},
"uniqueSessions": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 34
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 11
}
],
"total": 45
},
"unsubscribes": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 0
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 0
}
],
"total": 0
},
"viewTime": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 11140
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 7310
}
],
"total": 18450
},
"viewers": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 42
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 53
}
],
"total": 95
},
"views": {
"period": "day",
"values": [
{
"endTime": "2026-01-21T00:00:00Z",
"value": 33
},
{
"endTime": "2026-01-22T00:00:00Z",
"value": 74
}
],
"total": 107
}
}
],
"lastUpdated": "2026-04-20T13:13:47.646Z",
"nextUpdate": "2026-04-20T13:24:47.646Z"
},
"tiktok": { // TikTok Analytics with "day" period - date range window determined by quarters parameter
"analytics": {
"addressClicks": { // Number of clicks collected on the Address button past 60 days
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2025-01-21T00:00:00.000Z"
},
{
"value": 0,
"endTime": "2025-01-20T00:00:00.000Z"
}
]
},
"appDownloadClicks": { // Number of clicks collected on the App Download button past 60 days
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2025-01-21T00:00:00.000Z"
},
{
"value": 0,
"endTime": "2025-01-20T00:00:00.000Z"
}
]
},
"audienceActivity": { // Hourly follower activity. Updated by TikTok every 24-48 hours after posting. Only available for TikTok accounts with at least 100 followers.
"period": "day",
"total": 14824,
"values": [
{
"value": [
{
"count": 12386,
"hour": "5"
},
{
"count": 2438,
"hour": "9"
}
],
"endTime": "2025-01-21T00:00:00.000Z"
}
]
},
"audienceAges": [ // Updated by TikTok every 24-48 hours after posting. Only available for TikTok accounts with at least 100 followers.
{
"percentage": 0.125,
"age": "45-54"
},
{
"percentage": 0.053,
"age": "55+"
},
{
"percentage": 0.138,
"age": "18-24"
},
{
"percentage": 0.36,
"age": "25-34"
},
{
"percentage": 0.324,
"age": "35-44"
}
],
"audienceCountries": [
{
"country": "SV",
"percentage": 0.003
},
{
"country": "US",
"percentage": 0.808
}
],
"audienceGenders": [
{
"percentage": 0.76,
"gender": "Female"
},
{
"percentage": 0.24,
"gender": "Male"
},
{
"percentage": 0,
"gender": "Other"
}
],
"bio": "This is the bio of the TikTok account",
"bioLinkClicks": { // Number of clicks collected on the Bio Link button past 60 days
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2025-01-21T00:00:00.000Z"
},
{
"value": 0,
"endTime": "2025-01-20T00:00:00.000Z"
}
]
},
"commentCountTotal": { // Total comment count past 60 days
"period": "day",
"values": [
{
"value": 6,
"endTime": "2025-01-21T00:00:00.000Z"
},
{
"value": 6,
"endTime": "2025-01-20T00:00:00.000Z"
}
]
},
"displayName": "ayrshare",
"emailClicks": { // Number of clicks collected on the Email button past 60 days
"period": "day",
"values": [
{
"value": 0,
"endTime": "2025-01-21T00:00:00.000Z"
},
{
"value": 0,
"endTime": "2025-01-20T00:00:00.000Z"
}
]
},
"followerCount": { // Daily follower count snapshots (past 60 days)
"period": "day",
"values": [
{
"value": 58, // Total followers at end of this day
"endTime": "2025-01-21T00:00:00.000Z" // End of day timestamp
},
{
"value": 92,
"endTime": "2025-01-20T00:00:00.000Z"
}
]
},
"leadSubmissions": { // Number of leads submitted past 60 days
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2025-01-21T00:00:00.000Z"
},
{
"value": 0,
"endTime": "2025-01-20T00:00:00.000Z"
}
]
},
"likeCountTotal": { // Total Likes across past 60 days
"period": "day",
"total": 1161,
"values": [
{
"value": 625, // Number of likes received on this date
"endTime": "2025-01-21T00:00:00.000Z" // End of the day timestamp
},
{
"value": 536,
"endTime": "2025-01-20T00:00:00.000Z"
}
]
},
"phoneNumberClicks": { // Number of clicks collected on the Phone Number button past 60 days
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2025-01-21T00:00:00.000Z"
},
{
"value": 0,
"endTime": "2025-01-20T00:00:00.000Z"
}
]
},
"profileViews": { // Total profile views past 60 days
"period": "day",
"total": 713,
"values": [
{
"value": 360,
"endTime": "2025-01-21T00:00:00.000Z"
},
{
"value": 353,
"endTime": "2025-01-20T00:00:00.000Z"
}
]
},
"shareCountTotal": { // Total share count past 60 days
"period": "day",
"total": 3,
"values": [
{
"value": 2,
"endTime": "2025-01-21T00:00:00.000Z"
},
{
"value": 1,
"endTime": "2025-01-20T00:00:00.000Z"
}
]
},
"url": "https://vm.tiktok.com/ZT2NdEX33/",
"userImage": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useastc",
"username": "ayrshare",
"videoCountTotal": 121, // Total video count
"viewCountTotal": { // Total view count past 60 days
"period": "day",
"total": 17808,
"values": [
{
"value": 9324,
"endTime": "2025-01-21T00:00:00.000Z"
},
{
"value": 8484,
"endTime": "2025-01-20T00:00:00.000Z"
}
]
}
},
"lastUpdated": "2025-01-24T23:33:12.678Z",
"nextUpdate": "2025-01-24T23:44:12.678Z"
},
"youtube": { // If no analytics are available for a given day, not values will be returned
"analytics": {
"averageViewDuration": {
"period": "day",
"total": 4,
"values": [
{
"value": 4,
"endTime": "2024-03-18T00:00:00.000Z"
}
]
},
"averageViewPercentage": {
"period": "day",
"total": 61.99,
"values": [
{
"value": 61.99,
"endTime": "2024-03-18T00:00:00.000Z"
}
]
},
"comments": {
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-03-18T00:00:00.000Z"
}
]
},
"created": "2010-01-10T15:30:57Z",
"description": "The best place to find the best products",
"dislikes": {
"period": "day",
"total": 0,
"values": [
{
"value": 0,
"endTime": "2024-03-18T00:00:00.000Z"
}
]
},
"estimatedMinutesWatched": {
"period": "day",
"total": 23.12,
"values": [
{
"value": 23.12,
"endTime": "2024-03-18T00:00:00.000Z"
}
]
},
"handle": "@helmar1066",
"hiddenSubscriberCount": false,
"id": "UCsp6CnxiNbUU0AJtuYKZwXQ",
"isChannelMonetizationEnabled": false,
"isLinked": true,
"likes": {
"period": "day",
"total": 12,
"values": [
{
"value": 12,
"endTime": "2024-03-18T00:00:00.000Z"
}
]
},
"longUploadsStatus": "allowed",
"playlistId": "UUsp6CnxiNbUU0AJtuYKZwXQ",
"playlists": [
{
"description": "",
"id": "PLcLpmVOb3fDaf7Mps-5GnCxRZy_FBBEv4",
"publishedAt": "2022-10-21T21:05:55Z",
"title": "Super One",
"url": "https://www.youtube.com/playlist?list=PLcLpmVOb3fDaf7Mps-5GnCxRZy_FBBEv4",
"channelId": "UCsp6CnxiNbUU0AJtuYKZwXQ"
},
{
"description": "",
"id": "FLsp6CnxiNbUU0AJtuYKZwXQ",
"publishedAt": "2012-02-26T19:16:55Z",
"title": "Favorites",
"url": "https://www.youtube.com/playlist?list=FLsp6CnxiNbUU0AJtuYKZwXQ",
"channelId": "UCsp6CnxiNbUU0AJtuYKZwXQ"
}
],
"privacyStatus": "public",
"shares": {
"period": "day",
"total": 3,
"values": [
{
"value": 3,
"endTime": "2024-03-18T00:00:00.000Z"
}
]
},
"subscriberCount": 0,
"subscribersGained": {
"period": "day",
"total":80,
"values": [
{
"value": 8,
"endTime": "2024-03-18T00:00:00.000Z"
}
]
},
"subscribersLost": {
"period": "day",
"total": 1,
"values": [
{
"value": 1,
"endTime": "2024-03-18T00:00:00.000Z"
}
]
},
"thumbnailUrl": "https://yt3.ggpht.com/ytc/AIdro_lIMzJl5UC7MBEnCzuMpXzai_EvIk5Xh3ErDJ_VTBk=s88-c-k-c0x00ffffff-no-rj",
"title": "helmar1066",
"url": "https://www.youtube.com/@helmar1066",
"videoCount": 5,
"videosAddedToPlaylists": {
"period": "day",
"total": 2,
"values": [
{
"value": 2,
"endTime": "2024-03-18T00:00:00.000Z"
}
]
},
"videosRemovedFromPlaylists": {
"period": "day",
"total": 1,
"values": [
{
"value": 1,
"endTime": "2024-03-18T00:00:00.000Z"
}
]
},
"viewCount": 7,
"views": {
"period": "day",
"total": 3,
"values": [
{
"value": 3,
"endTime": "2024-03-18T00:00:00.000Z"
}
]
}
},
"quarters": 1,
"lastUpdated": "2024-04-25T21:24:45.433Z",
"nextUpdate": "2024-04-25T21:35:45.433Z"
}
"status": "success"
}
```
```json 200: Backfilled Response theme={"system"}
{
"status": "success",
"twitter": {
"analytics": {
"created": "2025-12-19T14:09:06Z",
"description": "",
"displayName": "Andrew Williams",
"followersCount": 1523,
"followingCount": 412,
"tweetCount": 8721,
"likeCount": 3200,
"listedCount": 5,
"username": "andrewwil1985",
"backfilledFrom": "2026-04-08T14:30:00.000Z"
},
"lastUpdated": "2026-04-09T10:15:00.000Z",
"nextUpdate": "2026-04-09T10:26:00.000Z"
}
}
```
```json 200: Recovered Response theme={"system"}
{
"status": "success",
"twitter": {
"analytics": {
"created": "2025-12-19T14:09:06Z",
"description": "",
"displayName": "Andrew Williams",
"followersCount": 1523,
"followingCount": 412,
"tweetCount": 8721,
"likeCount": 3200,
"listedCount": 5,
"username": "andrewwil1985",
"recoveredFrom": "2026-04-08T14:30:00.000Z"
},
"lastUpdated": "2026-04-09T10:15:00.000Z",
"nextUpdate": "2026-04-09T10:26:00.000Z"
}
}
```
```json 400: Bad Request theme={"system"}
{
"action": "request",
"status": "error",
"code": 101,
"message": "Missing or incorrect parameters. Please verify with the docs. /rest-api/endpoints Details: One of the platforms requested in not supported."
}
```
```json 400: Social Not Linked theme={"system"}
{
"linkedin": {
"action": "post",
"status": "error",
"code": 156,
"message": "LinkedIn is not properly linked and must be re-linked. Please go to the Social Accounts ppage and re-link LinkedIn."
},
"code": 156,
"status": "error"
}
```
```json 400: Partial Error theme={"system"}
{
// A partial error response is returned if some of the data is available but there is an error.
"youtube": {
"views": 401,
"comments": 2,
"likes": 37,
"dislikes": 2,
"estimatedMinutesWatched": 102,
"averageViewDuration": 12,
"averageViewPercentage": 32.66,
"subscribersGained": 2,
"subscribersLost": 4,
"videosAddedToPlaylists": 2,
"videosRemovedFromPlaylists": 1,
"shares": 25,
"errors": [
{
"action": "authorization",
"status": "error",
"code": 193,
"message": "An error occurred connecting to YouTube. Please try your request once more or re-linking YouTube on the social linking page if the issue persists: https://www.ayrshare.com/docs/dashboard/connect-social-accounts/youtube",
"details": "Error getting YouTube channel and playlist analytics: Insufficient Permission"
}
],
"status": "error"
},
"lastUpdated": "2025-01-27T02:59:13.119Z",
"nextUpdate": "2025-01-27T03:10:13.119Z",
"status": "error"
}
```