Twitter (live)

Search tweets (live)

Search tweets on demand. Fetches directly from the platform and returns one page with a cursor. Not available for trial access keys.

get/api/data/twitter/posts/live

Request

  • Base URL: https://api.xpoz.ai
  • URL: https://api.xpoz.ai/api/data/twitter/posts/live
  • Auth: HTTP bearer

Query parameters

qstring required

Search query (Lucene-style keyword syntax). Must not be blank.

sincestring date

Start date (inclusive), YYYY-MM-DD.

untilstring date

End date (inclusive), YYYY-MM-DD.

langstring

BCP-47 language code filter.

countryCodestring

ISO country code filter.

sortBy'relevance' | 'latest'

Sort order.

fieldsstring[]

Tweet fields to return. Comma-separated. Allowed values: id, authorId, authorUsername, text, bookmarkCount, impressionCount, likeCount, lang, possiblySensitive, deleted, suspended, quoteCount, replyCount, retweetCount, isRetweet, hasBirdwatchNotes, birdwatchNotesId, birdwatchNotesText, birdwatchNotesUrl, status, conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername, originalTweetId, editedTweets, hashtags, mentions, mediaUrls, urls, grokGeneratedContent, source, placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid, createdAt, createdAtDate.

cursorstring

Opaque cursor from next_page_cursor of the previous page.

Response

One page of results.

resultsobject[] required
countinteger required
dataSource'database' | 'api' | 'hybrid' required

Where the results came from.

has_moreboolean required
next_page_cursorstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.