{ "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } }, "schemas": { "ResponseCbc4F8806E32_ArticleResponse": { "type": "object", "properties": { "article": { "$ref": "#/components/schemas/ResponseCbc4F8806E32_Article" }, "status": { "type": "string", "enum": [ "success", "failed" ] }, "msg": { "type": "string" } } }, "ResponseCbc4F8806E32_Article": { "type": "object", "properties": { "author": { "$ref": "#/components/schemas/ResponseCbc4F8806E32_User" }, "replyCount": { "type": "integer" }, "likeCount": { "type": "integer" }, "quoteCount": { "type": "integer" }, "viewCount": { "type": "integer" }, "createdAt": { "type": "string" }, "title": { "type": "string" }, "preview_text": { "type": "string" }, "cover_media_img_url": { "type": "string" }, "contents": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string" } } } } } }, "ResponseCbc4F8806E32_User": { "type": "object", "properties": { "type": { "type": "string" }, "userName": { "type": "string" }, "url": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "isBlueVerified": { "type": "boolean" }, "verifiedType": { "type": "string" }, "profilePicture": { "type": "string" }, "coverPicture": { "type": "string" }, "description": { "type": "string" }, "location": { "type": "string" }, "followers": { "type": "integer" }, "following": { "type": "integer" }, "canDm": { "type": "boolean" }, "createdAt": { "type": "string" }, "favouritesCount": { "type": "integer" }, "hasCustomTimelines": { "type": "boolean" }, "isTranslator": { "type": "boolean" }, "mediaCount": { "type": "integer" }, "statusesCount": { "type": "integer" }, "withheldInCountries": { "type": "array", "items": { "type": "string" } }, "possiblySensitive": { "type": "boolean" }, "pinnedTweetIds": { "type": "array", "items": { "type": "string" } }, "isAutomated": { "type": "boolean" }, "automatedBy": { "type": "string" }, "unavailable": { "type": "boolean" }, "message": { "type": "string" }, "unavailableReason": { "type": "string" } } }, "Response8D25370A403A_Tweet": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "url": { "type": "string" }, "text": { "type": "string" }, "source": { "type": "string" }, "retweetCount": { "type": "integer" }, "replyCount": { "type": "integer" }, "likeCount": { "type": "integer" }, "quoteCount": { "type": "integer" }, "viewCount": { "type": "integer" }, "createdAt": { "type": "string" }, "lang": { "type": "string" }, "bookmarkCount": { "type": "integer" }, "isReply": { "type": "boolean" }, "inReplyToId": { "type": "string" }, "conversationId": { "type": "string" }, "displayTextRange": { "type": "array", "items": { "type": "integer" } }, "inReplyToUserId": { "type": "string" }, "inReplyToUsername": { "type": "string" }, "author": { "$ref": "#/components/schemas/Response8D25370A403A_User" }, "entities": { "type": "object", "properties": { "hashtags": { "type": "array", "items": { "type": "object", "properties": { "indices": { "type": "array", "items": { "type": "integer" } }, "text": { "type": "string" } } } }, "urls": { "type": "array", "items": { "type": "object", "properties": { "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "type": "array", "items": { "type": "integer" } }, "url": { "type": "string" } } } }, "user_mentions": { "type": "array", "items": { "type": "object", "properties": { "id_str": { "type": "string" }, "name": { "type": "string" }, "screen_name": { "type": "string" } } } } } }, "quoted_tweet": { "type": "string" }, "retweeted_tweet": { "type": "string" }, "isLimitedReply": { "type": "boolean" } } }, "Response8D25370A403A_User": { "type": "object", "properties": { "type": { "type": "string" }, "userName": { "type": "string" }, "url": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "isBlueVerified": { "type": "boolean" }, "verifiedType": { "type": "string" }, "profilePicture": { "type": "string" }, "coverPicture": { "type": "string" }, "description": { "type": "string" }, "location": { "type": "string" }, "followers": { "type": "integer" }, "following": { "type": "integer" }, "canDm": { "type": "boolean" }, "createdAt": { "type": "string" }, "favouritesCount": { "type": "integer" }, "hasCustomTimelines": { "type": "boolean" }, "isTranslator": { "type": "boolean" }, "mediaCount": { "type": "integer" }, "statusesCount": { "type": "integer" }, "withheldInCountries": { "type": "array", "items": { "type": "string" } }, "possiblySensitive": { "type": "boolean" }, "pinnedTweetIds": { "type": "array", "items": { "type": "string" } }, "isAutomated": { "type": "boolean" }, "automatedBy": { "type": "string" }, "unavailable": { "type": "boolean" }, "message": { "type": "string" }, "unavailableReason": { "type": "string" }, "profile_bio": { "type": "object", "properties": { "description": { "type": "string" }, "entities": { "type": "object", "properties": { "description": { "type": "object", "properties": { "urls": { "type": "array", "items": { "type": "object", "properties": { "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "type": "array", "items": { "type": "integer" } }, "url": { "type": "string" } } } } } }, "url": { "type": "object", "properties": { "urls": { "type": "array", "items": { "type": "object", "properties": { "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "type": "array", "items": { "type": "integer" } }, "url": { "type": "string" } } } } } } } } } } } }, "Response8D25370A403A_CommunityInfoResponse": { "type": "object", "properties": { "community_info": { "$ref": "#/components/schemas/Response8D25370A403A_CommunityInfo" }, "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" } } }, "Response8D25370A403A_CommunityInfo": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "question": { "type": [ "string", "null" ] }, "member_count": { "type": "integer" }, "moderator_count": { "type": "integer" }, "created_at": { "type": [ "string", "null" ] }, "join_policy": { "type": [ "string", "null" ] }, "invites_policy": { "type": [ "string", "null" ] }, "is_nsfw": { "type": "boolean" }, "is_pinned": { "type": "boolean" }, "role": { "type": [ "string", "null" ] }, "primary_topic": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] } } }, "banner_url": { "type": [ "string", "null" ] }, "search_tags": { "type": "array", "items": { "type": "string" } }, "rules": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" } } } }, "creator": { "$ref": "#/components/schemas/Response8D25370A403A_User" }, "admin": { "$ref": "#/components/schemas/Response8D25370A403A_User" }, "members_preview": { "type": "array", "items": { "type": "object" } } } }, "ResponseA06878E34984_TwitterListFollowersResponse": { "type": "object", "properties": { "followers": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUser" } }, "has_next_page": { "type": "boolean", "description": "Indicates if there are more results available" }, "next_cursor": { "type": "string", "description": "Cursor for fetching the next page of results" }, "status": { "type": "string", "enum": [ "success", "error" ], "description": "Status of the request" }, "msg": { "type": "string", "description": "Message of the request, error message if status is error" } } }, "ResponseA06878E34984_TwitterUser": { "type": "object", "properties": { "type": { "type": "string", "description": "Type of the user" }, "userName": { "type": "string", "description": "Username of the user" }, "url": { "type": "string", "description": "URL of the user's profile" }, "id": { "type": "string", "description": "ID of the user" }, "name": { "type": "string", "description": "Name of the user" }, "isBlueVerified": { "type": "boolean", "description": "Indicates if the user is blue verified" }, "verifiedType": { "type": "string", "description": "Type of verification" }, "profilePicture": { "type": "string", "description": "URL of the profile picture" }, "coverPicture": { "type": "string", "description": "URL of the cover picture" }, "description": { "type": "string", "description": "Description of the user" }, "location": { "type": "string", "description": "Location of the user" }, "followers": { "type": "integer", "description": "Number of followers" }, "following": { "type": "integer", "description": "Number of followings" }, "canDm": { "type": "boolean", "description": "Indicates if the user can be direct messaged" }, "createdAt": { "type": "string", "description": "Account creation date" }, "favouritesCount": { "type": "integer", "description": "Number of favorites" }, "hasCustomTimelines": { "type": "boolean", "description": "Indicates if the user has custom timelines" }, "isTranslator": { "type": "boolean", "description": "Indicates if the user is a translator" }, "mediaCount": { "type": "integer", "description": "Number of media items" }, "statusesCount": { "type": "integer", "description": "Number of statuses" }, "withheldInCountries": { "type": "array", "items": { "type": "string" }, "description": "List of countries where the user is withheld" }, "possiblySensitive": { "type": "boolean", "description": "Indicates if the user has sensitive content" }, "pinnedTweetIds": { "type": "array", "items": { "type": "string" }, "description": "List of pinned tweet IDs" }, "isAutomated": { "type": "boolean", "description": "Indicates if the account is automated" }, "automatedBy": { "type": "string", "description": "Indicates who automated the account" }, "unavailable": { "type": "boolean", "description": "Indicates if the account is unavailable" }, "message": { "type": "string", "description": "Message about the account" }, "unavailableReason": { "type": "string", "description": "Reason for unavailability" }, "profile_bio": { "type": "object", "properties": { "description": { "type": "string", "description": "Bio description" }, "entities": { "type": "object", "properties": { "description": { "type": "object", "properties": { "urls": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUrl" } } } }, "url": { "type": "object", "properties": { "urls": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUrl" } } } } } } } } } }, "ResponseA06878E34984_TwitterUrl": { "type": "object", "properties": { "display_url": { "type": "string", "description": "Display URL" }, "expanded_url": { "type": "string", "description": "Expanded URL" }, "indices": { "type": "array", "items": { "type": "integer" }, "description": "Indices of the URL" }, "url": { "type": "string", "description": "URL" } } }, "ResponseA06878E34984_TwitterListMembersResponse": { "type": "object", "properties": { "members": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUser" } }, "has_next_page": { "type": "boolean", "description": "Indicates if there are more results available" }, "next_cursor": { "type": "string", "description": "Cursor for fetching the next page of results" }, "status": { "type": "string", "enum": [ "success", "error" ], "description": "Status of the request" }, "msg": { "type": "string", "description": "Message of the request, error message if status is error" } } }, "ResponseA06878E34984_ListTweetsTimelineResponse": { "type": "object", "properties": { "tweets": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseA06878E34984_Tweet" }, "description": "Array of tweets from the list" }, "has_next_page": { "type": "boolean", "description": "Indicates if there are more results available" }, "next_cursor": { "type": "string", "description": "Cursor for fetching the next page of results" }, "status": { "type": "string", "enum": [ "success", "error" ], "example": "success", "description": "Status of the request" }, "msg": { "type": "string", "description": "Message of the request, error message if status is error" } } }, "ResponseA06878E34984_Tweet": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string", "description": "The ID of the tweet" }, "url": { "type": "string", "description": "The URL of the tweet" }, "text": { "type": "string", "description": "The text of the tweet" }, "source": { "type": "string", "description": "The source client of the tweet" }, "retweetCount": { "type": "integer" }, "replyCount": { "type": "integer" }, "likeCount": { "type": "integer" }, "quoteCount": { "type": "integer" }, "viewCount": { "type": "integer" }, "createdAt": { "type": "string", "description": "The date and time the tweet was created" }, "lang": { "type": "string", "description": "The language of the tweet" }, "bookmarkCount": { "type": "integer" }, "isReply": { "type": "boolean" }, "inReplyToId": { "type": "string" }, "conversationId": { "type": "string" }, "inReplyToUserId": { "type": "string" }, "inReplyToUsername": { "type": "string" }, "author": { "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUser" } } }, "Response0D1E98E052C3_TrendsResponse": { "type": "object", "properties": { "trends": { "type": "array", "items": { "$ref": "#/components/schemas/Response0D1E98E052C3_Trend" } }, "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" } } }, "Response0D1E98E052C3_Trend": { "type": "object", "properties": { "name": { "type": "string" }, "target": { "type": "object", "properties": { "query": { "type": "string" } } }, "rank": { "type": "integer", "format": "int64" }, "meta_description": { "type": "string" } } }, "ResponseCbc4F8806E32_AdvancedSearchResponse": { "type": "object", "properties": { "tweets": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseCbc4F8806E32_Tweet" } }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": "string" } } }, "ResponseCbc4F8806E32_Tweet": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "url": { "type": "string" }, "text": { "type": "string" }, "source": { "type": "string" }, "retweetCount": { "type": "integer" }, "replyCount": { "type": "integer" }, "likeCount": { "type": "integer" }, "quoteCount": { "type": "integer" }, "viewCount": { "type": "integer" }, "createdAt": { "type": "string" }, "lang": { "type": "string" }, "bookmarkCount": { "type": "integer" }, "isReply": { "type": "boolean" }, "inReplyToId": { "type": "string" }, "conversationId": { "type": "string" }, "displayTextRange": { "type": "array", "items": { "type": "integer" } }, "inReplyToUserId": { "type": "string" }, "inReplyToUsername": { "type": "string" }, "author": { "$ref": "#/components/schemas/ResponseCbc4F8806E32_User" }, "entities": { "$ref": "#/components/schemas/ResponseCbc4F8806E32_Entities" }, "quoted_tweet": { "type": "string" }, "retweeted_tweet": { "type": "string" }, "isLimitedReply": { "type": "boolean" } } }, "ResponseCbc4F8806E32_Entities": { "type": "object", "properties": { "hashtags": { "type": "array", "items": { "type": "object", "properties": { "indices": { "type": "array", "items": { "type": "integer" } }, "text": { "type": "string" } } } }, "urls": { "type": "array", "items": { "type": "object", "properties": { "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "type": "array", "items": { "type": "integer" } }, "url": { "type": "string" } } } }, "user_mentions": { "type": "array", "items": { "type": "object", "properties": { "id_str": { "type": "string" }, "name": { "type": "string" }, "screen_name": { "type": "string" } } } } } }, "ResponseE9424F954Db0_Tweet": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "url": { "type": "string" }, "text": { "type": "string" }, "source": { "type": "string" }, "retweetCount": { "type": "integer" }, "replyCount": { "type": "integer" }, "likeCount": { "type": "integer" }, "quoteCount": { "type": "integer" }, "viewCount": { "type": "integer" }, "createdAt": { "type": "string" }, "lang": { "type": "string" }, "bookmarkCount": { "type": "integer" }, "isReply": { "type": "boolean" }, "inReplyToId": { "type": "string" }, "conversationId": { "type": "string" }, "displayTextRange": { "type": "array", "items": { "type": "integer" } }, "inReplyToUserId": { "type": "string" }, "inReplyToUsername": { "type": "string" }, "author": { "$ref": "#/components/schemas/ResponseE9424F954Db0_User" }, "entities": { "type": "object", "properties": { "hashtags": { "type": "array", "items": { "type": "object", "properties": { "indices": { "type": "array", "items": { "type": "integer" } }, "text": { "type": "string" } } } }, "urls": { "type": "array", "items": { "type": "object", "properties": { "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "type": "array", "items": { "type": "integer" } }, "url": { "type": "string" } } } }, "user_mentions": { "type": "array", "items": { "type": "object", "properties": { "id_str": { "type": "string" }, "name": { "type": "string" }, "screen_name": { "type": "string" } } } } } }, "quoted_tweet": { "type": "string" }, "retweeted_tweet": { "type": "string" }, "isLimitedReply": { "type": "boolean" } } }, "ResponseE9424F954Db0_User": { "type": "object", "properties": { "type": { "type": "string" }, "userName": { "type": "string" }, "url": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "isBlueVerified": { "type": "boolean" }, "verifiedType": { "type": "string" }, "profilePicture": { "type": "string" }, "coverPicture": { "type": "string" }, "description": { "type": "string" }, "location": { "type": "string" }, "followers": { "type": "integer" }, "following": { "type": "integer" }, "canDm": { "type": "boolean" }, "createdAt": { "type": "string" }, "favouritesCount": { "type": "integer" }, "hasCustomTimelines": { "type": "boolean" }, "isTranslator": { "type": "boolean" }, "mediaCount": { "type": "integer" }, "statusesCount": { "type": "integer" }, "withheldInCountries": { "type": "array", "items": { "type": "string" } }, "possiblySensitive": { "type": "boolean" }, "pinnedTweetIds": { "type": "array", "items": { "type": "string" } }, "isAutomated": { "type": "boolean" }, "automatedBy": { "type": "string" }, "unavailable": { "type": "boolean" }, "message": { "type": "string" }, "unavailableReason": { "type": "string" } } }, "ResponseD8D8F324D259_Tweet": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string", "description": "The ID of the tweet" }, "url": { "type": "string", "description": "The URL of the tweet" }, "text": { "type": "string", "description": "The text of the tweet" }, "source": { "type": "string", "description": "The source client of the tweet" }, "retweetCount": { "type": "integer" }, "replyCount": { "type": "integer" }, "likeCount": { "type": "integer" }, "quoteCount": { "type": "integer" }, "viewCount": { "type": "integer" }, "createdAt": { "type": "string", "description": "The date and time the tweet was created" }, "lang": { "type": "string", "description": "The language of the tweet" }, "bookmarkCount": { "type": "integer" }, "isReply": { "type": "boolean" }, "inReplyToId": { "type": "string" }, "conversationId": { "type": "string" }, "inReplyToUserId": { "type": "string" }, "inReplyToUsername": { "type": "string" }, "isLimitedReply": { "type": "boolean", "description": "Whether the tweet is a limited reply" } } }, "ResponseCbc4F8806E32_TweetThreadContextResponse": { "type": "object", "properties": { "has_next_page": { "type": "boolean" }, "next_cursor": { "type": "string" }, "status": { "type": "string", "enum": [ "success", "error" ] }, "tweets": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseCbc4F8806E32_Tweet" } }, "msg": { "type": "string" } } }, "ResponseB5Ae154C25F3_BatchUserInfoResponse": { "type": "object", "properties": { "users": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "userName": { "type": "string" }, "url": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "isBlueVerified": { "type": "boolean" }, "verifiedType": { "type": "string" }, "profilePicture": { "type": "string" }, "coverPicture": { "type": "string" }, "description": { "type": "string" }, "location": { "type": "string" }, "followers": { "type": "integer" }, "following": { "type": "integer" }, "canDm": { "type": "boolean" }, "createdAt": { "type": "string" }, "favouritesCount": { "type": "integer" }, "hasCustomTimelines": { "type": "boolean" }, "isTranslator": { "type": "boolean" }, "mediaCount": { "type": "integer" }, "statusesCount": { "type": "integer" }, "withheldInCountries": { "type": "array", "items": { "type": "string" } }, "possiblySensitive": { "type": "boolean" }, "pinnedTweetIds": { "type": "array", "items": { "type": "string" } }, "isAutomated": { "type": "boolean" }, "automatedBy": { "type": "string" }, "unavailable": { "type": "boolean" }, "message": { "type": "string" }, "unavailableReason": { "type": "string" } } } }, "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" } } }, "Response078307E096De_FollowRelationshipResponse": { "type": "object", "properties": { "data": { "type": "object", "properties": { "following": { "type": "boolean" }, "followed_by": { "type": "boolean" } } }, "status": { "type": "string", "enum": [ "success", "error" ] }, "message": { "type": "string" } } }, "ResponseAd3D19335Ae4_UserFollowersResponse": { "type": "object", "properties": { "followers": { "type": "array", "items": { "type": "object", "additionalProperties": true, "description": "Follower user object returned by TwitterAPI.io." } }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" }, "code": { "type": "integer" } } }, "Response078307E096De_UserFollowingsResponse": { "type": "object", "properties": { "followings": { "type": "array", "items": { "$ref": "#/components/schemas/Response078307E096De_User" } }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": "string" }, "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" }, "code": { "type": "integer" } } }, "Response078307E096De_User": { "type": "object", "properties": { "type": { "type": "string" }, "userName": { "type": "string" }, "url": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "isBlueVerified": { "type": "boolean" }, "verifiedType": { "type": "string" }, "profilePicture": { "type": "string" }, "coverPicture": { "type": "string" }, "description": { "type": "string" }, "location": { "type": "string" }, "followers": { "type": "integer" }, "following": { "type": "integer" }, "canDm": { "type": "boolean" }, "createdAt": { "type": "string" }, "favouritesCount": { "type": "integer" }, "hasCustomTimelines": { "type": "boolean" }, "isTranslator": { "type": "boolean" }, "mediaCount": { "type": "integer" }, "statusesCount": { "type": "integer" }, "withheldInCountries": { "type": "array", "items": { "type": "string" } }, "possiblySensitive": { "type": "boolean" }, "pinnedTweetIds": { "type": "array", "items": { "type": "string" } }, "isAutomated": { "type": "boolean" }, "automatedBy": { "type": "string" }, "unavailable": { "type": "boolean" }, "message": { "type": "string" }, "unavailableReason": { "type": "string" } } }, "ResponseAd3D19335Ae4_UserInfoResponse": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" }, "data": { "type": "object", "additionalProperties": true, "description": "User profile object returned by TwitterAPI.io." } } }, "ResponseAd3D19335Ae4_UserTweetsResponse": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "success", "error" ] }, "code": { "type": "integer", "description": "Provider status code returned by the AIsa wrapper." }, "msg": { "type": "string" }, "data": { "type": "object", "properties": { "tweets": { "type": "array", "items": { "type": "object", "additionalProperties": true, "description": "Tweet object returned by TwitterAPI.io." } }, "pin_tweet": { "type": [ "object", "null" ], "additionalProperties": true } }, "additionalProperties": true }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": [ "string", "null" ] } } }, "Response078307E096De_UserMentionsResponse": { "type": "object", "properties": { "tweets": { "type": "array", "items": { "$ref": "#/components/schemas/Response078307E096De_Tweet" } }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": "string" }, "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" }, "code": { "type": "integer" } } }, "Response078307E096De_Tweet": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "url": { "type": "string" }, "text": { "type": "string" }, "source": { "type": "string" }, "retweetCount": { "type": "integer" }, "replyCount": { "type": "integer" }, "likeCount": { "type": "integer" }, "quoteCount": { "type": "integer" }, "viewCount": { "type": "integer" }, "createdAt": { "type": "string" }, "lang": { "type": "string" }, "bookmarkCount": { "type": "integer" }, "isReply": { "type": "boolean" }, "inReplyToId": { "type": "string" }, "conversationId": { "type": "string" }, "displayTextRange": { "type": "array", "items": { "type": "integer" } }, "inReplyToUserId": { "type": "string" }, "inReplyToUsername": { "type": "string" }, "author": { "$ref": "#/components/schemas/Response078307E096De_User" }, "entities": { "type": "object", "properties": { "hashtags": { "type": "array", "items": { "type": "object", "properties": { "indices": { "type": "array", "items": { "type": "integer" } }, "text": { "type": "string" } } } }, "urls": { "type": "array", "items": { "type": "object", "properties": { "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "type": "array", "items": { "type": "integer" } }, "url": { "type": "string" } } } }, "user_mentions": { "type": "array", "items": { "type": "object", "properties": { "id_str": { "type": "string" }, "name": { "type": "string" }, "screen_name": { "type": "string" } } } } } } } }, "Response078307E096De_SearchUserResponse": { "type": "object", "properties": { "users": { "type": "array", "items": { "$ref": "#/components/schemas/Response078307E096De_User" } }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": "string" }, "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" } } }, "Response078307E096De_VerifiedFollowersResponse": { "type": "object", "properties": { "followers": { "type": "array", "items": { "$ref": "#/components/schemas/Response078307E096De_User" } }, "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": [ "string", "null" ] }, "code": { "type": "integer" } } }, "ResponseAd3D19335Ae4_UserProfileAboutResponse": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "userName": { "type": "string" }, "createdAt": { "type": "string" }, "isBlueVerified": { "type": "boolean" }, "protected": { "type": "boolean" }, "affiliates_highlighted_label": { "type": "object", "properties": { "label": { "type": "object", "properties": { "badge": { "type": "object", "properties": { "url": { "type": "string" } } }, "description": { "type": "string" }, "url": { "type": "object", "properties": { "url": { "type": "string" }, "urlType": { "type": "string" } } }, "userLabelDisplayType": { "type": "string" }, "userLabelType": { "type": "string" } } } } }, "about_profile": { "type": "object", "properties": { "account_based_in": { "type": "string" }, "location_accurate": { "type": "boolean" }, "learn_more_url": { "type": "string" }, "affiliate_username": { "type": "string" }, "source": { "type": "string" }, "username_changes": { "type": "object", "properties": { "count": { "type": "string" } } } } }, "identity_profile_labels_highlighted_label": { "type": "object", "properties": { "label": { "type": "object", "properties": { "description": { "type": "string" }, "badge": { "type": "object", "properties": { "url": { "type": "string" } } }, "url": { "type": "object", "properties": { "url": { "type": "string" }, "urlType": { "type": "string" } } }, "userLabelDisplayType": { "type": "string" }, "userLabelType": { "type": "string" } } } } } } }, "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" } } } }, "responses": {}, "parameters": {}, "examples": {}, "requestBodies": {}, "headers": {}, "links": {}, "callbacks": {}, "pathItems": {} }, "info": { "description": "", "title": "TwitterAPI", "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": [ "/apis/v1/twitter/article", "/apis/v1/twitter/communities", "/apis/v1/twitter/communities/members", "/apis/v1/twitter/communities/search", "/apis/v1/twitter/communities/tweets", "/apis/v1/twitter/community/get_tweets_from_all_community", "/apis/v1/twitter/community/info", "/apis/v1/twitter/community/members", "/apis/v1/twitter/community/moderators", "/apis/v1/twitter/community/tweets", "/apis/v1/twitter/create_tweet_v2", "/apis/v1/twitter/delete_my_x_account_v3", "/apis/v1/twitter/delete_tweet_v2", "/apis/v1/twitter/follow_user_v2", "/apis/v1/twitter/friendships", "/apis/v1/twitter/hashtags", "/apis/v1/twitter/like_tweet_v2", "/apis/v1/twitter/like_tweet_v3", "/apis/v1/twitter/list/followers", "/apis/v1/twitter/list/members", "/apis/v1/twitter/list/tweets_timeline", "/apis/v1/twitter/lists", "/apis/v1/twitter/lists/followers", "/apis/v1/twitter/lists/members", "/apis/v1/twitter/lists/tweets", "/apis/v1/twitter/profiles", "/apis/v1/twitter/profiles/{handle}", "/apis/v1/twitter/profiles/{handle}/about", "/apis/v1/twitter/profiles/{handle}/followers", "/apis/v1/twitter/profiles/{handle}/followers/ids", "/apis/v1/twitter/profiles/{handle}/followers/verified", "/apis/v1/twitter/profiles/{handle}/following", "/apis/v1/twitter/profiles/{handle}/following/ids", "/apis/v1/twitter/profiles/{handle}/subscriptions", "/apis/v1/twitter/profiles/{handle}/tweets", "/apis/v1/twitter/retweet_tweet_v2", "/apis/v1/twitter/retweet_v3", "/apis/v1/twitter/search", "/apis/v1/twitter/send_dm_to_user", "/apis/v1/twitter/send_tweet_v3", "/apis/v1/twitter/spaces", "/apis/v1/twitter/spaces/stream", "/apis/v1/twitter/trends", "/apis/v1/twitter/tweet/advanced_search", "/apis/v1/twitter/tweet/quotes", "/apis/v1/twitter/tweet/replies", "/apis/v1/twitter/tweet/replies/v2", "/apis/v1/twitter/tweet/retweeters", "/apis/v1/twitter/tweet/thread_context", "/apis/v1/twitter/tweets", "/apis/v1/twitter/tweets/batch", "/apis/v1/twitter/tweets/quotes", "/apis/v1/twitter/tweets/replies", "/apis/v1/twitter/tweets/retweets", "/apis/v1/twitter/tweets/transcript", "/apis/v1/twitter/unfollow_user_v2", "/apis/v1/twitter/unlike_tweet_v2", "/apis/v1/twitter/update_profile_v3", "/apis/v1/twitter/upload_media_v2", "/apis/v1/twitter/user/batch_info_by_ids", "/apis/v1/twitter/user/check_follow_relationship", "/apis/v1/twitter/user/followers", "/apis/v1/twitter/user/followings", "/apis/v1/twitter/user/info", "/apis/v1/twitter/user/last_tweets", "/apis/v1/twitter/user/mentions", "/apis/v1/twitter/user/search", "/apis/v1/twitter/user/tweet_timeline", "/apis/v1/twitter/user/verifiedFollowers", "/apis/v1/twitter/user_about", "/apis/v1/twitter/user_login_v2", "/apis/v1/twitter/user_login_v3" ], "x-aisa-document": { "facts_hash": "4fdc418106627f05544fcd24ae144896651876a511bab40974894d8c4c6f83cd", "generator_version": "3", "protocol_version": "1", "schema_version": "1", "composer_version": "27", "response_pending": [ { "operation_id": "twitter.communities", "path": "/apis/v1/twitter/communities", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.communities.members", "path": "/apis/v1/twitter/communities/members", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.communities.search", "path": "/apis/v1/twitter/communities/search", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.communities.tweets", "path": "/apis/v1/twitter/communities/tweets", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.friendships", "path": "/apis/v1/twitter/friendships", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.hashtags", "path": "/apis/v1/twitter/hashtags", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.lists", "path": "/apis/v1/twitter/lists", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.lists.followers", "path": "/apis/v1/twitter/lists/followers", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.lists.members", "path": "/apis/v1/twitter/lists/members", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.lists.tweets", "path": "/apis/v1/twitter/lists/tweets", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.profiles", "path": "/apis/v1/twitter/profiles", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.profiles.handle", "path": "/apis/v1/twitter/profiles/{handle}", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.profiles.handle.about", "path": "/apis/v1/twitter/profiles/{handle}/about", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.profiles.handle.followers", "path": "/apis/v1/twitter/profiles/{handle}/followers", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.profiles.handle.followers.ids", "path": "/apis/v1/twitter/profiles/{handle}/followers/ids", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.profiles.handle.followers.verified", "path": "/apis/v1/twitter/profiles/{handle}/followers/verified", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.profiles.handle.following", "path": "/apis/v1/twitter/profiles/{handle}/following", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.profiles.handle.following.ids", "path": "/apis/v1/twitter/profiles/{handle}/following/ids", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.profiles.handle.subscriptions", "path": "/apis/v1/twitter/profiles/{handle}/subscriptions", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.profiles.handle.tweets", "path": "/apis/v1/twitter/profiles/{handle}/tweets", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.search", "path": "/apis/v1/twitter/search", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.spaces", "path": "/apis/v1/twitter/spaces", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.spaces.stream", "path": "/apis/v1/twitter/spaces/stream", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.tweets.batch", "path": "/apis/v1/twitter/tweets/batch", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.tweets.quotes", "path": "/apis/v1/twitter/tweets/quotes", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.tweets.replies", "path": "/apis/v1/twitter/tweets/replies", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.tweets.retweets", "path": "/apis/v1/twitter/tweets/retweets", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, { "operation_id": "twitter.tweets.transcript", "path": "/apis/v1/twitter/tweets/transcript", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" } ], "document_hash": "sha256:9a049a19a757077fe3e717747f3c4a2ce4d6f0897c84de6efcf95fae44045173" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-provider": "twitter", "x-aisa-catalogs": { "twitter": { "title": "TwitterAPI", "description": "", "x-aisa-document": { "facts_hash": "4fdc418106627f05544fcd24ae144896651876a511bab40974894d8c4c6f83cd", "generator_version": "3", "protocol_version": "1", "schema_version": "1" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } } } } }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ], "paths": { "/apis/v1/twitter/article": { "get": { "description": "Get the full body of an X Article (long-form post) by its tweet ID. Use this when a tweet links to or is an Article and the 280-character preview is not enough — this returns the complete text rather than the truncated tweet. Returns the article under `article`. For ordinary tweets use `get_twitter_tweets`.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_article", "parameters": [ { "in": "query", "name": "tweet_id", "required": true, "schema": { "type": "string" }, "description": "The tweet ID of the article." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseCbc4F8806E32_ArticleResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Article", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.001, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4dd4f02a35fa", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f5eba23e6c9b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/article", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_article", "method": "ANY", "path": "/apis/v1/twitter/article" }, "x-aisa-provider-required": [ "query:tweet_id" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:773d9c7f416c89c5aa82bec4696f61a9862a55962d47cdd3f47cf0cb512d2d8b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4aa234e7f6d4f6d581af3f46c6075b5fd75a05cf89f7855afc2f695854f37465" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:773d9c7f416c89c5aa82bec4696f61a9862a55962d47cdd3f47cf0cb512d2d8b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4aa234e7f6d4f6d581af3f46c6075b5fd75a05cf89f7855afc2f695854f37465" }, "content_hash": "sha256:079d630557f5ff49005d148c2ce5bb778357d29d800f01d3e78ec34d3ed11db7" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-article" } }, "/apis/v1/twitter/communities": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.communities", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Twitter community", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "9abf47c9e7ae9ea9bf07cf8c46e04ab5cc66dc7687bda205b6d7cc6e056182af", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "23ee5131ee14" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.communities", "method": "GET", "path": "/apis/v1/twitter/communities" }, "x-aisa-response-pending": { "operation_id": "twitter.communities", "path": "/apis/v1/twitter/communities", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/communities?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-communities" } }, "/apis/v1/twitter/communities/members": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.communities.members", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List Twitter community members", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "7a644de4c5969292baf14d15923944d83768418c3070b44077bdb518ccf1b7b2", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "dc9949242e05" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.communities.members", "method": "GET", "path": "/apis/v1/twitter/communities/members" }, "x-aisa-response-pending": { "operation_id": "twitter.communities.members", "path": "/apis/v1/twitter/communities/members", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/communities/members?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-communities-members" } }, "/apis/v1/twitter/communities/search": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.communities.search", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "nike" }, "minimal": { "value": "nike" } }, "in": "query", "name": "query", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search Twitter communities", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "27e138cce000f7acaa92a360a93dce76f17ac8801783349abf206dc344667cbb", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7fe31c1666c7" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.communities.search", "method": "GET", "path": "/apis/v1/twitter/communities/search" }, "x-aisa-response-pending": { "operation_id": "twitter.communities.search", "path": "/apis/v1/twitter/communities/search", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/communities/search?query=nike' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-communities-search" } }, "/apis/v1/twitter/communities/tweets": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.communities.tweets", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "in": "query", "name": "sortBy", "required": false, "schema": { "enum": [ "recency", "relevance" ], "maxLength": 4096, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List Twitter community tweets", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "1987a569c3270b7a23e25abc9714f7d0cab29df11c073a09fb89ab15a3359f73", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f62b4368e2e3" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.communities.tweets", "method": "GET", "path": "/apis/v1/twitter/communities/tweets" }, "x-aisa-response-pending": { "operation_id": "twitter.communities.tweets", "path": "/apis/v1/twitter/communities/tweets", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/communities/tweets?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-communities-tweets" } }, "/apis/v1/twitter/community/get_tweets_from_all_community": { "get": { "description": "Search posts across all X Communities by keyword, sorted by Latest (default) or Top, cursor-paginated. Use this to find topic-specific discussion happening inside communities rather than on the public timeline — signal density is usually higher and noise lower. Returns full tweet objects. Once you identify a community worth following, use `get_twitter_community_tweets` to read it directly, or `get_twitter_community_info` for its metadata. For public-timeline search use `get_twitter_tweet_advanced_search`.\n\n\nUsage-based billing; Default request estimate: $0.003 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_community_tweets_all", "responses": { "200": { "description": "Tweets response", "content": { "application/json": { "schema": { "type": "object", "properties": { "tweets": { "type": "array", "items": { "$ref": "#/components/schemas/Response8D25370A403A_Tweet" } }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": "string" } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Community Tweets", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1e120d006e30" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/community/get_tweets_from_all_community", "x-aisa-validation": "provider", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_community_tweets_all", "method": "ANY", "path": "/apis/v1/twitter/community/get_tweets_from_all_community" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Cursor for pagination" }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Search query (e.g., keyword)" }, { "name": "queryType", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "Latest", "Top" ], "default": "Latest" }, "description": "Query type (Latest or Top)" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-communities.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:07a1404553190557dccbd140eba1e1c5fd4c68f6e7281410ffbf9a8fcc3f603c", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:3b1eaec6a84e1eaec15229ba2f26465b4e8d89eb13a03f9e5590fa9764d3b704" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-communities.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:07a1404553190557dccbd140eba1e1c5fd4c68f6e7281410ffbf9a8fcc3f603c", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:3b1eaec6a84e1eaec15229ba2f26465b4e8d89eb13a03f9e5590fa9764d3b704" }, "content_hash": "sha256:c10c28e342c450f73966cd35ed398bad995f200ea770837f880d40de96ca961a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-community-get-tweets-from-all-community" } }, "/apis/v1/twitter/community/info": { "get": { "description": "Get metadata for an X Community by its numeric community ID — name, description, member count, and access rules. Use this to qualify a community before pulling its members or posts. Returns the object under `community_info`. To discover communities by topic, search their posts with `get_twitter_community_tweets_all`.\n\n\nPublished reference price: $0.0002 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_community_info", "responses": { "200": { "description": "Community info response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response8D25370A403A_CommunityInfoResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Community Info", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0002, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "4dd4f02a35fa", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "89208f0237d6" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/community/info", "x-aisa-validation": "provider", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_community_info", "method": "ANY", "path": "/apis/v1/twitter/community/info" }, "parameters": [ { "name": "community_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "ID of the community" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-communities.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:07a1404553190557dccbd140eba1e1c5fd4c68f6e7281410ffbf9a8fcc3f603c", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:3b1eaec6a84e1eaec15229ba2f26465b4e8d89eb13a03f9e5590fa9764d3b704" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-communities.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:07a1404553190557dccbd140eba1e1c5fd4c68f6e7281410ffbf9a8fcc3f603c", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:3b1eaec6a84e1eaec15229ba2f26465b4e8d89eb13a03f9e5590fa9764d3b704" }, "content_hash": "sha256:21e7d29804cbb385145797cbd0160435c24b574cdaa5f9013d92aa9655e019b6" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-community-info" } }, "/apis/v1/twitter/community/members": { "get": { "description": "List the members of an X Community, cursor-paginated. Use this to map who participates in a topic-specific group — usually a higher-signal audience than general followers, because membership is opt-in. Returns full user objects. For the subset who moderate it, use `get_twitter_community_moderators`.\n\n\nUsage-based billing; Default request estimate: $0.0036 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_community_members", "responses": { "200": { "description": "Community members response", "content": { "application/json": { "schema": { "type": "object", "properties": { "members": { "type": "array", "items": { "$ref": "#/components/schemas/Response8D25370A403A_User" } }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": "string" }, "has_next": { "type": "boolean" }, "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List Community Members", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0036, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d78ee6c48430" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/community/members", "x-aisa-validation": "provider", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_community_members", "method": "ANY", "path": "/apis/v1/twitter/community/members" }, "parameters": [ { "name": "community_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "ID of the community" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Cursor for pagination" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-communities.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:07a1404553190557dccbd140eba1e1c5fd4c68f6e7281410ffbf9a8fcc3f603c", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:3b1eaec6a84e1eaec15229ba2f26465b4e8d89eb13a03f9e5590fa9764d3b704" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-communities.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:07a1404553190557dccbd140eba1e1c5fd4c68f6e7281410ffbf9a8fcc3f603c", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:3b1eaec6a84e1eaec15229ba2f26465b4e8d89eb13a03f9e5590fa9764d3b704" }, "content_hash": "sha256:e4384c3eecf22b733a2f9a7f8da2c2ea9df39904e11cb3722f7097ba2c67611a" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-community-members" } }, "/apis/v1/twitter/community/moderators": { "get": { "description": "List the moderators of an X Community, cursor-paginated. Use this to identify the people who set the agenda in a community — the highest-leverage contacts for outreach or partnership. Returns full user objects. For the full membership use `get_twitter_community_members`.\n\n\nUsage-based billing; Default request estimate: $0.0036 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_community_moderators", "responses": { "200": { "description": "Community moderators response", "content": { "application/json": { "schema": { "type": "object", "properties": { "members": { "type": "array", "items": { "$ref": "#/components/schemas/Response8D25370A403A_User" } }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": "string" }, "has_next": { "type": "boolean" }, "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Community Moderators", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0036, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e1d86f6bd96f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/community/moderators", "x-aisa-validation": "provider", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_community_moderators", "method": "ANY", "path": "/apis/v1/twitter/community/moderators" }, "parameters": [ { "name": "community_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "ID of the community" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Cursor for pagination" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-communities.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:07a1404553190557dccbd140eba1e1c5fd4c68f6e7281410ffbf9a8fcc3f603c", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:3b1eaec6a84e1eaec15229ba2f26465b4e8d89eb13a03f9e5590fa9764d3b704" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-communities.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:07a1404553190557dccbd140eba1e1c5fd4c68f6e7281410ffbf9a8fcc3f603c", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:3b1eaec6a84e1eaec15229ba2f26465b4e8d89eb13a03f9e5590fa9764d3b704" }, "content_hash": "sha256:64f49564ef678c0e57c7c8a62e0a13090b71810206a3a2b0281ef7ee5a7aa64b" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-community-moderators" } }, "/apis/v1/twitter/community/tweets": { "get": { "description": "Get posts published inside one specific X Community, cursor-paginated. Use this to read what a known community is actually discussing. Returns full tweet objects with engagement counts. If you do not know which community to look at, search across all of them with `get_twitter_community_tweets_all`.\n\n\nUsage-based billing; Default request estimate: $0.003 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_community_tweets", "responses": { "200": { "description": "Community tweets response", "content": { "application/json": { "schema": { "type": "object", "properties": { "tweets": { "type": "array", "items": { "$ref": "#/components/schemas/Response8D25370A403A_Tweet" } }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": "string" }, "has_next": { "type": "boolean" }, "status": { "type": "string", "enum": [ "success", "error" ] }, "msg": { "type": "string" } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Community Tweets", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0b8a33d14b88" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/community/tweets", "x-aisa-validation": "provider", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_community_tweets", "method": "ANY", "path": "/apis/v1/twitter/community/tweets" }, "parameters": [ { "name": "community_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "ID of the community" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Cursor for pagination" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-communities.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:07a1404553190557dccbd140eba1e1c5fd4c68f6e7281410ffbf9a8fcc3f603c", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:3b1eaec6a84e1eaec15229ba2f26465b4e8d89eb13a03f9e5590fa9764d3b704" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-communities.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:07a1404553190557dccbd140eba1e1c5fd4c68f6e7281410ffbf9a8fcc3f603c", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:3b1eaec6a84e1eaec15229ba2f26465b4e8d89eb13a03f9e5590fa9764d3b704" }, "content_hash": "sha256:efbd243830705755bfb18e999bd2e1a26dc54ff0db1ead9be4c4fa77d87b8a44" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-community-tweets" } }, "/apis/v1/twitter/friendships": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.friendships", "parameters": [ { "in": "query", "name": "by", "required": false, "schema": { "enum": [ "handle", "id" ], "maxLength": 4096, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "source", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "target", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Check Twitter follow relationship", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "4770e288bf430d8c1df822029c09fb49ee07f99e3ecccdf7c15d55b2aec5ee58", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1cf11fa360be" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.friendships", "method": "GET", "path": "/apis/v1/twitter/friendships" }, "x-aisa-response-pending": { "operation_id": "twitter.friendships", "path": "/apis/v1/twitter/friendships", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/friendships?source=example&target=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-friendships" } }, "/apis/v1/twitter/hashtags": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.hashtags", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "hashtag", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "maximum": 20, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "section", "required": false, "schema": { "enum": [ "latest", "people", "photos", "top", "videos" ], "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search Twitter by hashtag", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "c75b9360c6410b2502d66d1c0b013ed65287309c0354e0937017a4664fac8fee", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f8c63c05d1ed" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.hashtags", "method": "GET", "path": "/apis/v1/twitter/hashtags" }, "x-aisa-response-pending": { "operation_id": "twitter.hashtags", "path": "/apis/v1/twitter/hashtags", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/hashtags?hashtag=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-hashtags" } }, "/apis/v1/twitter/list/followers": { "get": { "description": "List the accounts that subscribe to an X List, 20 per page, cursor-paginated. Use this to gauge how much attention a curated list attracts and who cares about that topic. Returns full user objects under `followers`. For the accounts included in the List (not its subscribers) use `get_twitter_list_members`.\n\n\nPublished reference price: $0.0015 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_list_followers", "responses": { "200": { "description": "List followers of the list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseA06878E34984_TwitterListFollowersResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List List Followers", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0015, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "4dd4f02a35fa", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "aa62f2d5dc55" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/list/followers", "x-aisa-validation": "provider", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_list_followers", "method": "ANY", "path": "/apis/v1/twitter/list/followers" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Cursor of the page" }, { "name": "list_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "ID of the list" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-list.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:54bba4d2b325710e756672c7df1510772bb666bfbd1f06ee4e69a9ddbe105948", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:f9048c63825ef46275fab52465168452dd85993e4306d72543ecae1d4fb8a254" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-list.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:54bba4d2b325710e756672c7df1510772bb666bfbd1f06ee4e69a9ddbe105948", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:f9048c63825ef46275fab52465168452dd85993e4306d72543ecae1d4fb8a254" }, "content_hash": "sha256:6360ec7fc7b5ced8f0d28c01b58ff15525bdb5fc2f6a656cfdd487659e731ee1" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-list-followers" } }, "/apis/v1/twitter/list/members": { "get": { "description": "List the accounts included in an X List, 20 per page, cursor-paginated. Use this to extract a ready-made, human-curated cohort — someone else has already done the filtering. Returns full user objects under `members`. To read what those accounts are posting as one feed, use `get_twitter_list_tweets_timeline`. For the List's subscribers use `get_twitter_list_followers`.\n\n\nPublished reference price: $0.0015 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_list_members", "responses": { "200": { "description": "List members response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseA06878E34984_TwitterListMembersResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get List Members", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0015, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "4dd4f02a35fa", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "864f2eddc1ec" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/list/members", "x-aisa-validation": "provider", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_list_members", "method": "ANY", "path": "/apis/v1/twitter/list/members" }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Cursor of the page" }, { "name": "list_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "ID of the list" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-list.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:54bba4d2b325710e756672c7df1510772bb666bfbd1f06ee4e69a9ddbe105948", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:f9048c63825ef46275fab52465168452dd85993e4306d72543ecae1d4fb8a254" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-list.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:54bba4d2b325710e756672c7df1510772bb666bfbd1f06ee4e69a9ddbe105948", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:f9048c63825ef46275fab52465168452dd85993e4306d72543ecae1d4fb8a254" }, "content_hash": "sha256:37826841b39772b58361d9e361c883e772bab02e62d17752f6bf675374a420d5" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-list-members" } }, "/apis/v1/twitter/list/tweets_timeline": { "get": { "description": "Get the tweet timeline of an X List by `listId`, up to 20 per page, cursor-paginated. Use this to monitor a hand-curated set of accounts as a single feed — Lists are the cheapest way to track a fixed cohort (competitors, analysts, a beat) without polling each account. Returns tweets with `has_next_page` and `next_cursor`. To see who is in the List use `get_twitter_list_members`.\n\n\nPublished reference price: $0.0015 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_list_tweets_timeline", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" }, "description": "Cursor for paginating through results. Leave empty for the first page." }, { "in": "query", "name": "listId", "required": true, "schema": { "type": "string" }, "description": "The list ID to get tweets from. e.g. 1846987139428634858" } ], "responses": { "200": { "description": "List tweet timeline response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseA06878E34984_ListTweetsTimelineResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get List Tweet TimeLine", "tags": [ "group1500" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0015, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4dd4f02a35fa", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cf88fa363458" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/list/tweets_timeline", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_list_tweets_timeline", "method": "ANY", "path": "/apis/v1/twitter/list/tweets_timeline" }, "x-aisa-provider-required": [ "query:listId" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-list.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:54bba4d2b325710e756672c7df1510772bb666bfbd1f06ee4e69a9ddbe105948", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:f9048c63825ef46275fab52465168452dd85993e4306d72543ecae1d4fb8a254" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-list.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:54bba4d2b325710e756672c7df1510772bb666bfbd1f06ee4e69a9ddbe105948", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:f9048c63825ef46275fab52465168452dd85993e4306d72543ecae1d4fb8a254" }, "content_hash": "sha256:c3e5519f5556bfc0b70ab61f5462a82dee5ee3c7d8ee6511586e33c0699ec92d" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-list-tweets-timeline" } }, "/apis/v1/twitter/lists": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.lists", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Twitter list", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "200beb9bb9463e1d20348651c71addd8dd8d44803e29fa272cd12b071fae7973", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4086e316495b" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.lists", "method": "GET", "path": "/apis/v1/twitter/lists" }, "x-aisa-response-pending": { "operation_id": "twitter.lists", "path": "/apis/v1/twitter/lists", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/lists?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-lists" } }, "/apis/v1/twitter/lists/followers": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.lists.followers", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List followers of a Twitter list", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "783de05e672eb9e2b9b3d9b623055f25549851ece9c260ae41422ae0ed8179f7", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7b0dafdeeea1" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.lists.followers", "method": "GET", "path": "/apis/v1/twitter/lists/followers" }, "x-aisa-response-pending": { "operation_id": "twitter.lists.followers", "path": "/apis/v1/twitter/lists/followers", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/lists/followers?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-lists-followers" } }, "/apis/v1/twitter/lists/members": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.lists.members", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List members of a Twitter list", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "080aa7d160eadf731ff00080a0d501427f1f642279c44e77f07702630615246f", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c702712c2c44" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.lists.members", "method": "GET", "path": "/apis/v1/twitter/lists/members" }, "x-aisa-response-pending": { "operation_id": "twitter.lists.members", "path": "/apis/v1/twitter/lists/members", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/lists/members?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-lists-members" } }, "/apis/v1/twitter/lists/tweets": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.lists.tweets", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List tweets from a Twitter list", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "b3911a507b8a95df54f587710d31d7c5bb6fea62c25fbaef1290bc765a57cd06", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ad8c92ddf301" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.lists.tweets", "method": "GET", "path": "/apis/v1/twitter/lists/tweets" }, "x-aisa-response-pending": { "operation_id": "twitter.lists.tweets", "path": "/apis/v1/twitter/lists/tweets", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/lists/tweets?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-lists-tweets" } }, "/apis/v1/twitter/profiles": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.profiles", "parameters": [ { "examples": { "default": { "value": [ "example" ] }, "minimal": { "value": [ "example" ] } }, "explode": true, "in": "query", "name": "handle", "required": false, "schema": { "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" }, "style": "form" }, { "explode": true, "in": "query", "name": "id", "required": false, "schema": { "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" }, "style": "form" } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get multiple Twitter profiles", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-constraints": { "required_any_of": [ [ { "in": "query", "name": "handle", "selector": "handle" }, { "in": "query", "name": "id", "selector": "id" } ] ] }, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "080beb4c58ec76c4501bab838d0572e4ac8197cf8ffd72b7443a9ba5ae60fbe9", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2dc95c82efad" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.profiles", "method": "GET", "path": "/apis/v1/twitter/profiles" }, "x-aisa-response-pending": { "operation_id": "twitter.profiles", "path": "/apis/v1/twitter/profiles", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-profiles" } }, "/apis/v1/twitter/profiles/{handle}": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.profiles.handle", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "path", "name": "handle", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "by", "required": false, "schema": { "enum": [ "handle", "id" ], "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Twitter profile", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "c2c2f9abbd40fc5f3ef1456ff4b287b1d125b6a3d497a16cd18ed7b4fb58de90", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ef6184a103e1" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.profiles.handle", "method": "GET", "path": "/apis/v1/twitter/profiles/{handle}" }, "x-aisa-response-pending": { "operation_id": "twitter.profiles.handle", "path": "/apis/v1/twitter/profiles/{handle}", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/twitter/profiles/example \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-profiles-handle" } }, "/apis/v1/twitter/profiles/{handle}/about": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.profiles.handle.about", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "path", "name": "handle", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "by", "required": false, "schema": { "enum": [ "handle", "id" ], "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Twitter account transparency details", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "14ae2a1c40c67be65fc63437015c353dbec225bb7a3edee7deedccdcd8ef6425", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7e878aa2a960" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.profiles.handle.about", "method": "GET", "path": "/apis/v1/twitter/profiles/{handle}/about" }, "x-aisa-response-pending": { "operation_id": "twitter.profiles.handle.about", "path": "/apis/v1/twitter/profiles/{handle}/about", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/twitter/profiles/example/about \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-profiles-handle-about" } }, "/apis/v1/twitter/profiles/{handle}/followers": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.profiles.handle.followers", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "path", "name": "handle", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "by", "required": false, "schema": { "enum": [ "handle", "id" ], "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List Twitter profile followers", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "ac45eeb9b8aff2496a7a404f44d7ba67e541bd94f1314db6895c20b0b4e76d7d", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8f995b428104" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.profiles.handle.followers", "method": "GET", "path": "/apis/v1/twitter/profiles/{handle}/followers" }, "x-aisa-response-pending": { "operation_id": "twitter.profiles.handle.followers", "path": "/apis/v1/twitter/profiles/{handle}/followers", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/twitter/profiles/example/followers \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-profiles-handle-followers" } }, "/apis/v1/twitter/profiles/{handle}/followers/ids": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.profiles.handle.followers.ids", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "path", "name": "handle", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "by", "required": false, "schema": { "enum": [ "handle", "id" ], "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "maximum": 5000, "minimum": 1, "type": "integer" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List follower ids of a Twitter profile", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "422e8fac74ed0373643381e20997b770267155650399171134595a33117f8d0f", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b24741353099" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.profiles.handle.followers.ids", "method": "GET", "path": "/apis/v1/twitter/profiles/{handle}/followers/ids" }, "x-aisa-response-pending": { "operation_id": "twitter.profiles.handle.followers.ids", "path": "/apis/v1/twitter/profiles/{handle}/followers/ids", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/twitter/profiles/example/followers/ids \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-profiles-handle-followers-ids" } }, "/apis/v1/twitter/profiles/{handle}/followers/verified": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.profiles.handle.followers.verified", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "path", "name": "handle", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "by", "required": false, "schema": { "enum": [ "handle", "id" ], "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List verified followers of a Twitter profile", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "210a6c1505578e7f7a58534170690cba301cecde3a70bc592a9a62242bbfd6bf", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e476c8de90eb" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.profiles.handle.followers.verified", "method": "GET", "path": "/apis/v1/twitter/profiles/{handle}/followers/verified" }, "x-aisa-response-pending": { "operation_id": "twitter.profiles.handle.followers.verified", "path": "/apis/v1/twitter/profiles/{handle}/followers/verified", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/twitter/profiles/example/followers/verified \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-profiles-handle-followers-verified" } }, "/apis/v1/twitter/profiles/{handle}/following": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.profiles.handle.following", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "path", "name": "handle", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "by", "required": false, "schema": { "enum": [ "handle", "id" ], "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List accounts a Twitter profile follows", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "2ce8509356329ff4e10855cad085b1eac6a9a5345cb90d45e0e9daef0e950bbe", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2d98883ebd07" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.profiles.handle.following", "method": "GET", "path": "/apis/v1/twitter/profiles/{handle}/following" }, "x-aisa-response-pending": { "operation_id": "twitter.profiles.handle.following", "path": "/apis/v1/twitter/profiles/{handle}/following", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/twitter/profiles/example/following \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-profiles-handle-following" } }, "/apis/v1/twitter/profiles/{handle}/following/ids": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.profiles.handle.following.ids", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "path", "name": "handle", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "by", "required": false, "schema": { "enum": [ "handle", "id" ], "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "maximum": 5000, "minimum": 1, "type": "integer" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List following ids of a Twitter profile", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "380f9119325d26a3a5d3efb5aad1e78ac226ce1c69cad422172ed9e8e931e282", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "78c5aa69c575" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.profiles.handle.following.ids", "method": "GET", "path": "/apis/v1/twitter/profiles/{handle}/following/ids" }, "x-aisa-response-pending": { "operation_id": "twitter.profiles.handle.following.ids", "path": "/apis/v1/twitter/profiles/{handle}/following/ids", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/twitter/profiles/example/following/ids \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-profiles-handle-following-ids" } }, "/apis/v1/twitter/profiles/{handle}/subscriptions": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.profiles.handle.subscriptions", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "path", "name": "handle", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "by", "required": false, "schema": { "enum": [ "handle", "id" ], "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List Twitter profile subscriptions", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "62d32f675c8d0f6b3bfcccf846eabb7b408e7c93e67ab6e7e859d76e5024626d", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2b38ae1a16b1" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.profiles.handle.subscriptions", "method": "GET", "path": "/apis/v1/twitter/profiles/{handle}/subscriptions" }, "x-aisa-response-pending": { "operation_id": "twitter.profiles.handle.subscriptions", "path": "/apis/v1/twitter/profiles/{handle}/subscriptions", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/twitter/profiles/example/subscriptions \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-profiles-handle-subscriptions" } }, "/apis/v1/twitter/profiles/{handle}/tweets": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.profiles.handle.tweets", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "path", "name": "handle", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "by", "required": false, "schema": { "enum": [ "handle", "id" ], "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "in": "query", "name": "includePinned", "required": false, "schema": { "type": "boolean" } }, { "in": "query", "name": "includeReplies", "required": false, "schema": { "type": "boolean" } }, { "in": "query", "name": "limit", "required": false, "schema": { "maximum": 100, "minimum": 1, "type": "integer" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List Twitter profile tweets", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "58cabe2f9de2bbea1d02c25798348e4ee868f3e9f9a186ee8a1dd70e36b69d17", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "840c923f28bc" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.profiles.handle.tweets", "method": "GET", "path": "/apis/v1/twitter/profiles/{handle}/tweets" }, "x-aisa-response-pending": { "operation_id": "twitter.profiles.handle.tweets", "path": "/apis/v1/twitter/profiles/{handle}/tweets", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url https://api.aisa.one/apis/v1/twitter/profiles/example/tweets \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-profiles-handle-tweets" } }, "/apis/v1/twitter/search": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.search", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "maximum": 20, "minimum": 1, "type": "integer" } }, { "examples": { "default": { "value": "nike" }, "minimal": { "value": "nike" } }, "in": "query", "name": "query", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } }, { "in": "query", "name": "section", "required": false, "schema": { "enum": [ "latest", "people", "photos", "top", "videos" ], "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search Twitter posts", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "d8aec731d5580298d0e24b971e9f0f0d28051aebb43ebbca5974f1f0fc8c928c", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c9819a3e15e6" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.search", "method": "GET", "path": "/apis/v1/twitter/search" }, "x-aisa-response-pending": { "operation_id": "twitter.search", "path": "/apis/v1/twitter/search", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/search?query=nike' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-search" } }, "/apis/v1/twitter/spaces": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.spaces", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Twitter Space", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "a60a380c14f6cac17cde1db00d4d57f6e5fd778704ea5b3da3fcbdfc22bed923", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "607c6ba675e7" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.spaces", "method": "GET", "path": "/apis/v1/twitter/spaces" }, "x-aisa-response-pending": { "operation_id": "twitter.spaces", "path": "/apis/v1/twitter/spaces", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/spaces?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-spaces" } }, "/apis/v1/twitter/spaces/stream": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.spaces.stream", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Twitter Space stream URL", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "608b9f2eaa32e0594f527bd9560fa247581b782a9f6866f14e31bd0d7c81d781", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "955f4ed9b8ca" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.spaces.stream", "method": "GET", "path": "/apis/v1/twitter/spaces/stream" }, "x-aisa-response-pending": { "operation_id": "twitter.spaces.stream", "path": "/apis/v1/twitter/spaces/stream", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/spaces/stream?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-spaces-stream" } }, "/apis/v1/twitter/trends": { "get": { "description": "Get the trending topics for a location, identified by its Yahoo WOEID (Where On Earth ID), with an optional `count` (default 30). Use this for a real-time read on what a specific market is talking about right now — useful for timing content or spotting emerging stories. Returns trend names and volumes under `trends`. Once you pick a trend, search its posts with `get_twitter_tweet_advanced_search`.\n\n\nUsage-based billing; Default request estimate: $0.00015 USD (not a fixed price). Declared unit rate: $0.00001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_trends", "parameters": [ { "in": "query", "name": "count", "required": false, "schema": { "type": "string" }, "description": "The number of trends to return. Default is 30.\n\nProvider reference (supplier schema): `{\"default\":30,\"format\":\"int64\",\"minimum\":30,\"type\":\"integer\"}`." }, { "in": "query", "name": "woeid", "required": true, "schema": { "type": "string" }, "description": "The WOEID of the location. Example: 2418046.\n\nProvider reference (supplier schema): `{\"format\":\"int64\",\"type\":\"integer\"}`." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response0D1E98E052C3_TrendsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Trends By Woeid", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "plan_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.00015, "estimate_source": "profile_seed", "evidence_source": "request_snapshot", "request_cost_drivers": { "kind": "plan_units", "formula": { "fixed_units": 15 }, "inputs": [] }, "unit": "provider_credit", "unit_rate_usd": 1e-05 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4dd4f02a35fa", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0d239da949bc" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/trends", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_trends", "method": "ANY", "path": "/apis/v1/twitter/trends" }, "x-aisa-provider-required": [ "query:woeid" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-trend.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:c2dcea005091228c0b9fefb79b33da32d8cdfee7a7e15e403335389f5d2de104", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:0a887cb8bf5c3dca62b2d8c2a06eca4b30e95d3316741b18d7f9052a72e20c63" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-trend.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:c2dcea005091228c0b9fefb79b33da32d8cdfee7a7e15e403335389f5d2de104", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:0a887cb8bf5c3dca62b2d8c2a06eca4b30e95d3316741b18d7f9052a72e20c63" }, "content_hash": "sha256:9f10c11b7938e6c9afbb987c46f048c603e5dd33ce1f98e00db9a31391ba50af" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-trends" } }, "/apis/v1/twitter/tweet/advanced_search": { "get": { "description": "Search X posts by keyword or query with X's advanced search operators, sorted by Latest (default) or Top. This is the primary entry point for X content research when you do not yet have tweet IDs or handles. Supports operators in the query string such as `from:`, `to:`, `since:`, `until:`, `min_faves:`, and `-filter:replies`. Cursor-paginated; returns tweets with `has_next_page` and `next_cursor`. To search accounts rather than posts use `get_twitter_user_search`. To read one account's own posts use `get_twitter_user_tweet_timeline`.\n\n\nUsage-based billing; Default request estimate: $0.003 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_tweet_advanced_search", "parameters": [ { "in": "query", "name": "count", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" }, "description": "The cursor to paginate through the results. First page is empty." }, { "in": "query", "name": "max_results", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "query", "required": true, "schema": { "type": "string" }, "description": "The query to search for." }, { "in": "query", "name": "queryType", "required": true, "schema": { "type": "string" }, "description": "The query type to search for.\n\nProvider reference (supplier schema): `{\"default\":\"Latest\",\"enum\":[\"Latest\",\"Top\"],\"type\":\"string\"}`." }, { "in": "query", "name": "start_time", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseCbc4F8806E32_AdvancedSearchResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Advanced Search", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": true }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5b0680192898" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/tweet/advanced_search", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_tweet_advanced_search", "method": "ANY", "path": "/apis/v1/twitter/tweet/advanced_search" }, "x-aisa-provider-required": [ "query:query", "query:queryType" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:773d9c7f416c89c5aa82bec4696f61a9862a55962d47cdd3f47cf0cb512d2d8b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4aa234e7f6d4f6d581af3f46c6075b5fd75a05cf89f7855afc2f695854f37465" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:773d9c7f416c89c5aa82bec4696f61a9862a55962d47cdd3f47cf0cb512d2d8b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4aa234e7f6d4f6d581af3f46c6075b5fd75a05cf89f7855afc2f695854f37465" }, "content_hash": "sha256:3bb724bff13b6ff36920e6e80e29318069ff49e82bddb0099bccaab893fec364" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-tweet-advanced-search" } }, "/apis/v1/twitter/tweet/quotes": { "get": { "description": "Get quote tweets of a given tweet — posts that embedded it with added commentary — cursor-paginated. Use this to see how a post is being reframed or argued about, which is often more revealing than plain replies. Returns full tweet objects with engagement counts. For direct replies use `get_twitter_tweet_replies_v2`; for accounts that amplified it without comment use `get_twitter_tweet_retweeters`.\n\n\nUsage-based billing; Default request estimate: $0.003 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_tweet_quotes", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" }, "description": "Cursor for pagination." }, { "in": "query", "name": "includeReplies", "required": false, "schema": { "type": "boolean" }, "description": "Whether to include replies in the results. Default is True.\n\nProvider reference (supplier schema): `{\"default\":true,\"type\":\"boolean\"}`." }, { "in": "query", "name": "sinceTime", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": 0, "type": "integer" }, "description": "On or after a specified unix timestamp in seconds.\n\nProvider reference (supplier schema): `{\"format\":\"int64\",\"type\":\"integer\"}`." }, { "in": "query", "name": "tweetId", "required": true, "schema": { "type": "string" }, "description": "The tweet ID to get quotes for." }, { "in": "query", "name": "untilTime", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": 0, "type": "integer" }, "description": "Before a specified unix timestamp in seconds.\n\nProvider reference (supplier schema): `{\"format\":\"int64\",\"type\":\"integer\"}`." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "tweets": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseE9424F954Db0_Tweet" } }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": "string" }, "status": { "type": "string" }, "msg": { "type": "string" } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Tweet Quotations", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fc69b7590846" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/tweet/quotes", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_tweet_quotes", "method": "ANY", "path": "/apis/v1/twitter/tweet/quotes" }, "x-aisa-provider-required": [ "query:tweetId" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:b03efa24fe4bfbc96f854b24e1665becd75992cb34c5da7fb23560a0117243b6", "converter": "reviewed-official-query-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:939fd1b4ec54628490e5dbb1992c6452a26dab34c67260202ed1fff837d1a2a2", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea" }, "scope": "Exact optional query additions in docs/current-source-review-20261017/query-parameter-primary-fragments.json; other declarations and source policy retained." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:b03efa24fe4bfbc96f854b24e1665becd75992cb34c5da7fb23560a0117243b6", "converter": "reviewed-official-query-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:939fd1b4ec54628490e5dbb1992c6452a26dab34c67260202ed1fff837d1a2a2", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea" }, "scope": "Exact optional query additions in docs/current-source-review-20261017/query-parameter-primary-fragments.json; other declarations and source policy retained." }, "content_hash": "sha256:bbd167c6274f5edaa8670da1523dc5c9927b17cc592996f55b15d6b4a2994e99" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-tweet-quotes" } }, "/apis/v1/twitter/tweet/replies": { "get": { "description": "Get the direct replies to a tweet, cursor-paginated. Use this to read the discussion under a post — sentiment, corrections, or follow-up questions. Returns full tweet objects with engagement counts. Prefer `get_twitter_tweet_replies_v2` when you want to control ordering (Relevance, Latest, or Likes); this v1 endpoint returns the default order only. To follow a conversation upward to its root instead of downward, use `get_twitter_tweet_thread_context`.\n\n\nUsage-based billing; Default request estimate: $0.01335 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_tweet_replies", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" }, "description": "Cursor for pagination." }, { "in": "query", "name": "queryType", "required": false, "schema": { "enum": [ "Latest", "Likes", "Relevance" ], "type": "string" }, "description": "Sort order for replies. Default is Relevance.\n\nProvider reference (supplier schema): `{\"default\":\"Relevance\",\"type\":\"string\"}`." }, { "in": "query", "name": "tweetId", "required": true, "schema": { "type": "string" }, "description": "The tweet ID to get replies for." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "has_next_page": { "type": "boolean" }, "next_cursor": { "type": "string" }, "status": { "type": "string" }, "tweets": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseE9424F954Db0_Tweet" }, "description": "Array of reply tweets." }, "msg": { "type": "string" } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Tweet Replies", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01335, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "dc415b051c6b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/tweet/replies/v2", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_tweet_replies", "method": "ANY", "path": "/apis/v1/twitter/tweet/replies" }, "x-aisa-provider-required": [ "query:tweetId" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:b03efa24fe4bfbc96f854b24e1665becd75992cb34c5da7fb23560a0117243b6", "converter": "reviewed-official-query-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:939fd1b4ec54628490e5dbb1992c6452a26dab34c67260202ed1fff837d1a2a2", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea" }, "scope": "Exact optional query additions in docs/current-source-review-20261017/query-parameter-primary-fragments.json; other declarations and source policy retained." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:b03efa24fe4bfbc96f854b24e1665becd75992cb34c5da7fb23560a0117243b6", "converter": "reviewed-official-query-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:939fd1b4ec54628490e5dbb1992c6452a26dab34c67260202ed1fff837d1a2a2", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea" }, "scope": "Exact optional query additions in docs/current-source-review-20261017/query-parameter-primary-fragments.json; other declarations and source policy retained." }, "content_hash": "sha256:a0fae25fa3137b9f844f5fb8be39a9fc67351999973350163106fff1b9f2cdd0" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-tweet-replies" } }, "/apis/v1/twitter/tweet/replies/v2": { "get": { "description": "Get replies to a tweet with control over sort order — Relevance (default), Latest, or Likes — 20 per page, cursor-paginated. Use this instead of `get_twitter_tweet_replies` whenever ordering matters: Likes surfaces the community's top responses, Latest gives a live view of an unfolding thread. Returns full tweet objects with engagement counts.\n\n\nUsage-based billing; Default request estimate: $0.01095 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_tweet_replies_v2", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" }, "description": "Cursor for paginating through results. Leave empty for the first page." }, { "in": "query", "name": "queryType", "required": false, "schema": { "type": "string" }, "description": "Sort order for replies. Default is Relevance.\n\nProvider reference (supplier schema): `{\"default\":\"Relevance\",\"enum\":[\"Relevance\",\"Latest\",\"Likes\"],\"type\":\"string\"}`." }, { "in": "query", "name": "tweetId", "required": true, "schema": { "type": "string" }, "description": "The tweet ID to get replies for. e.g. 1846987139428634858" } ], "responses": { "200": { "description": "Tweet replies response", "content": { "application/json": { "schema": { "type": "object", "properties": { "has_next_page": { "type": "boolean", "description": "Indicates if there are more results available" }, "next_cursor": { "type": "string", "description": "Cursor for fetching the next page of results" }, "status": { "type": "string", "enum": [ "success", "error" ], "example": "success", "description": "Status of the request" }, "tweets": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseD8D8F324D259_Tweet" }, "description": "Array of reply tweets." }, "msg": { "type": "string", "description": "Error message if status is error." } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Tweet Replies V2", "tags": [ "group1500" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01095, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "27bd8dd92ba2" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/tweet/replies/v2", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_tweet_replies_v2", "method": "ANY", "path": "/apis/v1/twitter/tweet/replies/v2" }, "x-aisa-provider-required": [ "query:tweetId" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-replies-v2.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:73e0f30e3276deb4f2c159ef47c2058ea84de8925db773ebdd9394531bf6724b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:5a01351b21659dc9e183db21c6c0a93a4efa205bdd306112bf53d55dba34ceaf" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-replies-v2.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:73e0f30e3276deb4f2c159ef47c2058ea84de8925db773ebdd9394531bf6724b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:5a01351b21659dc9e183db21c6c0a93a4efa205bdd306112bf53d55dba34ceaf" }, "content_hash": "sha256:f9b70915fbae3a89d5b479edfa05df3fd30f96dc881e6d766ebeada86b402c68" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-tweet-replies-v2" } }, "/apis/v1/twitter/tweet/retweeters": { "get": { "description": "List the accounts that retweeted a given tweet, cursor-paginated. Use this to map who amplified a message and how influential they are. Returns user objects (handle, name, bio, follower count, verification) — not tweets. For retweets that added commentary use `get_twitter_tweet_quotes`.\n\n\nUsage-based billing; Default request estimate: $0.0036 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_tweet_retweeters", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "users": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseE9424F954Db0_User" } }, "has_next_page": { "type": "boolean" }, "next_cursor": { "type": "string" }, "status": { "type": "string" }, "msg": { "type": "string" } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Tweet Retweeters", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0036, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4a33b07d4b00" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/tweet/retweeters", "x-aisa-validation": "provider", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_tweet_retweeters", "method": "ANY", "path": "/apis/v1/twitter/tweet/retweeters" }, "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" }, "description": "Cursor for pagination." }, { "name": "tweetId", "in": "query", "required": true, "schema": { "type": "string" }, "description": "The tweet ID to get retweeters for." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:b03efa24fe4bfbc96f854b24e1665becd75992cb34c5da7fb23560a0117243b6", "converter": "reviewed-official-query-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:939fd1b4ec54628490e5dbb1992c6452a26dab34c67260202ed1fff837d1a2a2", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea" }, "scope": "Exact optional query additions in docs/current-source-review-20261017/query-parameter-primary-fragments.json; other declarations and source policy retained." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:b03efa24fe4bfbc96f854b24e1665becd75992cb34c5da7fb23560a0117243b6", "converter": "reviewed-official-query-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:939fd1b4ec54628490e5dbb1992c6452a26dab34c67260202ed1fff837d1a2a2", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea" }, "scope": "Exact optional query additions in docs/current-source-review-20261017/query-parameter-primary-fragments.json; other declarations and source policy retained." }, "content_hash": "sha256:7a1740e3998a07076c1e844bcfa140bcce678c0272073711c9553d5123411005" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-tweet-retweeters" } }, "/apis/v1/twitter/tweet/thread_context": { "get": { "description": "Reconstruct the conversation around a tweet. Accepts either a reply or an original tweet and returns the surrounding thread, cursor-paginated. Use this when a tweet lacks context on its own and you need the parent chain to interpret it correctly. Returns tweets under `tweets` with `has_next_page` and `next_cursor`. For only the replies below a post use `get_twitter_tweet_replies_v2`.\n\n\nUsage-based billing; Default request estimate: $0.00555 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_tweet_thread_context", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" }, "description": "The cursor to paginate through the results. First page is empty." }, { "in": "query", "name": "tweetId", "required": true, "schema": { "type": "string" }, "description": "The tweet ID to get. Can be a reply tweet or an original tweet." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseCbc4F8806E32_TweetThreadContextResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Tweet Thread Context", "tags": [ "group2700" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.00555, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9658950712f7" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/tweet/thread_context", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_tweet_thread_context", "method": "ANY", "path": "/apis/v1/twitter/tweet/thread_context" }, "x-aisa-provider-required": [ "query:tweetId" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:773d9c7f416c89c5aa82bec4696f61a9862a55962d47cdd3f47cf0cb512d2d8b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4aa234e7f6d4f6d581af3f46c6075b5fd75a05cf89f7855afc2f695854f37465" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:773d9c7f416c89c5aa82bec4696f61a9862a55962d47cdd3f47cf0cb512d2d8b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:4aa234e7f6d4f6d581af3f46c6075b5fd75a05cf89f7855afc2f695854f37465" }, "content_hash": "sha256:092d2d5665c09626f53cad01256b324cfd5c67747e44a017c31dd5c9bf3b4495" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-tweet-thread-context" } }, "/apis/v1/twitter/tweets": { "get": { "description": "Fetch the full content of specific tweets when you already know their numeric tweet IDs (accepts multiple IDs in one call). Use this to expand IDs surfaced by search, timelines, or replies into complete objects. Returns text, author, source client, language, creation time, and engagement counts (likes, retweets, replies, quotes, bookmarks, views). If you do not have IDs yet, start with `get_twitter_tweet_advanced_search`.\n\n\nUsage-based billing; Default request estimate: $0.0075 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_tweets", "parameters": [ { "in": "query", "name": "tweet_ids", "required": true, "schema": { "type": "string" }, "description": "Comma-separated list of tweet IDs." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "tweets": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseE9424F954Db0_Tweet" } }, "status": { "type": "string" }, "msg": { "type": "string" }, "code": { "type": "integer" } } } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Tweets By IDs", "tags": [ "group900" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0075, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "627da9e2d456" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/tweets", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_tweets", "method": "ANY", "path": "/apis/v1/twitter/tweets" }, "x-aisa-provider-required": [ "query:tweet_ids" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:b03efa24fe4bfbc96f854b24e1665becd75992cb34c5da7fb23560a0117243b6", "converter": "reviewed-official-query-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:939fd1b4ec54628490e5dbb1992c6452a26dab34c67260202ed1fff837d1a2a2", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea" }, "scope": "Exact optional query additions in docs/current-source-review-20261017/query-parameter-primary-fragments.json; other declarations and source policy retained." }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:b03efa24fe4bfbc96f854b24e1665becd75992cb34c5da7fb23560a0117243b6", "converter": "reviewed-official-query-amendment@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea", "prior_source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-tweet-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:939fd1b4ec54628490e5dbb1992c6452a26dab34c67260202ed1fff837d1a2a2", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:6994dedc0ea348c51a4f369debbce35f06c439991e96ac063b3a78f952b9eaea" }, "scope": "Exact optional query additions in docs/current-source-review-20261017/query-parameter-primary-fragments.json; other declarations and source policy retained." }, "content_hash": "sha256:461cd814c15191f2e40bce51aa51c98c558a724315810c177b773a9bfd44bf88" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-tweets" } }, "/apis/v1/twitter/tweets/batch": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.tweets.batch", "parameters": [ { "examples": { "default": { "value": [ "example" ] }, "minimal": { "value": [ "example" ] } }, "explode": true, "in": "query", "name": "url", "required": true, "schema": { "items": { "type": "string" }, "maxItems": 200, "minItems": 1, "type": "array" }, "style": "form" } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get multiple tweets", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "517c12b15c744223883da80ff8235531fd38fb092e33950574bbcd6f9dfee1f8", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "40d70eb2edb9" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.tweets.batch", "method": "GET", "path": "/apis/v1/twitter/tweets/batch" }, "x-aisa-response-pending": { "operation_id": "twitter.tweets.batch", "path": "/apis/v1/twitter/tweets/batch", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-tweets-batch" } }, "/apis/v1/twitter/tweets/quotes": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.tweets.quotes", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List quote tweets of a tweet", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "ad0241dfd29baa5b286eb2666092a01d9d0e28cd59eb4940a33035b2640c7ef3", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cfcbb0334307" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.tweets.quotes", "method": "GET", "path": "/apis/v1/twitter/tweets/quotes" }, "x-aisa-response-pending": { "operation_id": "twitter.tweets.quotes", "path": "/apis/v1/twitter/tweets/quotes", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/tweets/quotes?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-tweets-quotes" } }, "/apis/v1/twitter/tweets/replies": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.tweets.replies", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "in": "query", "name": "sortBy", "required": false, "schema": { "enum": [ "likes", "recency", "relevance" ], "maxLength": 4096, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List Twitter tweet replies", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "c08ee45251676f58f5564fbe45e24fb45b328ed0a3be784b267f80613c765f99", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a2132c77f12c" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.tweets.replies", "method": "GET", "path": "/apis/v1/twitter/tweets/replies" }, "x-aisa-response-pending": { "operation_id": "twitter.tweets.replies", "path": "/apis/v1/twitter/tweets/replies", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/tweets/replies?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-tweets-replies" } }, "/apis/v1/twitter/tweets/retweets": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.tweets.retweets", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List accounts that retweeted a tweet", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "83ccbcbabde9702bce9075ada2d3948e869f1107423c9201c184b604edf7ce5e", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "939f1c3aeb5d" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.tweets.retweets", "method": "GET", "path": "/apis/v1/twitter/tweets/retweets" }, "x-aisa-response-pending": { "operation_id": "twitter.tweets.retweets", "path": "/apis/v1/twitter/tweets/retweets", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/tweets/retweets?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-tweets-retweets" } }, "/apis/v1/twitter/tweets/transcript": { "get": { "description": "\nUsage-based billing; Default request estimate: $8.414 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "twitter.tweets.transcript", "parameters": [ { "in": "query", "name": "allowLongTranscription", "required": false, "schema": { "type": "boolean" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Twitter tweet transcript", "tags": [ "Twitter" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 8.414, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 601, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "34fab7eb794b2d77fcd5362969913c8f2203b168e325094c843d6075f7e979ef", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1f058996508f" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "twitter.tweets.transcript", "method": "GET", "path": "/apis/v1/twitter/tweets/transcript" }, "x-aisa-response-pending": { "operation_id": "twitter.tweets.transcript", "path": "/apis/v1/twitter/tweets/transcript", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/tweets/transcript?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/twitter-tweets-transcript" } }, "/apis/v1/twitter/user/batch_info_by_ids": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.00018 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_user_batch_info_by_ids", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "userIds", "required": true, "schema": { "type": "string", "x-aisa-delimiter": ",", "x-aisa-maxItems": 100000, "x-aisa-minItems": 1 } } ], "responses": { "200": { "description": "Batch user information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseB5Ae154C25F3_BatchUserInfoResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Batch Get User Info By UserIds", "tags": [ "group180" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-pricing": { "cost_contract": "request_formula", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.00018, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "62aca355a6b8b8f0e3fd2ceef18388716be2efc9a6a354ce13b30562f3c30e58", "x-aisa-response-upstream-path-sha256": "058e3d0459f7ef77df1a843b4aaf97269c29121af5cc47722c3b6eb7befe78e5", "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f3439dfd5964" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_user_batch_info_by_ids", "method": "GET", "path": "/apis/v1/twitter/user/batch_info_by_ids" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/3a00a91fb8db83d033b3008209c0d598d3866c54/openapi/twitter-user-batch_01.json", "source_revision": "3a00a91fb8db83d033b3008209c0d598d3866c54", "converter": "scripts/prepare_response_source_migration.py@1", "refresh_policy": "pinned", "refresh_reason": "Public response migration requires per-route binding and semantic review.", "response_only": true, "path_space": "public", "upstream_path_sha256": "058e3d0459f7ef77df1a843b4aaf97269c29121af5cc47722c3b6eb7befe78e5", "upstream_origin_sha256": "62aca355a6b8b8f0e3fd2ceef18388716be2efc9a6a354ce13b30562f3c30e58", "content_hash": "sha256:acf8acceee6a383eea2ef3be4bc51547beb1ee44a6bbf5271fb46504e66e6660", "source_document_sha256": "f04b3793855c293d76cc695b73eaf3ee4f35e1160125bb6bdbddfd7a1687d106", "review_evidence": "Retain the exact existing typed public response from pinned AIsa Docs 3a00a91fb8db83d033b3008209c0d598d3866c54; operation ID and public route match. The current SELECT-only metadata proves the same Profile reference as frozen W0, verified target ownership, no query/encoding/managed transform, and the expected official provider origin. No response fields, requiredness, examples, or status were inferred or widened. Actual complete current Runtime projection and release approval remain required.", "fetched_at": "2026-10-08T16:19:47.155165+00:00", "owner": "AIsa-team/docs", "review_period_days": 30, "policy_revision": "sha256:4f3ecb91677e9e0abc6ea6edabc8b39a8a388fb264880820acab8a3e2b6804d6" }, "content_hash": "sha256:1ef43eba587d6db76d744e5f4e6b435d796b0354ef25213c000d134bffeaed18" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/twitter/user/batch_info_by_ids?userIds=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-user-batch-info-by-ids" } }, "/apis/v1/twitter/user/check_follow_relationship": { "get": { "description": "Check whether one X user follows another, in both directions, by @handle. Use this for a single targeted lookup instead of paging through `get_twitter_user_followers` or `get_twitter_user_followings` — it answers 'does A follow B, and does B follow A' in one request. Returns the relationship flags under `data`.\n\n\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_user_check_follow_relationship", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response078307E096De_FollowRelationshipResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Check Follow Relationship", "tags": [ "group500" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.001, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "4dd4f02a35fa", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f6b9cfc53caf" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/user/check_follow_relationship", "x-aisa-validation": "provider", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_user_check_follow_relationship", "method": "ANY", "path": "/apis/v1/twitter/user/check_follow_relationship" }, "parameters": [ { "name": "source_user_name", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Screen name of the source user." }, { "name": "target_user_name", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Screen name of the target user." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:db6f49611fec9b5d7c5372cc6a459acd3ee7ed23268c0b8326d46ad525e39f97", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:584eb30027521a1c196d49c2423c791cf1fa74e217942b3b94a5491011dd42e0" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:db6f49611fec9b5d7c5372cc6a459acd3ee7ed23268c0b8326d46ad525e39f97", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:584eb30027521a1c196d49c2423c791cf1fa74e217942b3b94a5491011dd42e0" }, "content_hash": "sha256:7a8ee116adf797d2861d3a30583b1933d657eeb28a31e213a2f02a0b4414fa90" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-user-check-follow-relationship" } }, "/apis/v1/twitter/user/followers": { "get": { "description": "List the accounts that follow a given X user, identified by @handle, newest follower first. Returns up to 200 per page by default with `has_next_page` and `next_cursor`; each entry is a full user object (handle, name, bio, follower count, verification). Use this for audience analysis, mapping a competitor's follower base, or finding influential followers. For the reverse direction (who this user follows) use `get_twitter_user_followings`. For only the verified subset use `get_twitter_user_verified_followers` — note that one takes a numeric `user_id`, not a handle.\n\n\nUsage-based billing; Default request estimate: $0.00326 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_user_followers", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" }, "description": "Cursor for pagination" }, { "in": "query", "name": "pageSize", "required": false, "schema": { "maximum": 200, "minimum": 20, "type": "integer" }, "description": "Number of followers per page\n\nProvider reference (supplier schema): `{\"default\":200,\"type\":\"integer\"}`." }, { "in": "query", "name": "userName", "required": true, "schema": { "type": "string" }, "description": "Screen name of the user" } ], "responses": { "200": { "description": "User followers", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseAd3D19335Ae4_UserFollowersResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List User Followers", "tags": [ "group15000" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.00326, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.0006 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2a13fe2d2813" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/user/followers", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_user_followers", "method": "ANY", "path": "/apis/v1/twitter/user/followers" }, "x-aisa-provider-required": [ "query:userName" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:4890cc28515468508897c20c452517b4ac0c235bbc167cf90797ad9223d3701b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:57943a326c6b35fa15683ce948758ba7dc221c485bca893f7de1473cf6094478" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:4890cc28515468508897c20c452517b4ac0c235bbc167cf90797ad9223d3701b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:57943a326c6b35fa15683ce948758ba7dc221c485bca893f7de1473cf6094478" }, "content_hash": "sha256:6ed7e5233f2f6f3013f9b786b41db83e93c4b50f6b1eb2e6bc0ed3ac6b1d2fb8" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-user-followers" } }, "/apis/v1/twitter/user/followings": { "get": { "description": "List the accounts a given X user follows, identified by @handle. Returns 200 entries per page with `has_next_page` and `next_cursor`. Use this to infer a user's interests, information sources, or professional network — who someone follows is usually a stronger signal of intent than who follows them. For the opposite direction use `get_twitter_user_followers`. To test a single specific pair without paging through thousands of records, use `get_twitter_user_check_follow_relationship`.\n\n\nUsage-based billing; Default request estimate: $0.0036 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_user_followings", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" }, "description": "The cursor to paginate through the results. First page is empty." }, { "in": "query", "name": "pageSize", "required": false, "schema": { "maximum": 200, "minimum": 20, "type": "integer" }, "description": "The number of followings to return per page.\n\nProvider reference (supplier schema): `{\"default\":200,\"type\":\"integer\"}`." }, { "in": "query", "name": "userName", "required": true, "schema": { "type": "string" }, "description": "Screen name of the user." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response078307E096De_UserFollowingsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "List User Followings", "tags": [ "group15000" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0036, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.0006 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "43c7357bde88" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/user/followings", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_user_followings", "method": "ANY", "path": "/apis/v1/twitter/user/followings" }, "x-aisa-provider-required": [ "query:userName" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:db6f49611fec9b5d7c5372cc6a459acd3ee7ed23268c0b8326d46ad525e39f97", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:584eb30027521a1c196d49c2423c791cf1fa74e217942b3b94a5491011dd42e0" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:db6f49611fec9b5d7c5372cc6a459acd3ee7ed23268c0b8326d46ad525e39f97", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:584eb30027521a1c196d49c2423c791cf1fa74e217942b3b94a5491011dd42e0" }, "content_hash": "sha256:86ed01eceb589fff00a143173f4d66187450a1af8c02fff8f9ab0bd5955f9d32" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-user-followings" } }, "/apis/v1/twitter/user/info": { "get": { "description": "Look up one X (Twitter) user's public profile by @handle (screen name). Use this when you need to know who an account is — identity, reach, or credibility — before deciding whether to trust or analyze their content. Returns display name, bio, follower/following counts, verification status, account creation date, location, and profile images. If you only have a numeric user ID, use `get_twitter_user_batch_info_by_ids` instead. If you need extended profile metadata such as country or username-change history, use `get_twitter_user_about`. If you want their posts rather than their profile, use `get_twitter_user_tweet_timeline`.\n\n\nPublished reference price: $0.00018 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_user_info", "parameters": [ { "in": "query", "name": "userName", "required": true, "schema": { "type": "string" }, "description": "The screen name of the user" } ], "responses": { "200": { "description": "User information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseAd3D19335Ae4_UserInfoResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get User Info", "tags": [ "group180" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.00018, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4dd4f02a35fa", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7f0838d97c52" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/user/info", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_user_info", "method": "ANY", "path": "/apis/v1/twitter/user/info" }, "x-aisa-provider-required": [ "query:userName" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:4890cc28515468508897c20c452517b4ac0c235bbc167cf90797ad9223d3701b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:57943a326c6b35fa15683ce948758ba7dc221c485bca893f7de1473cf6094478" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:4890cc28515468508897c20c452517b4ac0c235bbc167cf90797ad9223d3701b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:57943a326c6b35fa15683ce948758ba7dc221c485bca893f7de1473cf6094478" }, "content_hash": "sha256:788baf41c76ca1ee37692ac13f6f274ae4f123555fa92dcd5bc1b41f3b73c888" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-user-info" } }, "/apis/v1/twitter/user/last_tweets": { "get": { "description": "Get a user's most recent tweets, accepting either `userName` (@handle) or `userId` — useful when you have not resolved the handle to an ID yet. Optionally include replies. Cursor-paginated. Returns tweets under `data` with `has_next_page` and `next_cursor`. Use `get_twitter_user_tweet_timeline` instead when you already have the numeric ID and want the full profile-order timeline with parent-tweet expansion.\n\n\nUsage-based billing; Default request estimate: $0.003 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_user_last_tweets", "parameters": [ { "in": "query", "name": "count", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" }, "description": "Cursor for pagination" }, { "in": "query", "name": "includeReplies", "required": false, "schema": { "type": "string" }, "description": "Include replies in the results\n\nProvider reference (supplier schema): `{\"default\":false,\"type\":\"boolean\"}`." }, { "in": "query", "name": "userId", "required": false, "schema": { "type": "string" }, "description": "User ID of the user" }, { "in": "query", "name": "userName", "required": false, "schema": { "type": "string" }, "description": "Screen name of the user" } ], "responses": { "200": { "description": "User tweets", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseAd3D19335Ae4_UserTweetsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get User Tweets", "tags": [ "group1500" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "660c38f8ee91" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/user/last_tweets", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_user_last_tweets", "method": "ANY", "path": "/apis/v1/twitter/user/last_tweets" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:4890cc28515468508897c20c452517b4ac0c235bbc167cf90797ad9223d3701b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:57943a326c6b35fa15683ce948758ba7dc221c485bca893f7de1473cf6094478" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:4890cc28515468508897c20c452517b4ac0c235bbc167cf90797ad9223d3701b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:57943a326c6b35fa15683ce948758ba7dc221c485bca893f7de1473cf6094478" }, "content_hash": "sha256:1a133ba985f90d406e3c3b9a70066d2a087a581290803a1f4ba66e6b7421b864" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-user-last-tweets" } }, "/apis/v1/twitter/user/mentions": { "get": { "description": "Get tweets that mention a given @handle, 20 per page. This is the only user-scoped X endpoint that supports a time window: pass `sinceTime` and/or `untilTime` as Unix timestamps in seconds to bound the range. Use this for monitoring — brand mentions, inbound replies, reputation tracking, or 'what happened to this account in the last 24 hours'. Returns tweets with `has_next_page` and `next_cursor`. For the account's own posts rather than mentions of it, use `get_twitter_user_tweet_timeline`.\n\n\nUsage-based billing; Default request estimate: $0.003 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_user_mentions", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" }, "description": "The cursor to paginate through the results. First page is empty." }, { "in": "query", "name": "sinceTime", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": 0, "type": "integer" }, "description": "On or after a specified unix timestamp in seconds.\n\nProvider reference (supplier schema): `{\"format\":\"int64\",\"type\":\"integer\"}`." }, { "in": "query", "name": "untilTime", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": 0, "type": "integer" }, "description": "Before a specified unix timestamp in seconds.\n\nProvider reference (supplier schema): `{\"format\":\"int64\",\"type\":\"integer\"}`." }, { "in": "query", "name": "userName", "required": true, "schema": { "type": "string" }, "description": "The user screen name to get mentions for." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response078307E096De_UserMentionsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get User Mentions", "tags": [ "group1500" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.003, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "47809c1df93c" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/user/mentions", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_user_mentions", "method": "ANY", "path": "/apis/v1/twitter/user/mentions" }, "x-aisa-provider-required": [ "query:userName" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:db6f49611fec9b5d7c5372cc6a459acd3ee7ed23268c0b8326d46ad525e39f97", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:584eb30027521a1c196d49c2423c791cf1fa74e217942b3b94a5491011dd42e0" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:db6f49611fec9b5d7c5372cc6a459acd3ee7ed23268c0b8326d46ad525e39f97", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:584eb30027521a1c196d49c2423c791cf1fa74e217942b3b94a5491011dd42e0" }, "content_hash": "sha256:f281705c5f2906b8d686586b450d4a62c465200cb84723d972c5a1c8d38d2cd1" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-user-mentions" } }, "/apis/v1/twitter/user/search": { "get": { "description": "Search X user accounts by keyword and get back matching profiles. Use this when you know roughly who you are looking for — a company name, a topic, a partial handle — but not the exact @handle. Cursor-paginated; returns full user objects under `users`. This searches accounts, not posts; to search tweet content use `get_twitter_tweet_advanced_search`.\n\n\nUsage-based billing; Default request estimate: $0.0036 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_user_search", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" }, "description": "The cursor to paginate through the results. First page is empty." }, { "in": "query", "name": "query", "required": true, "schema": { "type": "string" }, "description": "The keyword to search." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response078307E096De_SearchUserResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search Users", "tags": [ "group500" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0036, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4775d422275f" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/user/search", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_user_search", "method": "ANY", "path": "/apis/v1/twitter/user/search" }, "x-aisa-provider-required": [ "query:query" ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:db6f49611fec9b5d7c5372cc6a459acd3ee7ed23268c0b8326d46ad525e39f97", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:584eb30027521a1c196d49c2423c791cf1fa74e217942b3b94a5491011dd42e0" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:db6f49611fec9b5d7c5372cc6a459acd3ee7ed23268c0b8326d46ad525e39f97", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:584eb30027521a1c196d49c2423c791cf1fa74e217942b3b94a5491011dd42e0" }, "content_hash": "sha256:3e50ad830639b492dd1bf35713754e1f5be241cc0a7d9b878a4c46bc8e7cadc8" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-user-search" } }, "/apis/v1/twitter/user/tweet_timeline": { "get": { "description": "Retrieve a user's own tweets by numeric `userId`, newest first, matching the order shown on their profile in the X app. Up to 20 tweets per page; pass the returned cursor for more. Optionally include replies and the parent tweet of each reply. Use this to read what an account publishes over time. Time-range filtering is NOT supported here — if you need tweets within a specific time window, use `get_twitter_user_mentions` (which accepts `sinceTime`/`untilTime`) or `get_twitter_tweet_advanced_search` with date operators in the query. If you only have a @handle, `get_twitter_user_last_tweets` accepts either handle or ID.\n\n\nUsage-based billing; Default request estimate: $0.0057 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_user_tweet_timeline", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" }, "description": "Cursor for paginating through results. Leave empty for the first page." }, { "in": "query", "name": "includeParentTweet", "required": false, "schema": { "type": "string" }, "description": "Whether to include the parent tweet when a tweet is a reply. Defaults to false.\n\nProvider reference (supplier schema): `{\"default\":false,\"type\":\"boolean\"}`." }, { "in": "query", "name": "includeReplies", "required": false, "schema": { "type": "string" }, "description": "Whether to include replies in the results. Defaults to false.\n\nProvider reference (supplier schema): `{\"default\":false,\"type\":\"boolean\"}`." }, { "in": "query", "name": "userId", "required": false, "schema": { "type": "string" }, "description": "User ID of the user whose timeline to retrieve." }, { "in": "query", "name": "userName", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "User tweet timeline", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseAd3D19335Ae4_UserTweetsResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get User TimeLine", "tags": [ "group1500" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0057, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "21ac0943ffa8" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/user/tweet_timeline", "x-aisa-validation": "mixed", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_user_tweet_timeline", "method": "ANY", "path": "/apis/v1/twitter/user/tweet_timeline" }, "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:4890cc28515468508897c20c452517b4ac0c235bbc167cf90797ad9223d3701b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:57943a326c6b35fa15683ce948758ba7dc221c485bca893f7de1473cf6094478" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:4890cc28515468508897c20c452517b4ac0c235bbc167cf90797ad9223d3701b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:57943a326c6b35fa15683ce948758ba7dc221c485bca893f7de1473cf6094478" }, "content_hash": "sha256:e4227a3207b827a2dda973d29c018e3879e2be54291e82595f1eb03e60d45440" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-user-tweet-timeline" } }, "/apis/v1/twitter/user/verifiedFollowers": { "get": { "description": "List only the verified accounts following a given X user, in reverse chronological order. Use this to gauge the quality rather than the size of an audience — verified followers are a better credibility signal than raw follower count. Cursor-paginated. Takes a numeric `user_id`, not a @handle; resolve the handle first with `get_twitter_user_info`. For the complete follower list use `get_twitter_user_followers`.\n\n\nUsage-based billing; Default request estimate: $0.006 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_user_verified_followers", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response078307E096De_VerifiedFollowersResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Verified Followers", "tags": [ "group180" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.006, "estimate_source": "profile_seed", "evidence_source": "response_body", "minimum_cost_usd": 0.00015 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "4d7766c610bb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "583a51023e02" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/user/verifiedFollowers", "x-aisa-validation": "provider", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_user_verified_followers", "method": "ANY", "path": "/apis/v1/twitter/user/verifiedFollowers" }, "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" }, "description": "The cursor to paginate through the results. First page is empty." }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "User ID of the user." } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:db6f49611fec9b5d7c5372cc6a459acd3ee7ed23268c0b8326d46ad525e39f97", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:584eb30027521a1c196d49c2423c791cf1fa74e217942b3b94a5491011dd42e0" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_02.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:db6f49611fec9b5d7c5372cc6a459acd3ee7ed23268c0b8326d46ad525e39f97", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:584eb30027521a1c196d49c2423c791cf1fa74e217942b3b94a5491011dd42e0" }, "content_hash": "sha256:2340ce1ba2b864e718165d66c822fdbcc6243809776b5b307008df3b74ce358c" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-user-verifiedfollowers" } }, "/apis/v1/twitter/user_about": { "get": { "description": "Get the extended 'About this account' panel for an X user by @handle. Use this for provenance and trust checks — it surfaces signals the standard profile does not, such as the account's country, verification details, and username-change history. Returns a single profile object under `data`. For the standard profile (bio, follower counts, avatar), use `get_twitter_user_info` instead.\n\n\nPublished reference price: $0.00018 USD per successful request. Account-specific pricing and final settlement may differ.\n", "operationId": "get_twitter_user_about", "responses": { "200": { "description": "User profile information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseAd3D19335Ae4_UserProfileAboutResponse" } } } }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get User About Info", "tags": [ "group180" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "1", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.00018, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-revision": { "customer_pricing_ref": "4dd4f02a35fa", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "98824623b87b" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/twitter/user_about", "x-aisa-validation": "provider", "x-aisa-catalog-id": "twitter", "x-aisa-runtime-operation": { "operation_id": "get_twitter_user_about", "method": "ANY", "path": "/apis/v1/twitter/user_about" }, "parameters": [ { "name": "userName", "in": "query", "required": true, "schema": { "type": "string" }, "description": "The screen name of the user" } ], "x-aisa-source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:4890cc28515468508897c20c452517b4ac0c235bbc167cf90797ad9223d3701b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:57943a326c6b35fa15683ce948758ba7dc221c485bca893f7de1473cf6094478" }, "x-aisa-response-source": { "kind": "upstream_success_contract", "source": { "kind": "manual", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/twitter-user-batch_01.json", "fetched_at": "2026-09-29T21:25:55+08:00", "content_hash": "sha256:4890cc28515468508897c20c452517b4ac0c235bbc167cf90797ad9223d3701b", "converter": "scripts/import_existing_contracts.py@1", "path_space": "public", "owner": "AIsa-team/docs", "refresh_policy": "manual", "review_period_days": 30, "policy_revision": "sha256:57943a326c6b35fa15683ce948758ba7dc221c485bca893f7de1473cf6094478" }, "content_hash": "sha256:3ed4dbe9f337a7dfcc7ab3db07b29ee5f6cee6db1414a812f03454f251ee26e8" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/twitter/get_twitter-user-about" } } } }