scannorDocs

viral

Posts spreading across all of X right now, ranked by likes in a 1h, 6h or 24h window.

Use it to find stories, then call launched on each story to see which tokens are already on it.

Price: $0.01.

Inputs

InputWhat it takesDefault
windowHow far back to look: 1h, 6h or 24h.24h
min_likesOnly posts with at least this many likes: 100 to 1,000,000.Set for the window
mediaOnly posts with a picture or video. Memes are pictures and videos: true or false.Off
langLanguage of the posts: language code.en
cursorThe next page, from the last answer: text.Optional

What comes back

  • posts: text, author, likes, views and the link of each post
  • tokens_linking: how many tokens scannor already knows that link the post. Above 0 means the story is launched.
  • _billing: what the call cost and what is left, in dollars

Freshness

Answers are shared for up to 3 minutes: the same question in that time gets the same read, and cached_s says how old it is, in seconds.

When there is nothing to show

Nothing on X passed 3000 likes in the last 6h. Lower min_likes.

This is a real answer and costs the call's price. Failures are refunded: see Pricing.

On this page