> ## Documentation Index > Fetch the complete documentation index at: https://docs.nephia.cc/llms.txt > Use this file to discover all available pages before exploring further. # Lookup tweets by IDs (POST) > Same billing as GET. Costs 2+ credits depending on results. ## OpenAPI ````yaml /openapi.json post /v1/x/tweets/lookup openapi: 3.1.0 info: title: Nephia API description: >- B2B API for structured data from live Sources (Vinted, X, Reddit). Authenticate with an API key on your Account. Pull endpoints charge credits per request. Watches poll on an interval and deliver webhook events. Product request quota is per Account (all API keys share one bucket), by Plan: Free 60/min, Starter 350/min, Growth 700/min, Pro 1,200/min. Credit packs do not raise the quota. version: 1.0.0 servers: - url: https://api.nephia.cc description: Production - url: http://localhost:3000 description: Local security: - ApiKeyAuth: [] tags: - name: Account description: Account balance - name: Vinted — Search description: Vinted catalog search - name: Vinted — Items description: Vinted listing detail - name: Vinted — Users description: Vinted sellers and wardrobes - name: Vinted — Reference description: Vinted filter metadata - name: Vinted — Watches description: Vinted watches, events, and activity - name: X — Tweets description: Tweet lookup, replies, thread, quotes, and engagers - name: X — Users description: X profiles, timelines, and social graphs - name: X — Search description: Tweet search - name: X — Lists description: X list timelines - name: X — Trends description: Trend places and snapshots - name: X — Watches description: X watches, events, and activity - name: Reddit — Search description: Reddit post, subreddit, and user search - name: Reddit — Posts description: Reddit posts, comments, duplicates, and trending - name: Reddit — Subreddits description: Subreddit profiles, listings, and rules - name: Reddit — Users description: Reddit user profiles and activity - name: Reddit — Watches description: Reddit watches, events, and activity paths: /v1/x/tweets/lookup: post: tags: - X — Tweets summary: Lookup tweets by IDs (POST) description: Same billing as GET. Costs 2+ credits depending on results. operationId: postV1XTweetsLookup requestBody: required: true content: application/json: schema: type: object properties: ids: type: array items: type: string minItems: 1 maxItems: 100 required: - ids responses: '200': description: Partial or full tweet lookup result content: application/json: schema: type: object properties: meta: type: object properties: requested: type: number found: type: number credits_used: type: number required: - requested - found - credits_used data: type: array items: $ref: '#/components/schemas/XTweet' errors: type: array items: type: object properties: id: type: string code: type: string enum: - TWEET_NOT_FOUND - TWEET_PROTECTED - USER_SUSPENDED required: - id - code required: - meta - data - errors '400': description: Invalid request content: application/json: schema: type: object properties: error: type: string code: type: string required: - error '402': description: Insufficient credits content: application/json: schema: type: object properties: error: type: string code: type: string required: - error '429': description: >- Request quota exceeded. Retry after the `Retry-After` header (seconds). Response includes `RateLimit-*` headers (IETF draft-7). content: application/json: schema: type: object properties: error: type: string code: type: string required: - error example: error: Rate limit exceeded code: TOO_MANY_REQUESTS '503': description: Upstream temporarily unavailable content: application/json: schema: type: object properties: error: type: string code: type: string required: - error components: schemas: XTweet: type: object properties: id: type: string text: type: string createdAt: type: string lang: type: - string - 'null' url: type: string author: type: object properties: id: type: string username: type: string displayName: type: string profileImageUrl: type: - string - 'null' verified: type: boolean isBlueVerified: type: boolean required: - id - username - displayName - profileImageUrl - verified - isBlueVerified metrics: type: object properties: likes: type: number replies: type: number retweets: type: number quotes: type: number views: type: - number - 'null' bookmarks: type: - number - 'null' required: - likes - replies - retweets - quotes - views - bookmarks media: type: array items: type: object properties: type: type: string enum: - photo - video - animated_gif url: type: string previewUrl: type: - string - 'null' width: type: - number - 'null' height: type: - number - 'null' durationMs: type: - number - 'null' variants: type: array items: type: object properties: url: type: string contentType: type: - string - 'null' bitrate: type: - number - 'null' required: - url - contentType - bitrate required: - type - url - previewUrl - width - height - durationMs - variants entities: type: object properties: urls: type: array items: type: object properties: url: type: string expandedUrl: type: - string - 'null' displayUrl: type: - string - 'null' required: - url - expandedUrl - displayUrl mentions: type: array items: type: object properties: id: type: - string - 'null' username: type: string name: type: - string - 'null' required: - id - username - name hashtags: type: array items: type: object properties: text: type: string required: - text cashtags: type: array items: type: object properties: text: type: string required: - text required: - urls - mentions - hashtags - cashtags quotedTweet: oneOf: - $ref: '#/components/schemas/XTweet' - type: 'null' retweetedTweet: oneOf: - $ref: '#/components/schemas/XTweet' - type: 'null' inReplyToTweetId: type: - string - 'null' inReplyToUserId: type: - string - 'null' inReplyToUsername: type: - string - 'null' conversationId: type: - string - 'null' displayTextRange: type: - array - 'null' maxItems: 2 minItems: 2 prefixItems: - type: number - type: number source: type: - string - 'null' possiblySensitive: type: boolean poll: type: - object - 'null' properties: choices: type: array items: type: object properties: label: type: string votes: type: - number - 'null' required: - label - votes endAt: type: - string - 'null' countsAreFinal: type: - boolean - 'null' required: - choices - endAt - countsAreFinal card: type: - object - 'null' properties: type: type: - string - 'null' url: type: - string - 'null' title: type: - string - 'null' description: type: - string - 'null' imageUrl: type: - string - 'null' required: - type - url - title - description - imageUrl communityNote: type: - object - 'null' properties: text: type: - string - 'null' title: type: - string - 'null' required: - text - title editControl: type: - object - 'null' properties: editTweetIds: type: array items: type: string editableUntilMs: type: - number - 'null' editsRemaining: type: - number - 'null' isEditEligible: type: - boolean - 'null' required: - editTweetIds - editableUntilMs - editsRemaining - isEditEligible required: - id - text - createdAt - lang - url - author - metrics - media - entities - quotedTweet - retweetedTweet - inReplyToTweetId - inReplyToUserId - inReplyToUsername - conversationId - displayTextRange - source - possiblySensitive - poll - card - communityNote - editControl securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key created from the Nephia dashboard for your Account. ````