Pick the posts to analyze
SendtweetIds, texts, a page, or a search, never more than 1. Sending none,
or more than 1, returns 400 invalid_input.A page reads 1 post’s thread or 1 account’s tab.
sinceTime, untilTime & queryType narrow a search only. Sending them with
a page returns 400 invalid_input.
A search combines every search field you send into 1 X (Twitter) search. The
entries of 1 kind join as alternatives. username & usernames together read as (from:NASA OR from:ESA). Each kind narrows the others. X (Twitter) searches
up to 512 characters.queryType sets the order, Latest or Top. For more posts than 1 call
returns, send the same search again. In that search, set cursor to
next_cursor. Stop when has_next_page is false.Compare with an earlier answer
Send theresults of an earlier call as baseline to see what changed. Each
row in the new results gets monitor. analysisSummary.monitor counts the
posts per status. The comparison costs nothing extra.id, or tweet.id, and its answers. Send
whole result rows when you have them. Their monitor carries the settings’
fingerprint, so rows from other settings show as not_comparable.A decision counts as changed only when its answer clearly leaves the old one. So
near ties between calls stay
unchanged. Keep analysis the same between calls
for comparable answers.Budget the analysis
Each analyzed post costs 2 credits. Each text intexts costs the same. Posts
in unanalyzed cost nothing.
When credits cover fewer posts than you asked for, fewer come back. The posts
left over appear in unanalyzed with insufficient_credits. If credits cover
no post, the call returns 402 insufficient_credits.
A call can run out of time before it reaches every post. The posts or texts
left over come back in
unprocessed_ids, and they cost nothing. Send those post
IDs again in tweetIds, and those texts again in texts. For texts, text:3
names the third text you sent. A search or page also returns next_cursor for
the posts after them.