> ## 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 # Look up a tweet > Twitter Engagement. 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. Needs an X account. Paid: see x-aisa-pricing; charged only when the call succeeds. Resolve a single tweet by ID or URL into its text, author and public metrics. Use this to render a post you are referencing, e.g. the tweet quoted by a quote-style post. Unlike `/apis/v1/social/twitter/search` this is not limited to the last 7 days and works for any tweet visible to the connected account. Billed as an X posts read . Repeat lookups of the same tweet within the same UTC day are charged once. A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. > [!WARNING] > > This API reference has not been updated for the currently available endpoint. ## Request contract * **Method and path:** GET /apis/v1/social/twitter/tweet * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/social/twitter/tweet` * **accountId:** query; required * **tweetId:** query; required * **id:** query; optional * **Runtime facts:** 79b8aa68052debeaf1725d2266eb15d63863a0e7dd0fa41de5368b5a4a509fe7 [Complete OpenAPI definition](https://aisa.one/docs/openapi/aisa-social.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "get_aisa_social_apis_v1_social_twitter_tweet", "method": "GET", "path": "/apis/v1/social/twitter/tweet", "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": "Numeric tweet ID or a tweet URL (e.g. https://x.com/user/status/123...). The same name the other /apis/v1/social/twitter operations use (retweet, bookmark).", "in": "query", "name": "tweetId", "required": true, "schema": { "type": "string" } }, { "description": "Alias of tweetId, kept for existing callers", "in": "query", "name": "id", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "x-aisa-status": "enabled", "x-aisa-pricing": { "customer_micros_usd": 5000, "customer_pricing_ref": "social.twitter_engagement.get_tweet.v1.pricing@1", "description": "Charged once on success at the bound customer pricing revision; supplier cost is accounted separately. Failed or unknown outcomes are not charged.", "kind": "fixed_request" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Published reference price: \$0.005 USD per successful request. 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 openapi/aisa-social.json GET /apis/v1/social/twitter/tweet 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-catalogs: aisa-social: description: '' title: AIsa Social x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-document: facts_hash: 79b8aa68052debeaf1725d2266eb15d63863a0e7dd0fa41de5368b5a4a509fe7 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-configured-paths: [] x-aisa-document: composer_version: '28' document_hash: sha256:aecf202a890f94d4c74e1d18297e3fb2e1e1afa5e328d50bbd8f9c70ca86a719 facts_hash: 79b8aa68052debeaf1725d2266eb15d63863a0e7dd0fa41de5368b5a4a509fe7 generator_version: '3' protocol_version: '1' response_pending: [] schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: aisa-social servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/social/twitter/tweet: get: summary: Look up a tweet description: >- Twitter Engagement. 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. Needs an X account. Paid: see x-aisa-pricing; charged only when the call succeeds. Resolve a single tweet by ID or URL into its text, author and public metrics. Use this to render a post you are referencing, e.g. the tweet quoted by a quote-style post. Unlike `/apis/v1/social/twitter/search` this is not limited to the last 7 days and works for any tweet visible to the connected account. Billed as an X posts read . Repeat lookups of the same tweet within the same UTC day are charged once. 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_twitter_tweet 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: >- Numeric tweet ID or a tweet URL (e.g. https://x.com/user/status/123...). The same name the other /apis/v1/social/twitter operations use (retweet, bookmark). in: query name: tweetId required: true schema: type: string - description: Alias of tweetId, kept for existing callers in: query name: id required: false schema: type: string responses: '200': content: application/json: schema: properties: status: type: string tweet: properties: author: properties: avatar: type: string displayName: type: string id: type: string username: type: string verifiedType: type: string type: object conversationId: type: string created: format: date-time type: string id: type: string inReplyToTweetId: description: Parent tweet ID when the tweet is itself a reply type: - string - 'null' lang: type: string likeCount: type: integer platform: type: string quoteCount: type: integer replyCount: type: integer retweetCount: type: integer text: type: string type: object type: object description: The resolved tweet 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.