Tiles API Reference

Unique identifier for the Tile, in the Stack. This is an object containing a “$id” property, which will expose the ID as a 24-byte string.

Example Values:
550f9f0e29115c0000bf82cb

post: Required

Message body, normalised from the content source. Will be the Tweet text, Facebook status, Instagram caption, etc. Maximum 32k characters.

Example Values:
Wow, this is such an old photo! #tbt

Tile title to accompany the message, often used for video tiles.

Example Values:
Dog on a surfboard

HTML body, up to 32k characters. This field is mandatory for “html” media type.

Example Values:
Dog on a surfboard

The media type of the post.

Example Values:
text, image

Full-sized image URL.

Example Values:
https://stackla.com/images/buddy_the_dog.jpg

Small image URL (ideally under to 300x300px, or 600x600px for retina).

Example Values:
https://stackla.com/images/buddy_the_dog-600x600.jpg

Medium image URL (ideally under to 600x600px, or 1200x1200px for retina).

Example Values:
https://stackla.com/images/buddy_the_dog-1200x1200.jpg

Array of Tag IDs associated with the Tile. Note: May be returned as array of Integers or Strings.

Example Values:
["14001","14562"]

Accompanying text to be used when tile is shared on a Social network (e.g. Twitter, Instagram, Facebook, etc.).

Example Values:
Come and see Jimmy's post on the stack!

URL of the video file. Required when media type is “video”).

Example Values:
https://stackla.com/images/dog_on_a_surfboard.mp4

Tile width ratio to be used as a ratio vs width_ratio as width to height. Positive numeric value. Required when media type is “html”.

Example Values:
3

Tile width ratio to be used as a ratio vs height_ratio as width to height. Positive numeric value. Required when media type is “html”.

Example Values:
4

Tile moderation status.

Example Values:
published

URL to be used as the post author’s avatar.

Example Values:
https://stackla.com/images/mascots/buddy.jpg

Display name to be used for the author.

Example Values:
Fred Flintstone

Globally unique ID to be used for this post (often referencing external ID). Tiles that have
this value set can also be retrived using the guid: operator (see
_id). For more info see the POST tiles
guid reference.

Example Values:
2019

Tiles that originate from networks that allow anonymous posts (including Stackla) will have this field set to true. Renderers should not show any attributions the creator of this Tile.

Example Values:
false

GPS longitude co-ordinate for geo-location

Example Values:
144.953151388

GPS latitude co-ordinate for geo-location

Example Values:
-37.816644361

The source of the post, often a social network. This field is also referred to as “network” in the filter context

Example Values:
twitter

ID of the Tile, or its Globally Unique ID (GUID, prefixed with “guid:”).

Example Values:
550f9f0e29115c0000bf82cb, guid:12345

ID of the Stackla Post Feed term that this content will be ingested by.

Example Values:
9999

ID of the Tile, or its Globally Unique ID (GUID, prefixed with “guid:”).

Example Values:
550f9f0e29115c0000bf82cb, guid:12345