Tumblr MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Tumblr: 33 typed functions through one MCP server. No Tumblr API key needed.

Functions
33
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Tumblr

An MCP server for Tumblr alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/tumblr
Every site

One MCP server for Tumblr and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 20
  • findBlogFind a blog by name.

    Arguments

    NameTypeRequired
    args{ name: string }Yes

    Returns TumblrBlogSummary

    interface TumblrBlogSummary {
      /** The blog's own identifier, what every other tumblr.com function takes
       * as a blog argument. */
      name: string;
      title: string;
      url: string;
      totalPosts: number;
      description: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/findBlog

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.findBlog({ name: "staff" });
  • findTagFind posts by searching a tag.

    Arguments

    NameTypeRequired
    tagstring
    The tag, with or without a leading #.
    Yes
    limitnumber
    1-20, default 20.
    No
    beforenumber | string
    A previous page's nextCursor (a unix timestamp, as a number or a string).
    No

    Returns TumblrSearchPage

    interface TumblrPost {
      /** The post id as a string, what getPost takes. */
      id: string;
      blogName: string;
      url: string;
      shortUrl: string;
      /** ISO timestamp the post was published. */
      publishedAt: string | null;
      tags: string[];
      summary: string;
      /** Every text block, in order, joined by newlines. */
      text: string;
      /** The largest rendition of every image block, in order. */
      images: string[];
      /** Urls of link, video and audio blocks, in order. */
      links: string[];
      noteCount: number;
      likeCount: number;
      reblogCount: number;
      isNsfw: boolean;
      /** The blog this was reblogged from, or null for an original post. */
      rebloggedFrom: string | null;
      reblogKey: string;
    }
    
    interface TumblrSearchPage {
      posts: TumblrPost[];
      /** Pass back as cursor for the next page; null on the last page. */
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/findTag

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.findTag({ tag: "cats", limit: 3 });
  • getBlogInfoGet metadata for a blog: name, title, url, post count, description, last-post time, NSFW/adult flags, ask and subscribe settings, and avatar.

    Arguments

    NameTypeRequired
    args{ name: string }Yes

    Returns TumblrBlogInfo

    interface TumblrBlogInfo {
      name: string;
      title: string;
      url: string;
      totalPosts: number;
      description: string;
      /** ISO timestamp of the blog's last post, or null when the site did not send one. */
      updatedAt: string | null;
      isNsfw: boolean;
      isAdult: boolean;
      asksEnabled: boolean;
      asksAllowAnon: boolean;
      canSubscribe: boolean;
      /** The largest avatar image the site published, or "" when none came back. */
      avatarUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/getBlogInfo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.getBlogInfo({ name: "staff" });
  • getBlogPostsList posts from a blog, newest first.

    Arguments

    NameTypeRequired
    namestring
    A blog name or url, as findBlog takes.
    Yes
    limitnumber
    1-20, default 20.
    No
    cursorstring
    A previous page's nextCursor.
    No

    Returns TumblrPostPage

    interface TumblrPost {
      /** The post id as a string, what getPost takes. */
      id: string;
      blogName: string;
      url: string;
      shortUrl: string;
      /** ISO timestamp the post was published. */
      publishedAt: string | null;
      tags: string[];
      summary: string;
      /** Every text block, in order, joined by newlines. */
      text: string;
      /** The largest rendition of every image block, in order. */
      images: string[];
      /** Urls of link, video and audio blocks, in order. */
      links: string[];
      noteCount: number;
      likeCount: number;
      reblogCount: number;
      isNsfw: boolean;
      /** The blog this was reblogged from, or null for an original post. */
      rebloggedFrom: string | null;
      reblogKey: string;
    }
    
    interface TumblrPostPage {
      posts: TumblrPost[];
      totalPosts: number;
      /** Pass back as cursor for the next page; null on the last page. */
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/getBlogPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.getBlogPosts({ name: "staff", limit: 2 });
  • getDashboardThe signed-in caller's dashboard feed.

    Arguments

    NameTypeRequired
    limitnumberNo
    cursorstring
    NextCursor off the previous page.
    No

    Returns TumblrFeedPage

    interface TumblrPost {
      /** The post id as a string, what getPost takes. */
      id: string;
      blogName: string;
      url: string;
      shortUrl: string;
      /** ISO timestamp the post was published. */
      publishedAt: string | null;
      tags: string[];
      summary: string;
      /** Every text block, in order, joined by newlines. */
      text: string;
      /** The largest rendition of every image block, in order. */
      images: string[];
      /** Urls of link, video and audio blocks, in order. */
      links: string[];
      noteCount: number;
      likeCount: number;
      reblogCount: number;
      isNsfw: boolean;
      /** The blog this was reblogged from, or null for an original post. */
      rebloggedFrom: string | null;
      reblogKey: string;
    }
    
    interface TumblrFeedPage {
      posts: TumblrPost[];
      /** Pass back as cursor for the next page; null on the last. */
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/getDashboard

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.getDashboard({ limit: 2 });
  • getPostGet a single post by ID with its content and metadata.

    Arguments

    NameTypeRequired
    namestring
    The blog name, with id; or omit both and pass url.
    No
    idstringNo
    urlstring
    A post url, e.g. https://staff.tumblr.com/post/822057428507049984.
    No

    Returns TumblrPost

    interface TumblrPost {
      /** The post id as a string, what getPost takes. */
      id: string;
      blogName: string;
      url: string;
      shortUrl: string;
      /** ISO timestamp the post was published. */
      publishedAt: string | null;
      tags: string[];
      summary: string;
      /** Every text block, in order, joined by newlines. */
      text: string;
      /** The largest rendition of every image block, in order. */
      images: string[];
      /** Urls of link, video and audio blocks, in order. */
      links: string[];
      noteCount: number;
      likeCount: number;
      reblogCount: number;
      isNsfw: boolean;
      /** The blog this was reblogged from, or null for an original post. */
      rebloggedFrom: string | null;
      reblogKey: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/getPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.getPost({});
  • getPostNotesGet notes (likes and reblogs) on a post with the blog names that interacted with it.

    Arguments

    NameTypeRequired
    namestring
    The blog name, with id; or omit both and pass url.
    No
    idstringNo
    urlstring
    A post url, e.g. https://staff.tumblr.com/post/822057428507049984.
    No
    cursorstring
    A previous page's nextCursor.
    No

    Returns TumblrNotesPage

    interface TumblrPostNote {
      type: string;
      blogName: string;
      blogUrl: string;
      /** ISO timestamp of the interaction. */
      timestamp: string | null;
      /** The reply's own text, present only when type is "reply". */
      replyText: string | null;
      /** The blog this reblog is from, present only when type is "reblog". */
      reblogParentBlogName: string | null;
    }
    
    interface TumblrNotesPage {
      notes: TumblrPostNote[];
      totalNotes: number;
      totalLikes: number;
      totalReblogs: number;
      totalReplies: number;
      /** Pass back as cursor for the next page; null on the last page. */
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/getPostNotes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.getPostNotes({ name: "staff", id: "822057428507049984" });
  • getTagTimelineGet posts tagged with a specific tag.

    Arguments

    NameTypeRequired
    tagstring
    The tag, with or without a leading #.
    Yes
    sort"top" | "recent"
    "top" (default) or "recent".
    No
    limitnumber
    1-20, default 20.
    No
    cursorstring
    A previous page's nextCursor.
    No

    Returns TumblrSearchPage

    interface TumblrPost {
      /** The post id as a string, what getPost takes. */
      id: string;
      blogName: string;
      url: string;
      shortUrl: string;
      /** ISO timestamp the post was published. */
      publishedAt: string | null;
      tags: string[];
      summary: string;
      /** Every text block, in order, joined by newlines. */
      text: string;
      /** The largest rendition of every image block, in order. */
      images: string[];
      /** Urls of link, video and audio blocks, in order. */
      links: string[];
      noteCount: number;
      likeCount: number;
      reblogCount: number;
      isNsfw: boolean;
      /** The blog this was reblogged from, or null for an original post. */
      rebloggedFrom: string | null;
      reblogKey: string;
    }
    
    interface TumblrSearchPage {
      posts: TumblrPost[];
      /** Pass back as cursor for the next page; null on the last page. */
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/getTagTimeline

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.getTagTimeline({ tag: "cats", limit: 3 });
  • getTrendingPostsGet posts that are currently trending on Tumblr.

    Arguments

    NameTypeRequired
    limitnumber
    1-20, default 20.
    No
    cursorstring
    A previous page's nextCursor.
    No

    Returns TumblrSearchPage

    interface TumblrPost {
      /** The post id as a string, what getPost takes. */
      id: string;
      blogName: string;
      url: string;
      shortUrl: string;
      /** ISO timestamp the post was published. */
      publishedAt: string | null;
      tags: string[];
      summary: string;
      /** Every text block, in order, joined by newlines. */
      text: string;
      /** The largest rendition of every image block, in order. */
      images: string[];
      /** Urls of link, video and audio blocks, in order. */
      links: string[];
      noteCount: number;
      likeCount: number;
      reblogCount: number;
      isNsfw: boolean;
      /** The blog this was reblogged from, or null for an original post. */
      rebloggedFrom: string | null;
      reblogKey: string;
    }
    
    interface TumblrSearchPage {
      posts: TumblrPost[];
      /** Pass back as cursor for the next page; null on the last page. */
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/getTrendingPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.getTrendingPosts({ limit: 3 });
  • getTrendingTagsGet tags that are currently trending on Tumblr.

    Arguments

    None.

    Returns TumblrTrendingTagsPage

    interface TumblrTrendingTag {
      tag: string;
      followerCount: number;
      recentPostCount: number;
      relatedTags: string[];
    }
    
    interface TumblrTrendingTagsPage {
      tags: TumblrTrendingTag[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/getTrendingTags

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.getTrendingTags();
  • listAsksAsks and submissions waiting in the signed-in caller's own blog inbox.

    Arguments

    NameTypeRequired
    blogstring
    The signed-in caller's own blog.
    Yes
    limitnumberNo
    offsetnumberNo

    Returns TumblrAsksPage

    interface TumblrPost {
      /** The post id as a string, what getPost takes. */
      id: string;
      blogName: string;
      url: string;
      shortUrl: string;
      /** ISO timestamp the post was published. */
      publishedAt: string | null;
      tags: string[];
      summary: string;
      /** Every text block, in order, joined by newlines. */
      text: string;
      /** The largest rendition of every image block, in order. */
      images: string[];
      /** Urls of link, video and audio blocks, in order. */
      links: string[];
      noteCount: number;
      likeCount: number;
      reblogCount: number;
      isNsfw: boolean;
      /** The blog this was reblogged from, or null for an original post. */
      rebloggedFrom: string | null;
      reblogKey: string;
    }
    
    interface TumblrAsksPage {
      /** Asks and submissions waiting in the inbox, as post rows. */
      asks: TumblrPost[];
      /** Pass as offset for the next page, or null on the last. */
      nextOffset: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/listAsks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.listAsks({ blog: "staff" });
  • listBlogFollowersList followers of a blog; caller must own the blog.

    Arguments

    NameTypeRequired
    blogstring
    A blog the signed-in caller owns.
    Yes
    limitnumber
    1-20, default 20.
    No
    offsetnumberNo

    Returns TumblrFollowersPage

    interface TumblrFollower {
      name: string;
      url: string;
      /** Whether the signed-in caller follows this blog back. */
      following: boolean;
      updatedAt: string | null;
    }
    
    interface TumblrFollowersPage {
      totalFollowers: number;
      followers: TumblrFollower[];
      /** Pass as offset for the next page, or null on the last. */
      nextOffset: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/listBlogFollowers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.listBlogFollowers({ blog: "staff" });
  • listDraftsList the drafts or queued posts on the signed-in caller's own blog.

    Arguments

    NameTypeRequired
    blogstring
    The signed-in caller's own blog.
    Yes
    state"draft" | "queue"
    "draft" (default) or "queue".
    No
    limitnumberNo
    offsetnumberNo

    Returns TumblrDraftsPage

    interface TumblrPost {
      /** The post id as a string, what getPost takes. */
      id: string;
      blogName: string;
      url: string;
      shortUrl: string;
      /** ISO timestamp the post was published. */
      publishedAt: string | null;
      tags: string[];
      summary: string;
      /** Every text block, in order, joined by newlines. */
      text: string;
      /** The largest rendition of every image block, in order. */
      images: string[];
      /** Urls of link, video and audio blocks, in order. */
      links: string[];
      noteCount: number;
      likeCount: number;
      reblogCount: number;
      isNsfw: boolean;
      /** The blog this was reblogged from, or null for an original post. */
      rebloggedFrom: string | null;
      reblogKey: string;
    }
    
    interface TumblrDraftsPage {
      state: "draft" | "queue";
      posts: TumblrPost[];
      /** Pass as offset for the next page, or null on the last. */
      nextOffset: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/listDrafts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.listDrafts({ blog: "staff" });
  • listFollowedTagsList the hashtags the signed-in caller follows.

    Arguments

    None.

    Returns TumblrFollowedTagsPage

    interface TumblrFollowedTagsPage {
      /** Tag names without the "#". */
      tags: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/listFollowedTags

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.listFollowedTags();
  • listFollowingList the blogs the signed-in caller follows.

    Arguments

    NameTypeRequired
    limitnumberNo
    offsetnumberNo

    Returns TumblrFollowingPage

    interface TumblrFollowedBlog {
      name: string;
      title: string;
      url: string;
      updatedAt: string | null;
    }
    
    interface TumblrFollowingPage {
      totalBlogs: number;
      blogs: TumblrFollowedBlog[];
      /** Pass as offset for the next page, or null on the last. */
      nextOffset: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/listFollowing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.listFollowing({ limit: 2 });
  • listLikesList the signed-in caller's own likes.

    Arguments

    NameTypeRequired
    limitnumberNo
    cursorstring
    NextCursor off the previous page.
    No

    Returns TumblrLikesPage

    interface TumblrPost {
      /** The post id as a string, what getPost takes. */
      id: string;
      blogName: string;
      url: string;
      shortUrl: string;
      /** ISO timestamp the post was published. */
      publishedAt: string | null;
      tags: string[];
      summary: string;
      /** Every text block, in order, joined by newlines. */
      text: string;
      /** The largest rendition of every image block, in order. */
      images: string[];
      /** Urls of link, video and audio blocks, in order. */
      links: string[];
      noteCount: number;
      likeCount: number;
      reblogCount: number;
      isNsfw: boolean;
      /** The blog this was reblogged from, or null for an original post. */
      rebloggedFrom: string | null;
      reblogKey: string;
    }
    
    interface TumblrLikesPage {
      posts: TumblrPost[];
      totalLikes: number;
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/listLikes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.listLikes({ limit: 2 });
  • listMyBlogsList the blogs the signed-in caller owns.

    Arguments

    None.

    Returns TumblrMyBlogsPage

    interface TumblrMyBlog {
      name: string;
      title: string;
      url: string;
      /** True for the caller's primary blog. */
      primary: boolean;
    }
    
    interface TumblrMyBlogsPage {
      blogs: TumblrMyBlog[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/listMyBlogs

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.listMyBlogs();
  • listNotificationsActivity on the signed-in caller's own blog.

    Arguments

    NameTypeRequired
    blogstring
    The signed-in caller's own blog.
    Yes
    limitnumber
    Page size, applied to the first page too.
    No
    cursorstringNo

    Returns TumblrNotificationsPage

    interface TumblrNotification {
      /** like, reblog, follow, reply, ask, mention, Tumblr's own type string. */
      type: string;
      fromBlog: string;
      postId: string | null;
      text: string;
      at: string | null;
    }
    
    interface TumblrNotificationsPage {
      notifications: TumblrNotification[];
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/listNotifications

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.listNotifications({ blog: "staff" });
  • searchBlogPostsSearch posts within a specific blog.

    Arguments

    NameTypeRequired
    namestring
    A blog name or url, as findBlog takes.
    Yes
    querystringYes
    limitnumber
    1-20, default 20.
    No
    cursorstring
    A previous page's nextCursor.
    No

    Returns TumblrSearchPage

    interface TumblrPost {
      /** The post id as a string, what getPost takes. */
      id: string;
      blogName: string;
      url: string;
      shortUrl: string;
      /** ISO timestamp the post was published. */
      publishedAt: string | null;
      tags: string[];
      summary: string;
      /** Every text block, in order, joined by newlines. */
      text: string;
      /** The largest rendition of every image block, in order. */
      images: string[];
      /** Urls of link, video and audio blocks, in order. */
      links: string[];
      noteCount: number;
      likeCount: number;
      reblogCount: number;
      isNsfw: boolean;
      /** The blog this was reblogged from, or null for an original post. */
      rebloggedFrom: string | null;
      reblogKey: string;
    }
    
    interface TumblrSearchPage {
      posts: TumblrPost[];
      /** Pass back as cursor for the next page; null on the last page. */
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/searchBlogPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.searchBlogPosts({ name: "staff", query: "tumblr", limit: 3 });
  • searchPostsSearch all posts across Tumblr by keyword or phrase.

    Arguments

    NameTypeRequired
    querystringYes
    limitnumber
    1-20, default 20.
    No
    cursorstring
    A previous page's nextCursor.
    No

    Returns TumblrSearchPage

    interface TumblrPost {
      /** The post id as a string, what getPost takes. */
      id: string;
      blogName: string;
      url: string;
      shortUrl: string;
      /** ISO timestamp the post was published. */
      publishedAt: string | null;
      tags: string[];
      summary: string;
      /** Every text block, in order, joined by newlines. */
      text: string;
      /** The largest rendition of every image block, in order. */
      images: string[];
      /** Urls of link, video and audio blocks, in order. */
      links: string[];
      noteCount: number;
      likeCount: number;
      reblogCount: number;
      isNsfw: boolean;
      /** The blog this was reblogged from, or null for an original post. */
      rebloggedFrom: string | null;
      reblogKey: string;
    }
    
    interface TumblrSearchPage {
      posts: TumblrPost[];
      /** Pass back as cursor for the next page; null on the last page. */
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/searchPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.searchPosts({ query: "cats", limit: 3 });
Act 13
  • createPostCreate a new post on the signed-in account's blog.

    Arguments

    NameTypeRequired
    blogstring
    Your own blog name, or its tumblr.com url.
    Yes
    textstring
    The post body; blank lines split it into paragraphs.
    Yes
    titlestring
    Optional heading above the body.
    No
    tagsstring[]No
    state"published" | "draft" | "queue" | "private"
    Default "published".
    No

    Returns TumblrComposeResult

    interface TumblrComposeResult {
      ok: true;
      /** The post's id, or null when Tumblr's answer carried none. */
      id: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/createPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.createPost({ blog: "<blog>", text: "<text>" });
  • deletePostDelete a post from the signed-in account's blog.

    Arguments

    NameTypeRequired
    blogstring
    The signed-in caller's own blog.
    Yes
    idstringYes

    Returns { ok: true }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/deletePost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.deletePost({ blog: "<blog>", id: "<id>" });
  • editPostEdit an existing post on the signed-in account's blog.

    Arguments

    NameTypeRequired
    blogstringYes
    idstring
    The post id on your own blog.
    Yes
    textstring
    Replaces the whole body.
    Yes
    titlestringNo
    tagsstring[]No
    state"published" | "draft" | "queue" | "private"No

    Returns TumblrComposeResult

    interface TumblrComposeResult {
      ok: true;
      /** The post's id, or null when Tumblr's answer carried none. */
      id: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/editPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.editPost({ blog: "<blog>", id: "<id>", text: "<text>" });
  • followBlogFollow a blog from the signed-in account.

    Arguments

    NameTypeRequired
    namestring
    A blog name like "staff", or its tumblr.com url.
    Yes

    Returns TumblrEngageResult

    interface TumblrEngageResult {
      ok: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/followBlog

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.followBlog({ name: "<name>" });
  • followTagFollow a hashtag on the signed-in caller's account.

    Arguments

    NameTypeRequired
    tagstring
    The hashtag, "cats" or "#cats".
    Yes

    Returns TumblrTagResult

    interface TumblrTagResult {
      ok: true;
      /** The tag as sent, without the "#". */
      tag: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/followTag

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.followTag({ tag: "<tag>" });
  • likePostLike a post from the signed-in account.

    Arguments

    NameTypeRequired
    idstring
    The post id, off a post row.
    Yes
    reblogKeystring
    The post row's reblogKey.
    Yes

    Returns TumblrEngageResult

    interface TumblrEngageResult {
      ok: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/likePost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.likePost({ id: "<id>", reblogKey: "<reblogKey>" });
  • reblogPostReblog a post to the signed-in account's blog.

    Arguments

    NameTypeRequired
    blogstring
    The signed-in caller's own blog to reblog onto.
    Yes
    idstringYes
    reblogKeystringYes
    commentstringNo

    Returns TumblrReblogResult

    interface TumblrReblogResult {
      ok: true;
      /** The new reblog's own post id, what unreblogPost takes. */
      id: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/reblogPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.reblogPost({ blog: "<blog>", id: "<id>", reblogKey: "<reblogKey>" });
  • sendMessageSend an ask (public or anonymous) to a blog.

    Arguments

    NameTypeRequired
    blogstringYes
    textstringYes
    anonymousboolean
    Ask without your name attached; the recipient must accept anonymous asks.
    No

    Returns TumblrComposeResult

    interface TumblrComposeResult {
      ok: true;
      /** The post's id, or null when Tumblr's answer carried none. */
      id: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/sendMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.sendMessage({ blog: "<blog>", text: "<text>" });
  • unfollowBlogUnfollow a blog from the signed-in account.

    Arguments

    NameTypeRequired
    namestring
    A blog name like "staff", or its tumblr.com url.
    Yes

    Returns TumblrEngageResult

    interface TumblrEngageResult {
      ok: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/unfollowBlog

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.unfollowBlog({ name: "<name>" });
  • unfollowTagStop following a hashtag on the signed-in caller's account.

    Arguments

    NameTypeRequired
    tagstring
    The hashtag, "cats" or "#cats".
    Yes

    Returns TumblrTagResult

    interface TumblrTagResult {
      ok: true;
      /** The tag as sent, without the "#". */
      tag: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/unfollowTag

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.unfollowTag({ tag: "<tag>" });
  • unlikePostRemove a like from a post on the signed-in account.

    Arguments

    NameTypeRequired
    idstring
    The post id, off a post row.
    Yes
    reblogKeystring
    The post row's reblogKey.
    Yes

    Returns TumblrEngageResult

    interface TumblrEngageResult {
      ok: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/unlikePost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.unlikePost({ id: "<id>", reblogKey: "<reblogKey>" });
  • unreblogPostRemove a reblog from the signed-in account's blog.

    Arguments

    NameTypeRequired
    blogstring
    The signed-in caller's own blog.
    Yes
    idstringYes

    Returns { ok: true }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/unreblogPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.unreblogPost({ blog: "<blog>", id: "<id>" });
  • updateBlogInfoChange the title and description of one of the signed-in caller's own blogs.

    Arguments

    NameTypeRequired
    blogstring
    The signed-in caller's own blog.
    Yes
    titlestringNo
    descriptionstringNo

    Returns TumblrUpdateBlogResult

    interface TumblrUpdateBlogResult {
      ok: true;
      blog: string;
      title?: string;
      description?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tumblr/updateBlogInfo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tumblr.updateBlogInfo({ blog: "<blog>" });

Use it from code