Tumblr

Source Vitals

Source Attributes	Description

Source Attributes	Description
Data Collection Method	real-time firehose
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 blog, i.e. a destination like https://burberry.tumblr.com
A post, a piece of content which may be of several types: text, photo, quote, audio, video, chat, link and answer. Each content type has different metadata, described in the data dictionary below.
A like; each “like” click in Tumblr is represented as its own message.

Each message can also have one of 3 action types:

“create” which indicates the message contains a new blog, post or like
“update” which is an edit to the object, which must be persisted in your data store.
“delete” which indicates the content has been deleted, and must be removed from your data store.

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	https://burberry.tumblr.com/
activity.id	The alphanumeric ID of a Tumblr post or reblog.	string	0005b1b82678781bf578fa46dbd0c7b5
activity.post.added_content	If a post is a reblog, the poster may or may not add additional content. If they did not then the added_content boolean will be set to false.	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	https://burberry.tumblr.com/
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	https://64.media.tumblr.com/fabcd36fdf6479f34a3276c8f2e4f78b/c38bd75330f55627-a1/s2048x3072/19e8386d8d0f3810341313aea68572373b7d3b5b.jpg
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	https://a.tumblr.com/tumblr_ne37skVPLG1ri5l6no1.mp3
activity.post.content.body	The full content for text or chat posts.	string	Everyone happy now? Or probably sad, right? Yeah
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	https://vintagelasvegas.com/post/632057166426193920
activity.post.content.link_image	A URL pointing to a shared photo asset file.	string	https://64.media.tumblr.com/4d78c998187bb073ec34e7e235b7686c/9bd1988ada03df87-26/s512x512u_c1/995bc99416f3d9f1b7dc4ec09db0ce3bf670528c.jpg
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	https://64.media.tumblr.com/4d78c998187bb073ec34e7e235b7686c/9bd1988ada03df87-26/s512x512u_c1/995bc99416f3d9f1b7dc4ec09db0ce3bf670528c.jpg
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	https://64.media.tumblr.com/4d78c998187bb073ec34e7e235b7686c/9bd1988ada03df87-26/s512x512u_c1/995bc99416f3d9f1b7dc4ec09db0ce3bf670528c.jpg
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	https://va.media.tumblr.com/tumblr_qi5r8erXlu1w9tts1.mp4
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 (is_submission=true). A submission post will have the submitter as the owner of the post.	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	https://tmblr.co/ZbNlsUZ5XpAjyq01
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	https://tmblr.co/ZbNlsUZ5XpAjyq01
activity.post.short_url	A shortened URL pointing to a Tumblr post.	string	https://tmblr.co/ZbNlsUZ5XpAjyq01
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, photo, quote, audio, video, chat and link. An answer post is a response to an ask from another user.	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.

{
  "version": "2.13",
  "activity_privacy_change": false,
  "id": "0005b1b82792e3634482fb8702dbc416",
  "timestamp": 1602779379,
  "activity_type": "blog",
  "activity_privacy": "public",
  "activity": {
    "action": "create",
    "id": 509081620,
    "blog": {
      "is_primary": true,
      "created": 1602779379,
      "updated": 1602779379,
      "name": "chocolatepsychiccookiesalad",
      "url": "https://chocolatepsychiccookiesalad.tumblr.com/",
      "title": "İsimsiz",
      "description": "",
      "is_group_blog": false,
      "timezone": "Europe/Istanbul",
      "post_count": 0,
      "last_post": 0,
      "language": "en_US"
    }
  }
}

New Post

A new post on Tumblr:

{
  "version": "2.13",
  "activity_privacy_change": false,
  "id": "0005b1b8269c32f44482fb87ab126fb4",
  "timestamp": 1602779363,
  "activity_type": "post",
  "activity_privacy": "public",
  "activity": {
    "action": "create",
    "user_primary_blog_id": 468573502,
    "post": {
      "id": 632059973743050752,
      "short_url": "https://tmblr.co/Z_FUgWZ5XpA3ie00",
      "blog": {
        "id": 468573502,
        "name": "krisajs11619",
        "url": "https://krisajs11619.tumblr.com/",
        "title": "Untitled",
        "description": "",
        "is_group_blog": false
      },
      "created": 1602779363,
      "updated": 1602779363,
      "publish_time": 1602779363,
      "is_submission": false,
      "added_content": false,
      "type": "link",
      "content": {
        "note_count": 0,
        "slug": "lia-sophia-wildflower-ring-statement-costume",
        "format": "html",
        "tags": [],
        "mentions": [],
        "title": "Lia Sophia Wildflower Ring Statement Costume",
        "link": "https://poshmark.com/listing/5eb430e32ca9ab9b3614b4ec?utm_campaign=referral_code%3DKARCHERISTIN&utm_source=tm_sh&utm_content=feature%3Dsh_li_el_ios%26rfuid%3Dext1%3A736d3996-e90f-442a-b6cf-191b97ac2aee%26ext_trk%3Dbranch",
        "link_image": "https://64.media.tumblr.com/e323a9a9647b6e1290690896dc64b42e/e7fb73b594183ff4-8d/s512x512u_c1/fb9cfe06de970e6deb658afec25f31093549ef94.jpg",
        "description": "<p>I just added this listing on Poshmark: Lia Sophia Wildflower Ring Statement Costume.</p>"
      }
    }
  }
}

New Like

A message indicating a post has been liked:

{
  "version": "2.13",
  "activity_privacy_change": false,
  "id": "0005b1b827a88b3da953204e302a9367",
  "timestamp": 1602779381,
  "activity_type": "like",
  "activity_privacy": "public",
  "activity": {
    "action": "create",
    "user_primary_blog_id": 131093926,
    "post": {
      "id": 632058224830464000,
      "short_url": "https://tmblr.co/Z_17rfZ5XPjGOa00",
      "blog": {
        "id": 314790078,
        "name": "cinnaminsvga"
      },
      "root_post": {
        "id": 632058224830464000,
        "short_url": "https://tmblr.co/Z_17rfZ5XPjGOa00",
        "blog": {
          "id": 314790078,
          "name": "cinnaminsvga"
        }
      }
    },
    "created": 1602779380
  }
}

Blog Update

A change to a blog profile.

{
  "version": "2.13",
  "activity_privacy_change": false,
  "id": "0005b1b8276c7d3ec7c58c2f4e4a1858",
  "timestamp": 1602779377,
  "activity_type": "blog",
  "activity_privacy": "public",
  "activity": {
    "action": "update",
    "id": 438881131,
    "blog": {
      "is_primary": true,
      "created": 1538568571,
      "updated": 1602779377,
      "name": "finneline",
      "url": "https://finneline.tumblr.com/",
      "title": "",
      "description": "",
      "is_group_blog": false,
      "timezone": "US/Eastern",
      "post_count": 496,
      "last_post": 1601611342,
      "language": "en_US"
    }
  }
}

Post Update

An update or edit to a Tumblr post:

{
  "version": "2.13",
  "activity_privacy_change": false,
  "id": "0005b1b827a30293055c863303698dd3",
  "timestamp": 1602779380,
  "activity_type": "post",
  "activity_privacy": "public",
  "activity": {
    "action": "update",
    "user_primary_blog_id": 488084731,
    "post": {
      "id": 631613047320018944,
      "short_url": "https://tmblr.co/Z1n2WVZ3yBXP0m00",
      "blog": {
        "id": 488084731,
        "name": "nananaxs",
        "url": "https://nananaxs.tumblr.com/",
        "title": "nananaxs",
        "description": ".𝐃𝐄𝐎𝐁𝐈 𝐀𝐍𝐃 𝐆𝐄?? | portfólio | Spirit fanfics | Ela/dela | Bella, moon or nana¡",
        "is_group_blog": false
      },
      "created": 1602353141,
      "updated": 1602779380,
      "publish_time": 1602353141,
      "is_submission": false,
      "added_content": false,
      "type": "photo",
      "content": {
        "note_count": 29,
        "slug": "cabelos-azul-menta-cor-do-seu-rabisco-capinea",
        "format": "html",
        "tags": [
          "capa para social spirit",
          "capa para fanfic",
          "capa clean",
          "capa de spirit",
          "capa simples",
          "spirit fanfics",
          "capa para doa??o",
          "capa texturizada",
          "txt yeonjun",
          "txt soobin",
          "txt yeonbin",
          "run away"
        ],
        "mentions": [],
        "caption": "Cabelos azul menta, cor do seu rabisco | Capinea para doação¡  (doada)",
        "photos": [
          {
            "is_panorama": false,
            "caption": "",
            "exif": {},
            "original_size": {
              "width": 600,
              "height": 400,
              "url": "https://64.media.tumblr.com/4106d556fe693d3594866e0c610d7c26/b2c042c797b531ae-49/s2048x3072/ce7ff01613dbdf68b4dfa7262b2b70bae682a8ae.png"
            }
          }
        ]
      }
    }
  }
}

Post Deletion

{
  "version": "2.13",
  "activity_privacy_change": false,
  "id": "0005b1b826f5660f3078381e0452fa98",
  "timestamp": 1602779369,
  "activity_type": "post",
  "activity_privacy": "public",
  "activity": {
    "action": "delete",
    "user_primary_blog_id": 150806910,
    "post": {
      "id": 178508236121,
      "short_url": "https://tmblr.co/Z__fcp2cFwuLP",
      "blog": {
        "id": 150806910,
        "name": "catana234",
        "url": "https://catana234.tumblr.com/",
        "title": "Just random stuff",
        "description": "",
        "is_group_blog": false
      },
      "created": 1538046113,
      "updated": 1570121498,
      "publish_time": 1538046113,
      "is_submission": false,
      "added_content": true,
      "parent_post": {
        "id": 177268219598,
        "short_url": "https://tmblr.co/Z8dTEd2b60bxE",
        "blog": {
          "id": 358475636,
          "name": "shesocurious"
        }
      },
      "root_post": {
        "id": 177083877539,
        "short_url": "https://tmblr.co/Z3T30a2ax1OYZ",
        "blog": {
          "id": 412584441,
          "name": "facethruster"
        }
      },
      "type": "photo"
    }
  }
}

Tumblr

Related content