> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Get post analytics timeline > 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 a daily timeline of analytics metrics for a specific post, showing how impressions, likes, and other metrics evolved day-by-day since publishing. Each row represents one day of data per platform. For multi-platform AIsa posts, returns separate rows for each platform. A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** GET /apis/v1/social/analytics/post-timeline * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/social/analytics/post-timeline` * **postId:** query; required * **fromDate:** query; optional * **toDate:** query; optional * **Runtime facts:** 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd [Complete OpenAPI definition](https://aisa.one/docs/reference-contracts/aisa-social.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "get_aisa_social_apis_v1_social_analytics_post_timeline", "method": "GET", "path": "/apis/v1/social/analytics/post-timeline", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [ { "description": "The post to fetch timeline for. Accepts an ExternalPost ID, a platformPostId, or a AIsa Post ID.", "in": "query", "name": "postId", "required": true, "schema": { "type": "string" } }, { "description": "Start of date range (ISO 8601). Defaults to 90 days ago.", "in": "query", "name": "fromDate", "required": false, "schema": { "format": "date-time", "type": "string" } }, { "description": "End of date range (ISO 8601). Defaults to now.", "in": "query", "name": "toDate", "required": false, "schema": { "format": "date-time", "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" } } } } ``` ## Cost and request rules A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. ## OpenAPI ````yaml reference-contracts/aisa-social.json GET /apis/v1/social/analytics/post-timeline openapi: 3.1.0 info: description: '' title: AIsa Social version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: [] x-aisa-document: facts_hash: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '27' response_pending: [] document_hash: sha256:7f9742cb1ea233c648dcb290fdfbf24e53a27dcf900ec1386f83a8ef2e6b1bf9 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: aisa-social x-aisa-catalogs: aisa-social: title: AIsa Social description: '' x-aisa-document: facts_hash: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/social/analytics/post-timeline: get: summary: Get post analytics timeline description: >- 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 a daily timeline of analytics metrics for a specific post, showing how impressions, likes, and other metrics evolved day-by-day since publishing. Each row represents one day of data per platform. For multi-platform AIsa posts, returns separate rows for each platform. A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. operationId: get_aisa_social_apis_v1_social_analytics_post_timeline parameters: - description: >- The post to fetch timeline for. Accepts an ExternalPost ID, a platformPostId, or a AIsa Post ID. in: query name: postId required: true schema: type: string - description: Start of date range (ISO 8601). Defaults to 90 days ago. in: query name: fromDate required: false schema: format: date-time type: string - description: End of date range (ISO 8601). Defaults to now. in: query name: toDate required: false schema: format: date-time type: string responses: '200': content: application/json: schema: properties: postId: description: The postId that was requested type: string timeline: items: properties: audienceCountries: additionalProperties: type: number description: >- TikTok business lane: viewer-country shares on this date keyed by ISO-3166 alpha-2, fractions 0 to 1, top 20 with the tail in `other`; empty object elsewhere type: object audienceTypes: additionalProperties: type: number description: >- TikTok business lane: follower / nonFollower and newViewer / returnViewer shares on this date, fractions 0 to 1; empty object elsewhere type: object clicks: description: Total clicks on this date type: integer comments: description: Total comments on this date type: integer completionRate: description: >- TikTok business lane: share of viewers who watched to the end on this date, 0 to 1; 0 elsewhere type: number date: description: Date in YYYY-MM-DD format format: date type: string follows: description: >- Follows attributed to the post on this date (Instagram feed and stories, Facebook Reels, TikTok business lane). Null on Instagram Reels and video and on Facebook posts that are not Reels, where Meta has no follows metric; 0 on other platforms. type: - integer - 'null' impressionSources: additionalProperties: type: number description: >- TikTok business lane: share of views by surface on this date (forYou, follow, search, personalProfile, sound, directMessage, other), fractions 0 to 1; empty object elsewhere type: object impressions: description: Total impressions on this date type: integer likes: description: Total likes on this date type: integer platform: description: Platform name (e.g. instagram, tiktok) type: string platformPostId: description: Platform-specific post ID type: string profileViews: description: >- Instagram feed posts (images and carousels; 0 on Reels and Stories) and TikTok business lane: profile views attributed to the post on this date; 0 elsewhere type: integer reach: description: Total reach on this date type: integer replays: description: >- Facebook Reels only: plays that were replays, as of this date; 0 elsewhere type: integer retentionCurve: additionalProperties: type: number description: >- Share of viewers still watching at each second of playback, as fractions 0 to 1. Filled for Facebook Reels and the TikTok business lane; empty object for other media and platforms. Values are as of this date. **Facebook Reels** (Meta post_video_retention_graph): - The base is a subset of plays that Meta selects and does not expose. On small Reels it can be far below views (6 of 51 measured), so a value is a share of that subset, not of all plays. - Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). - Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"). - Meta returns at most 41 points, so a long Reel covers only its first 40 s. **TikTok** accounts connected through the TikTok for Business app: from TikTok video_view_retention, at each whole second, at most 61 points, thinned evenly on videos longer than 60 s. type: object saves: description: Total saves on this date type: integer shares: description: Total shares on this date type: integer views: description: Total views on this date type: integer websiteClicks: description: >- TikTok business lane: website-link clicks attributed to the post on this date (also inside clicks); 0 elsewhere type: integer type: object type: array type: object description: Daily analytics timeline default: content: application/json: schema: properties: error: properties: code: type: - string - 'null' details: additionalProperties: {} type: - object - 'null' message: type: - string - 'null' param: type: - string - 'null' retryHint: enum: - never - after_delay - after_reconnect - reconcile_first - null type: - string - 'null' retryable: type: - boolean - 'null' type: type: - string - 'null' type: - object - 'null' type: object description: Error. The code field is stable; see the error catalog. components: securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.