Look up a tweet
Resolve a single tweet by ID or URL into its text, author and public metrics.
Use this to render a post you are referencing, e.g. the tweet quoted by a quote-style post.
Unlike /v1/twitter/search this is not limited to the last 7 days and works for any tweet
visible to the connected account.
Billed as an X posts read ($0.005). Repeat lookups of the same tweet within the same UTC day are charged once.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
The social account ID whose X token is used for the lookup
Numeric tweet ID or a tweet URL (e.g. https://x.com/user/status/123...)
Response Body
application/json
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.twitterengagement.getTweet({ query: { accountId: 'account_abc123', id: 'abc123', },});console.log(data);{
"status": "success",
"tweet": {
"id": "string",
"text": "string",
"created": "2019-08-24T14:15:22Z",
"conversationId": "string",
"inReplyToTweetId": "string",
"lang": "string",
"author": {
"id": "string",
"username": "string",
"displayName": "string",
"avatar": "string",
"verifiedType": "string"
},
"likeCount": 0,
"replyCount": 0,
"retweetCount": 0,
"quoteCount": 0,
"platform": "twitter"
}
}{
"error": "string",
"type": "invalid_request_error",
"code": "string",
"param": "string",
"platform": "string",
"platformError": {},
"details": {}
}{
"error": "Unauthorized"
}Search recent tweets GET
Search public tweets from the last 7 days matching an X search query, e.g. to discover tweets to reply to. The query string is passed through to X unchanged and supports X's search operators (`from:user`, `-is:retweet`, `is:reply`, `lang:en`, `"exact phrase"`, `conversation_id:123`, boolean `OR`, ...). Note that standalone operators like `is:` / `has:` / `lang:` must be combined with a keyword or `from:` clause. To reply to a found tweet, pass its `id` as the twitter platform entry's `platformSpecificData.replyToTweetId` when creating a post. Rate limit: 300 requests per 15-min window per connected account.
Bookmark a tweet POST
Bookmark a tweet by ID. Requires the bookmark.write OAuth scope. Rate limit: 50 requests per 15-min window.