Tumblr.js

https://tumblr.github.io/tumblr.js/
Admin
The official JavaScript client library for interacting with the Tumblr API, providing methods for...
Tokens:6,271
Snippets:70
Trust Score:8.3
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install tumblr.js

Source: https://tumblr.github.io/tumblr.js/index.html

Use npm to add the library to your project dependencies.

```bash
npm install --save tumblr.js
```

--------------------------------

### Media MIME Type Example

Source: https://tumblr.github.io/tumblr.js/interfaces/types.MediaObject.html

Example value for the type property of a MediaObject.

```json
"image/jpg"
```

--------------------------------

### userInfo(callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Gets information about the authenticating user and their blogs.

```APIDOC
## userInfo(callback)

### Description
Gets information about the authenticating user and their blogs.

### Parameters
- **callback** (TumblrClientCallback) - Optional - Deprecated: Omit the callback and use the promise form

### Returns
- **Promise<any> | undefined** - Returns a Promise if no callback is provided.
```

--------------------------------

### userFollowing(paramsOrCallback, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Gets the blogs the authenticating user follows.

```APIDOC
## userFollowing(paramsOrCallback, callback)

### Description
Gets the blogs the authenticating user follows.

### Parameters
- **paramsOrCallback** (TumblrClientCallback | { limit?: number; offset?: number }) - Optional - Query parameters
- **callback** (TumblrClientCallback) - Optional - Deprecated: Omit the callback and use the promise form

### Returns
- **Promise<any> | undefined** - Returns a Promise if no callback is provided.
```

--------------------------------

### client.getRequest(apiPath, params)

Source: https://tumblr.github.io/tumblr.js/index.html

Performs an arbitrary GET request to the specified API path with the provided parameters.

```APIDOC
## client.getRequest(apiPath, params)

### Description
Performs an arbitrary GET request to the specified API path with the provided parameters.

### Parameters
- **apiPath** (string) - Required - The path of the API endpoint.
- **params** (object) - Optional - The query parameters to include in the request.
```

--------------------------------

### userDashboard(paramsOrCallback, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Gets the dashboard posts for the authenticating user.

```APIDOC
## userDashboard(paramsOrCallback, callback)

### Description
Gets the dashboard posts for the authenticating user.

### Parameters
- **paramsOrCallback** (Record<string, any> | TumblrClientCallback) - Optional - Query parameters
- **callback** (TumblrClientCallback) - Optional - Deprecated: Omit the callback and use the promise form

### Returns
- **Promise<any> | undefined** - Returns a Promise if no callback is provided.
```

--------------------------------

### getRequest

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Performs a generic GET request to the Tumblr API.

```APIDOC
## getRequest(apiPath, paramsOrCallback, callback)

### Description
Performs a GET request.

### Parameters
- **apiPath** (string) - Required - URL path for the request.
- **paramsOrCallback** (Record<string, any> | TumblrClientCallback) - Optional - Query parameters.
- **callback** (TumblrClientCallback) - Optional - Deprecated. Omit the callback and use the promise form.

### Returns
- **Promise<any> | undefined** - Promise if no callback is provided.
```

--------------------------------

### Execute Arbitrary API Requests

Source: https://tumblr.github.io/tumblr.js/index.html

Use these methods to perform custom GET, POST, or PUT requests to the Tumblr API.

```javascript
// GET requests  
client.getRequest(apiPath, params);  
  
// POST requests  
client.postRequest(apiPath, params);  
  
// PUT requests  
client.putRequest(apiPath, params);
```

--------------------------------

### taggedPosts(tag, paramsOrCallback, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Gets posts tagged with the specified tag.

```APIDOC
## taggedPosts(tag, paramsOrCallback, callback)

### Description
Gets posts tagged with the specified tag.

### Parameters
- **tag** (string) - Required - The tag on the posts you'd like to retrieve
- **paramsOrCallback** (Record<string, any> | TumblrClientCallback) - Optional - Query parameters
- **callback** (TumblrClientCallback) - Optional - Deprecated: Omit the callback and use the promise form

### Returns
- **Promise<any> | undefined** - Returns a Promise if no callback is provided.
```

--------------------------------

### Run full integration tests

Source: https://tumblr.github.io/tumblr.js/media/CONTRIBUTING.md

Execute the full integration test suite by providing all required OAuth1 credentials as environment variables.

```sh
TUMBLR_OAUTH_CONSUMER_KEY='--- valid consumer_key ---' \
TUMBLR_OAUTH_CONSUMER_SECRET='--- valid consumer_secret ---' \
TUMBLR_OAUTH_TOKEN='--- valid token ---' \
TUMBLR_OAUTH_TOKEN_SECRET='--- valid token_key ---' \
npm run test:integration
```

--------------------------------

### Initialize Tumblr Client in Node.js

Source: https://tumblr.github.io/tumblr.js/index.html

Create a client instance using your OAuth credentials. The library returns promises for all request methods.

```javascript
const tumblr = require('tumblr.js');  
const client = tumblr.createClient({  
  consumer_key: '<consumer key>',  
  consumer_secret: '<consumer secret>',  
  token: '<oauth token>',  
  token_secret: '<oauth token secret>',  
});
```

```javascript
const tumblr = require('tumblr.js');  
const client = new tumblr.Client({  
  // ...  
});
```

--------------------------------

### new Client(options)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Creates a new instance of the Tumblr API client.

```APIDOC
## new Client(options)

### Description
Creates a Tumblr API client using the given options.

### Parameters
- **options** (Options) - Optional - Client configuration options.
```

--------------------------------

### createClient(options?: Options): Client

Source: https://tumblr.github.io/tumblr.js/functions/tumblr.createClient.html

Initializes a new Tumblr client instance using the provided configuration options.

```APIDOC
## createClient(options?: Options): Client

### Description
Creates and returns a new Tumblr Client instance to facilitate API interactions.

### Parameters
- **options** (Options) - Optional - Configuration options for the Tumblr client.

### Returns
- **Client** - A new instance of the Tumblr Client.
```

--------------------------------

### Options Interface

Source: https://tumblr.github.io/tumblr.js/interfaces/types.Options.html

Configuration object used to initialize the Tumblr client.

```APIDOC
## Options Interface

### Description
Configuration object used to initialize the Tumblr client with authentication credentials and custom settings.

### Properties
- **baseUrl** (string) - Optional - The API url if different from the default.
- **consumer_key** (string) - Optional - OAuth1 credential. Required for API key auth endpoints.
- **consumer_secret** (string) - Optional - OAuth1 credential. Required for OAuth endpoints.
- **returnPromises** (boolean) - Optional - Deprecated. Methods will return promises if no callback is provided.
- **token** (string) - Optional - OAuth1 credential. Required for OAuth endpoints.
- **token_secret** (string) - Optional - OAuth1 credential. Required for Oauth endpoints.
```

--------------------------------

### Run Development and Quality Assurance Tasks

Source: https://tumblr.github.io/tumblr.js/index.html

Execute these commands in the terminal to verify code quality and run the test suite.

```bash
# Run tests  
npm run test  
  
# Lint  
npm run lint  
  
# Typecheck  
npm run typecheck
```

--------------------------------

### Run unit tests

Source: https://tumblr.github.io/tumblr.js/media/CONTRIBUTING.md

Execute the unit test suite located in the test/ directory.

```sh
npm run test
```

--------------------------------

### Run partial integration tests

Source: https://tumblr.github.io/tumblr.js/media/CONTRIBUTING.md

Execute integration tests requiring only the consumer key.

```sh
TUMBLR_OAUTH_CONSUMER_KEY='--- valid consumer_key ---' \
npm run test:integration
```

--------------------------------

### Create an NPF Post

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Demonstrates creating a new post with image content using the NPF format. Requires a readable stream for media uploads.

```javascript
await client.createPost(blogName, {  
  content: [  
    {  
      type: 'image',  
      // Node's fs module, e.g. `import fs from 'node:fs';`  
      media: fs.createReadStream(new URL('./image.jpg', import.meta.url)),  
      alt_text: '…',  
    },  
  ],  
});
```

--------------------------------

### Blog Information and Content Methods

Source: https://tumblr.github.io/tumblr.js/index.html

Retrieves metadata, posts, avatars, likes, followers, and queue/draft/submission data for a specified blog.

```javascript
// Get information about a given blog  
const blogInfo = await client.blogInfo(blogName);  
  
// Get a list of posts for a blog (with optional filtering)  
const blogPosts = await client.blogPosts(blogName, options);  
  
// Get the avatar URL for a blog  
const blogAvatar = await client.blogAvatar(blogName);  
  
// Get the likes for a blog  
const blogLikes = await client.blogLikes(blogName, options);  
  
// Get the followers for a blog  
const blogFollowers = await client.blogFollowers(blogName, options);  
  
// Get the queue for a blog  
const blogQueue = await client.blogQueue(blogName, options);  
  
// Get the drafts for a blog  
const blogDrafts = await client.blogDrafts(blogName, options);  
  
// Get the submissions for a blog  
const blogSubmissions = await client.blogSubmissions(blogName, options);
```

--------------------------------

### Blog Methods

Source: https://tumblr.github.io/tumblr.js/index.html

Methods for retrieving blog-specific information, posts, avatars, likes, followers, and content management queues.

```APIDOC
## client.blogInfo(blogName)
### Description
Retrieves information about a given blog.

## client.blogPosts(blogName, options)
### Description
Retrieves a list of posts for a blog, with optional filtering.

## client.blogAvatar(blogName)
### Description
Retrieves the avatar URL for a blog.

## client.blogLikes(blogName, options)
### Description
Retrieves the likes for a blog.

## client.blogFollowers(blogName, options)
### Description
Retrieves the followers for a blog.

## client.blogQueue(blogName, options)
### Description
Retrieves the queue for a blog.

## client.blogDrafts(blogName, options)
### Description
Retrieves the drafts for a blog.

## client.blogSubmissions(blogName, options)
### Description
Retrieves the submissions for a blog.
```

--------------------------------

### Post Creation and Management

Source: https://tumblr.github.io/tumblr.js/index.html

Methods for creating, editing, and deleting posts, including support for media uploads via ReadStream.

```javascript
await client.createPost(blogName, options);
```

```javascript
await client.createPost(blogName, {  
  content: [  
    {  
      type: 'image',  
      // Node's fs module, e.g. `import fs from 'node:fs';`  
      media: fs.createReadStream(new URL('./image.jpg', import.meta.url)),  
      alt_text: '…',  
    },  
  ],  
});
```

```javascript
await client.editPost(blogName, postId, options);
```

```javascript
await client.deletePost(blogName, postId);
```

--------------------------------

### client.postRequest(apiPath, params)

Source: https://tumblr.github.io/tumblr.js/index.html

Performs an arbitrary POST request to the specified API path with the provided parameters.

```APIDOC
## client.postRequest(apiPath, params)

### Description
Performs an arbitrary POST request to the specified API path with the provided parameters.

### Parameters
- **apiPath** (string) - Required - The path of the API endpoint.
- **params** (object) - Optional - The body parameters to include in the request.
```

--------------------------------

### blogQueue(blogIdentifier, paramsOrCallback, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Retrieves the queue for a specific blog.

```APIDOC
## blogQueue(blogIdentifier, paramsOrCallback, callback)

### Description
Gets the queue for a blog.

### Parameters
- **blogIdentifier** (string) - Required - The blog name or URL.
- **paramsOrCallback** (object|function) - Optional - Optional data sent with the request.
- **callback** (function) - Optional - Deprecated, use the promise form instead.
```

--------------------------------

### User Management Methods

Source: https://tumblr.github.io/tumblr.js/index.html

Provides methods for retrieving user data, dashboard content, likes, and following status, as well as managing blog follows and post likes.

```javascript
// Get information about the authenticating user & their blogs  
const userInfo = await client.userInfo();  
  
// Get dashboard for authenticating user  
const userDashboard = await client.userDashboard(options);  
  
// Get likes for authenticating user  
const userLikes = await client.userLikes(options);  
  
// Get followings for authenticating user  
const userFollowing = await client.userFollowing(options);  
  
// Follow or unfollow a given blog  
await client.followBlog(blogURL);  
await client.unfollowBlog(blogURL);  
  
// Like or unlike a given post  
await client.likePost(postId, reblogKey);  
await client.unlikePost(postId, reblogKey);
```

--------------------------------

### Post Methods

Source: https://tumblr.github.io/tumblr.js/index.html

Methods for creating, editing, and deleting posts on a blog.

```APIDOC
## client.createPost(blogName, options)
### Description
Creates a new post on the specified blog. Supports media uploads via ReadStream.

## client.editPost(blogName, postId, options)
### Description
Edits an existing post on the specified blog.

## client.deletePost(blogName, postId)
### Description
Deletes a post from the specified blog.
```

--------------------------------

### User Methods

Source: https://tumblr.github.io/tumblr.js/index.html

Methods for retrieving information about the authenticated user, their dashboard, likes, and following list, as well as managing follows and likes.

```APIDOC
## client.userInfo()
### Description
Retrieves information about the authenticating user and their blogs.

## client.userDashboard(options)
### Description
Retrieves the dashboard for the authenticating user.

## client.userLikes(options)
### Description
Retrieves the likes for the authenticating user.

## client.userFollowing(options)
### Description
Retrieves the list of blogs followed by the authenticating user.

## client.followBlog(blogURL)
### Description
Follows a specific blog.

## client.unfollowBlog(blogURL)
### Description
Unfollows a specific blog.

## client.likePost(postId, reblogKey)
### Description
Likes a specific post.

## client.unlikePost(postId, reblogKey)
### Description
Unlikes a specific post.
```

--------------------------------

### blogInfo(blogIdentifier, paramsOrCallback, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Retrieves information about a specific blog.

```APIDOC
## blogInfo(blogIdentifier, paramsOrCallback, callback)

### Description
Gets information about a given blog.

### Parameters
- **blogIdentifier** (string) - Required - The blog name or URL.
- **paramsOrCallback** (object|function) - Optional - Query parameters.
- **callback** (function) - Optional - Deprecated, use the promise form instead.
```

--------------------------------

### blogLikes(blogIdentifier, paramsOrCallback, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Retrieves the likes for a specific blog.

```APIDOC
## blogLikes(blogIdentifier, paramsOrCallback, callback)

### Description
Gets the likes for a blog.

### Parameters
- **blogIdentifier** (string) - Required - The blog name or URL.
- **paramsOrCallback** (object|function) - Optional - Optional data sent with the request.
- **callback** (function) - Optional - Deprecated, use the promise form instead.
```

--------------------------------

### postRequest(apiPath, paramsOrCallback, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Performs a POST request to the specified API path.

```APIDOC
## postRequest(apiPath, paramsOrCallback, callback)

### Description
Performs a POST request to the specified API path.

### Parameters
- **apiPath** (string) - Required - URL path for the request
- **paramsOrCallback** (Record<string, any> | TumblrClientCallback) - Optional - Parameters or callback function
- **callback** (TumblrClientCallback) - Optional - Deprecated: Omit the callback and use the promise form

### Returns
- **Promise<any> | undefined** - Returns a Promise if no callback is provided.
```

--------------------------------

### createPost

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Creates or reblogs an NPF post on the specified blog.

```APIDOC
## createPost(blogIdentifier, params, callback)

### Description
Create or reblog an NPF post.

### Parameters
- **blogIdentifier** (string) - Required - Blog name or URL.
- **params** (NpfPostParams | NpfReblogParams) - Required - Post parameters.
- **callback** (TumblrClientCallback) - Optional - Deprecated. Omit the callback and use the promise form.

### Returns
- **Promise<any> | undefined** - Promise if no callback is provided.
```

--------------------------------

### Retrieve User Blog Names

Source: https://tumblr.github.io/tumblr.js/index.html

Uses a callback function to access and log the names of blogs associated with the authenticated user.

```javascript
// Show user's blog names  
client.userInfo(function (err, data) {  
  data.user.blogs.forEach(function (blog) {  
    console.log(blog.name);  
  });  
});
```

--------------------------------

### blogFollowers(blogIdentifier, paramsOrCallback, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Retrieves the list of followers for a blog.

```APIDOC
## blogFollowers(blogIdentifier, paramsOrCallback, callback)

### Description
Gets the followers for a blog.

### Parameters
- **blogIdentifier** (string) - Required - The blog name or URL.
- **paramsOrCallback** (object|function) - Optional - Optional data sent with the request.
- **callback** (function) - Optional - Deprecated, use the promise form instead.
```

--------------------------------

### followBlog

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Follows a blog as the authenticated user.

```APIDOC
## followBlog(params, callback)

### Description
Follows a blog as the authenticating user.

### Parameters
- **params** ({ url: string } | { email: string }) - Required - Parameters sent with the request.
- **callback** (TumblrClientCallback) - Optional - Deprecated. Omit the callback and use the promise form.

### Returns
- **Promise<any> | undefined** - Promise if no callback is provided.
```

--------------------------------

### BlogPosts(blogIdentifier, params?)

Source: https://tumblr.github.io/tumblr.js/interfaces/types.BlogPosts.html

Retrieves a list of posts for a specified blog using a Promise-based approach.

```APIDOC
## BlogPosts(blogIdentifier, params?)

### Description
Gets a list of posts for a blog.

### Parameters
- **blogIdentifier** (string) - Required - Blog name or URL.
- **params** (BlogPostsParams) - Optional - Additional request parameters.

### Returns
- **Promise<any>** - A promise that resolves with the list of posts.
```

--------------------------------

### userLikes(paramsOrCallback, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Retrieves the likes for the authenticating user. Supports optional pagination parameters and returns a Promise.

```APIDOC
## userLikes(paramsOrCallback, callback)

### Description
Gets the likes for the authenticating user.

### Parameters
- **paramsOrCallback** (TumblrClientCallback | { after?: number; before?: number; limit?: number; offset?: number }) - Optional - Query parameters for pagination.
- **callback** (TumblrClientCallback) - Optional - Deprecated: Omit the callback and use the promise form.

### Returns
- **Promise<any> | undefined** - Returns a Promise if no callback is provided.
```

--------------------------------

### client.putRequest(apiPath, params)

Source: https://tumblr.github.io/tumblr.js/index.html

Performs an arbitrary PUT request to the specified API path with the provided parameters.

```APIDOC
## client.putRequest(apiPath, params)

### Description
Performs an arbitrary PUT request to the specified API path with the provided parameters.

### Parameters
- **apiPath** (string) - Required - The path of the API endpoint.
- **params** (object) - Optional - The body parameters to include in the request.
```

--------------------------------

### Retrieve Blog Posts

Source: https://tumblr.github.io/tumblr.js/index.html

Fetches posts from a specific blog, optionally filtered by type or tags.

```javascript
const response = await client.blogPosts('blogName', {  
  type: 'photo',  
  tag: ['multiple', 'tags', 'likethis'],  
});
```

```javascript
const response = await client.blogPosts('blogName');
```

--------------------------------

### Legacy Post Methods

Source: https://tumblr.github.io/tumblr.js/index.html

Deprecated methods for handling legacy post operations.

```javascript
// Create a legacy post  
const createdPost = await client.createLegacyPost(blogName, options);  
  
// Edit a legacy post  
await client.editLegacyPost(blogName, options);  
  
// Reblog a legacy post  
await client.reblogPost(blogName, options);
```

--------------------------------

### blogDrafts(blogIdentifier, paramsOrCallback, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Retrieves the drafts for a specific blog.

```APIDOC
## blogDrafts(blogIdentifier, paramsOrCallback, callback)

### Description
Gets the drafts for a blog.

### Parameters
- **blogIdentifier** (string) - Required - The blog name or URL.
- **paramsOrCallback** (object|function) - Optional - Optional data sent with the request.
- **callback** (function) - Optional - Deprecated, use the promise form instead.
```

--------------------------------

### reblogPost(blogIdentifier, params, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Reblogs a given post.

```APIDOC
## reblogPost(blogIdentifier, params, callback)

### Description
Reblogs a given post. Note: Legacy post creation methods are deprecated; use NPF methods.

### Parameters
- **blogIdentifier** (string) - Required - Blog name or URL
- **params** (Record<string, any>) - Required - Parameters sent with the request
- **callback** (TumblrClientCallback) - Optional - Deprecated: Omit the callback and use the promise form

### Returns
- **Promise<any> | undefined** - Returns a Promise if no callback is provided.
```

--------------------------------

### likePost

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Likes a post as the authenticated user.

```APIDOC
## likePost(postId, reblogKey, callback)

### Description
Likes a post as the authenticating user.

### Parameters
- **postId** (string) - Required - ID of post to like.
- **reblogKey** (string) - Required - Reblog key of post to like.
- **callback** (TumblrClientCallback) - Optional - Deprecated. Omit the callback and use the promise form.

### Returns
- **Promise<any> | undefined** - Promise if no callback is provided.
```

--------------------------------

### blogSubmissions

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Retrieves the submissions for a specified blog.

```APIDOC
## blogSubmissions(blogIdentifier, paramsOrCallback, callback)

### Description
Gets the submissions for a blog.

### Parameters
- **blogIdentifier** (string) - Required - Blog name or URL.
- **paramsOrCallback** (TumblrClientCallback | { filter?: PostFormatFilter; offset?: number }) - Optional - Optional data sent with the request.
- **callback** (TumblrClientCallback) - Optional - Deprecated. Omit the callback and use the promise form.

### Returns
- **Promise<any> | undefined** - Promise if no callback is provided.
```

--------------------------------

### putRequest(apiPath, paramsOrCallback, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Performs a PUT request to the specified API path.

```APIDOC
## putRequest(apiPath, paramsOrCallback, callback)

### Description
Performs a PUT request to the specified API path.

### Parameters
- **apiPath** (string) - Required - URL path for the request
- **paramsOrCallback** (Record<string, any> | TumblrClientCallback) - Optional - Parameters or callback function
- **callback** (TumblrClientCallback) - Optional - Deprecated: Omit the callback and use the promise form

### Returns
- **Promise<any> | undefined** - Returns a Promise if no callback is provided.
```

--------------------------------

### Tagged Methods

Source: https://tumblr.github.io/tumblr.js/index.html

Method for viewing posts associated with a specific tag.

```APIDOC
## client.taggedPosts(tag, options)
### Description
Retrieves posts tagged with a certain tag.
```

--------------------------------

### MediaObject Interface Definition

Source: https://tumblr.github.io/tumblr.js/interfaces/types.MediaObject.html

The TypeScript interface structure for media objects.

```typescript
interface MediaObject {  
cropped?: boolean;  
has_original_dimensions?: boolean;  
height?: number;  
original_dimensions_missing?: boolean;  
type?: string;  
url: string;  
width?: number;  
}
```

--------------------------------

### blogAvatar(blogIdentifier, sizeOrCallback, maybeCallback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Retrieves the avatar URL for a specified blog.

```APIDOC
## blogAvatar(blogIdentifier, sizeOrCallback, maybeCallback)

### Description
Gets the avatar URL for a blog.

### Parameters
- **blogIdentifier** (string) - Required - The blog name or URL.
- **sizeOrCallback** (number|function) - Optional - The size of the avatar or a callback function.
- **maybeCallback** (function) - Optional - Invoked when the request completes.
```

--------------------------------

### unlikePost(postId, reblogKey, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Unlikes a post as the authenticating user.

```APIDOC
## unlikePost(postId, reblogKey, callback)

### Description
Unlikes a post as the authenticating user.

### Parameters
- **postId** (string) - Required - ID of post to like
- **reblogKey** (string) - Required - Reblog key of post to like
- **callback** (TumblrClientCallback) - Optional - Deprecated: Omit the callback and use the promise form

### Returns
- **Promise<any> | undefined** - Returns a Promise if no callback is provided.
```

--------------------------------

### editPost

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Edits an existing NPF post.

```APIDOC
## editPost(blogIdentifier, postId, params, callback)

### Description
Edit an NPF post.

### Parameters
- **blogIdentifier** (string) - Required - Blog name or URL.
- **postId** (string) - Required - Post ID.
- **params** (NpfPostParams | NpfReblogParams) - Required - Post parameters.
- **callback** (TumblrClientCallback) - Optional - Deprecated. Omit the callback and use the promise form.

### Returns
- **Promise<any> | undefined** - Promise if no callback is provided.
```

--------------------------------

### unfollowBlog(params, callback)

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Unfollows a blog as the authenticating user.

```APIDOC
## unfollowBlog(params, callback)

### Description
Unfollows a blog as the authenticating user.

### Parameters
- **params** ({ url: string }) - Required - Parameters sent with the request
- **callback** (TumblrClientCallback) - Optional - Deprecated: Omit the callback and use the promise form

### Returns
- **Promise<any> | undefined** - Returns a Promise if no callback is provided.
```

--------------------------------

### Tagged Post Retrieval

Source: https://tumblr.github.io/tumblr.js/index.html

Fetches posts associated with a specific tag.

```javascript
// View posts tagged with a certain tag  
client.taggedPosts(tag, options);  
client.taggedPosts(tag);
```

--------------------------------

### deletePost

Source: https://tumblr.github.io/tumblr.js/classes/tumblr.Client.html

Deletes a specific post from a blog.

```APIDOC
## deletePost(blogIdentifier, postId, callback)

### Description
Deletes a given post.

### Parameters
- **blogIdentifier** (string) - Required - Blog name or URL.
- **postId** (string) - Required - Post ID to delete.
- **callback** (TumblrClientCallback) - Optional - Deprecated. Omit the callback and use the promise form.

### Returns
- **Promise<any> | undefined** - Promise if no callback is provided.
```
Tokens:
Raw