BLADE - Twitter

Tweet URL Generator

Use the Tweet URL Generator to assemble the direct query URL for Twitter content.

  1. Specify URL parameters, as defined in the following table.

  2. Click Generate to produce the query string in the specified format based on the parameters you set.

  3. Click Test to generate data in the specified format in a new browser tab based on the parameters you set. Use the Test function to ensure that the topic or playlist returns appropriate results and to view the format of the output.

  4. Copy and paste the Query String generated in your platforms as needed.   

URL Parameter


URL Parameter



Select the data format. Select from: XML, JSON, or RSS.

Topic or Playlist

Select a topic or playlist.


Specify the maximum number of Tweets returned in results. Overrides the Broadcast Count and Play Count values set in Flow for the topic or playlist.

Note: When left blank, the Broadcast Count or Play Count value set in Flow for the topic or playlist is applied.

Max Plays

Specify the maximum number of times that a Tweet can be output. For example, if you set Max Plays to 3, then only Tweets played less than 3 times (0, 1, or 2) are returned for future output.

Note: You must also enable the Mark Played option for this to be effective. If the Tweet’s individual play counts are not being set then the Max Plays option cannot be effective.

Mark Played

Specify whether Tweets will be marked as played.

  • When selected, the play count is incremented for all Tweets in the results, which affects the Max Plays value above.

  • When cleared, play count is not incremented, which does not affect the Max Plays value above.

This option can be useful when testing before broadcast. While testing, clear this option to prevent Tweets from being marked as played. When you are ready for broadcast, select this option if you are using the Max Plays option to count and control the number of times a single Tweet is retrieved for play out.

Image Count

Specify the number of images that you want output generated for.

When set - this will cause the output to generate that number of image tags regardless of the number of images in each tweet.

If set to 1 then all tweets will have 1 set of image tags even if an individual tweet has no image. In that case the tags values will be empty.

Avatars Base64

Specify whether avatar images are included in the BLADE output as a Base64 string (when they are available with the Tweets).

  • When selected, avatars are included in the output as a base64 encoded string.

  • When cleared, avatars are not included in the output.

Note: The results always include the available avatar image URLs regardless of this setting. Only enable this option if your platform can convert a Base64 string to an image and cannot effectively use the URL to access the image.