Source Vitals
Source Attributes | Description |
|---|---|
Data Collection Method | real-time firehose |
Latency
sub-10 seconds
Geographic Coverage | global |
Key Use Cases | fashion & entertainment; millennial market research |
Delivery Methods | full stream |
Overview
Each message in the Tumblr stream pertains to one of 3 objects:
...
A post can be an original (“root”) post or a reblog. Each reblog includes metadata for both the immediate parent post that was reblogged, and the original root post whose content is being reblogged. Using the fields activity.post.parent_post.id and activity.post.root_post.id, you can trace the full “reblog chain” for a popular piece of content, to understand trends over time or clusters of influencers.
Data Dictionary
Tumblr field | Description | Data Type | Example value |
activity.action | The Tumblr action for a post. It can be "create","update" or "delete". | string | create |
activity.blog.is_group_blog | A flag indicating whether the post is from a group blog. | boolean | FALSE |
activity.blog.is_primary | A flag indicating whether the blog that the post or reblog was created from is the Tumblr user's primary blog. | boolean | TRUE |
activity.blog.language | The language of the blog, where provided by the Tumblr user. | string | en_US |
activity.blog.last_post | The 10-digit Unix timestamp for the most recent post from a blog. | int | 1602731493 |
activity.blog.name | The name of a Tumblr blog page. | string | procloudwatcher |
activity.blog.post_count | The total number of posts on a blog. | int | 493 |
activity.blog.timezone | The timezone of the Tumblr user, where available. | string | US/Eastern |
activity.blog.title | The title of a blog. | string | Daisies bloom at midnight |
activity.blog.updated | The 10-digit Unix timestamp for when the post was last updated. If the message indicates an update to a post, this time will be more recent than the "created" time. On a new post, the two timestamps will be the same. | 1602779382 | |
activity.blog.url | The URL of the blog from which the post or reblog was created. | string | |
activity.id | The alphanumeric ID of a Tumblr post or reblog. | string | 0005b1b82678781bf578fa46dbd0c7b5 |
activity.post.added_content | If a post is a | boolean | FALSE |
activity.post.blog.description | A free-text description of a blog. | string | I'm a man. I share things in this page that turn me on. |
activity.post.blog.id | The numeric ID of the blog of a Tumblr blog. | int | 367252542 |
activity.post.blog.is_group_blog | Indicates whether the blog is a group blog. | boolean | FALSE |
activity.post.blog.name | The name of a Tumblr user's blog. | string | astrahowl |
activity.post.blog.title | The title of a Tumblr blog. | string | DaBootyCall |
activity.post.blog.url | A URL pointing to a Tumblr blog. | string | |
activity.post.content.accepts_answers | Indicates whether the content accepts reply answers from other Tumblr users. | boolean | FALSE |
activity.post.content.additional.album | The name of the album from which a song is shared in a post. | string | Kiss Me, Kiss Me, Kiss Me |
activity.post.content.additional.album_art | A URL pointing to the image file for an album cover, provided on audio posts. | string | |
activity.post.content.additional.artist | The name of the artist of a song included in a post. | string | The Cure |
activity.post.content.additional.track_name | The audio file's title. For example, "Hey Jude" | string | R.O.A.S.T |
activity.post.content.answer | The text of an answer on Tumblr. Tumblr users can ask each other questions. Users have to opt in by enabling questions on their Settings page. | string | <p>everybody is different but ok I hear you </p> |
activity.post.content.asking.is_anonymous | A flag indicating whether the post contains a question from a Tumblr user which is being asked anonymously. | boolean | FALSE |
activity.post.content.asking.user_primary_blog_id | A numeric ID for the primary blog of the Tumblr user asking a question of another user. | int | 331789954 |
activity.post.content.audio_type | The platform from which an audio file is shared in a post. For example, "tumblr", "spotify" or "soundcloud | string | spotify |
activity.post.content.audio_url | The URL of external audio content shared on Tumblr. | string | |
activity.post.content.body | The full content for text or chat posts. | string | Everyone happy now? |
activity.post.content.caption | The caption for a photo or video. | string | japanese soda 13.10.2020 |
activity.post.content.description | The description for a link shared on Tumblr. It is optional and populated when the post type is "link". | string | <p>I just added this listing on Poshmark: Talbots black and silver tweed jacket.</p> |
activity.post.content.dialogue.label | A label indicating a participant in a dialogue in a Chat post. This is typically identical to the dialogue name. | string | Marinette |
activity.post.content.dialogue.name | The name or title of a participant in a dialogue in a Chat post. | string | Marinette |
activity.post.content.dialogue.phrase | A phrase in a dialogue in a Chat post. | string | OK fine, if you insist. |
activity.post.content.duration | The duration of a shared video, in seconds. | int | 12 |
activity.post.content.format | The format of a post, "html" or "markdown" | string | html |
activity.post.content.is_external | A flag indicating whether the source of the content shared in a post is external to Tumblr. | boolean | FALSE |
activity.post.content.link | The external URL for a photo. | string | |
activity.post.content.link_image | A URL pointing to a shared photo asset file. | string | |
activity.post.content.mentions.mentions | The numeric ID of a blog mentioned in a post. | string | 414995764 |
activity.post.content.note_count | Total number of all reblogs, likes, and replies that a post has received. | int | 201 |
activity.post.content.photos.alt_sizes.height | The height in pixels of an alternatively sized version of a photo shared on Tumblr. | int | 626 |
activity.post.content.photos.alt_sizes.url | A URL pointing to an alternatively sized version of a photo. | string | |
activity.post.content.photos.alt_sizes.width | The width in pixels of an alternatively sized version of a photo shared on Tumblr. | int | 640 |
activity.post.content.photos.caption | The text caption accompanying a photo. | string | INTO MY BELLY! |
activity.post.content.photos.exif.aperture | The aperture, or f-stop, of the camera used to take a photo, extracted from EXIF photo file metadata. | string | f/1,4 |
activity.post.content.photos.exif.camera | The name of the camera device used to take a photo, extracted from EXIF photo file metadata. | string | iPhone 6 |
activity.post.content.photos.exif.exposure | The exposure, or shutter speed, of the camera used to take a photo, extracted from EXIF photo file metadata. | string | 1/1250th |
activity.post.content.photos.exif.focal_length | The focal length in millimeters, taken from a photo's EXIF file metadata. | string | 76mm |
activity.post.content.photos.exif.iso | The ISO setting on the camera used to take a photo, extracted from EXIF photo file metadata. | string | 100 |
activity.post.content.photos.is_panorama | Indicates whether a photo included in a post is a panoramic-sized photo. | boolean | FALSE |
activity.post.content.photos.original_size.height | The height of the original-size version of a photo shared on Tumblr | int | 734 |
activity.post.content.photos.original_size.url | A URL pointing to the original-size version of a photo. | string | |
activity.post.content.photos.original_size.width | The width of the original-size version of a photo shared on Tumblr | int | 750 |
activity.post.content.plays | The number of times an audio post has been played. | int | 260 |
activity.post.content.question | The text of a question on Tumblr. Tumblr users can ask each other questions. Users have to opt in by enabling questions on their Settings page. | string | can you talk a bit about torpedo cruisers and how they were utilized? |
activity.post.content.slug | A slug the part of a URL that identifies a page using keywords. For example, mcdonalds-november-1974-student-body is the slug in this URL: https://vintageadvertising.tumblr.com/post/632059970941255681/mcdonalds-november-1974-student-body | string | mcdonalds-november-1974-student-body |
activity.post.content.source | A textual description of the source of content shared in a post. | string | Sage Francis |
activity.post.content.source_title | The title for the source of a piece of content. This is a Tumblr blog name. | string | beautieso-only |
activity.post.content.source_url | The URL for the source of a piece of content. | string | https://albertoposhmark.tumblr.com/post/632059974451937281/hm-black-shoulder-bag |
activity.post.content.tags.tags | The set of tags for a post. This array is populated with hashtags. | array(string) | tags:["FrankJhonson","spotify","R.O.A.S.T","Roast","AlBaro","rap"] |
activity.post.content.text | The text of a post which has chat or quote as its type. | string | Support your friend, even if you don't support their situation. |
activity.post.content.thumbnail.height | The height, in pixels, of the thumbnail-sized version of a shared photo. | int | 480 |
activity.post.content.thumbnail.url | A URL pointing to the thumbnail-sized version of a shared photo. | string | https://64.media.tumblr.com/tumblr_nxvljq72Ky1s79gmg_frame1.jpg |
activity.post.content.thumbnail.width | The width, in pixels, of the thumbnail-sized version of a shared photo. | int | 480 |
activity.post.content.title | The title for a post. This field is optional when creating a Tumblr post. | string | Angel food cake |
activity.post.content.video_type | Indicates which platform a video is being shared from. Example values: "tumblr", "instagram", "flickr" and "youtube" | string | tumblr |
activity.post.content.video_url | The URL for a video being shared. | string | |
activity.post.created | The 10-digit Unix timestamp showing when a Tumblr message was created. | int | |
activity.post.id | The numeric post ID of a Tumblr post. | int | 632059971196108800 |
activity.post.is_submission | Indicates whether the post is a submission. Posts can be submitted by other users to a blog if enabled by the blog owner | boolean | FALSE |
activity.post.parent_post.blog.id | The numeric ID of the immediate parent blog that shared the root post, or original post, shown on a reblog. | int | 487118791 |
activity.post.parent_post.blog.name | The name of the blog from which a post has been reblogged. | string | azn-honeys |
activity.post.parent_post.id | The numeric post ID of a reblogged Tumblr post. | int | 631338166517891072 |
activity.post.parent_post.short_url | A shortened URL pointing to the immediate parent post in a chain of reblogs. | string | |
activity.post.publish_time | The 10-digit Unix timestamp showing when a Tumblr message was published. | int | 1602779360 |
activity.post.root_post.blog.id | The numeric ID of the blog that shared the root post, or original post, shown on a reblog. | int | 437291003 |
activity.post.root_post.blog.name | The name of the "root blog" or original blog from which a post has been shared in a chain of reblogs. | string | beautieso-only |
activity.post.root_post.id | The ID of the root post in a chain of reblogs. | string | 160670833368 |
activity.post.root_post.short_url | A shortened URL pointing to the "root" or original post being reblogged. | string | |
activity.post.short_url | A shortened URL pointing to a Tumblr post. | string | |
activity.post.type | The type of a post. A post can be one of eight different types. Seven of these types can be directly created by the user: text, | string | photo |
activity.post.updated | The 10-digit Unix timestamp showing when a Tumblr message was updated. | int | 1602779360 |
activity.user_primary_blog_id | The numeric ID of the primary blog associated with a Tumblr user. | int | 367252542 |
activity_privacy | Set to "public" if the post is publicly viewable, "private" if it has been made private. | string | public |
activity_privacy_change | Indicates whether the current message includes a change to the privacy status of a post in the activity_privacy field. | boolean | FALSE |
activity_type | The type of Tumblr activity for a post. Can be "post","like","delete" or "blog". | string | post |
id | An alphanumeric ID for a Tumblr message. | string | 0005b1b82676f5d2371d03529f236e55 |
timestamp | The 10-digit Unix timestamp showing when a Tumblr message was made available in the data stream. | int | 1602779360 |
version | The current version of the Tumblr data product. | string | 2.13 |
Example Messages
New Blog
A message indicating a new blog has been created.
...