Bufferapp API

by bufferapp.com

OAuthHTTPSSocial

Overview

Social media management for marketers and agencies

Bufferapp is a social API from bufferapp.com. Requests are authenticated with OAuth. It is served over HTTPS. Its OpenAPI description documents 18 endpoints.

At a glance

Authentication: OAuth
HTTPS: Yes
CORS: Unknown
Category: Social
Base URL: https://api.bufferapp.com/1/
Version: 1
Endpoints: 18
OpenAPI: Specification ↗
Spec updated: 2021-06-21

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "https://api.bufferapp.com/1/info/configurationMEDIATYPEEXTENSION" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

JavaScript

const response = await fetch("https://api.bufferapp.com/1/info/configurationMEDIATYPEEXTENSION", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://api.bufferapp.com/1/info/configurationMEDIATYPEEXTENSION",
    headers={
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
GET	`/info/configuration{mediaTypeExtension}`	Returns an object with the current configuration that Buffer is using, including supported services, their icons and the varying limits of character and schedul
GET	`/links/shares{mediaTypeExtension}`	Returns an object with a the numbers of shares a link has had using Buffer.
POST	`/profiles/{id}/schedules/update{mediaTypeExtension}`	"Set the posting schedules for the specified social media profile.
GET	`/profiles/{id}/schedules{mediaTypeExtension}`	Returns details of the posting schedules associated with a social media profile.
GET	`/profiles/{id}/updates/pending{mediaTypeExtension}`	"Returns an array of updates that are currently in the buffer for an individual social media profile.
POST	`/profiles/{id}/updates/reorder{mediaTypeExtension}`	Edit the order at which statuses for the specified social media profile will be sent out of the buffer.
GET	`/profiles/{id}/updates/sent{mediaTypeExtension}`	Returns an array of updates that have been sent from the buffer for an individual social media profile.
POST	`/profiles/{id}/updates/shuffle{mediaTypeExtension}`	Randomize the order at which statuses for the specified social media profile will be sent out of the buffer.
GET	`/profiles/{id}{mediaTypeExtension}`	Returns details of the single specified social media profile.
GET	`/profiles{mediaTypeExtension}`	Returns an array of social media profiles connected to a users account.
POST	`/updates/create{mediaTypeExtension}`	Create one or more new status updates.
POST	`/updates/{id}/destroy{mediaTypeExtension}`	Permanently delete an existing status update.
GET	`/updates/{id}/interactions{mediaTypeExtension}`	Returns the detailed information on individual interactions with the social media update such as favorites, retweets and likes.
POST	`/updates/{id}/move_to_top{mediaTypeExtension}`	Move an existing status update to the top of the queue and recalculate times for all updates in the queue. Returns the update with its new posting time.
POST	`/updates/{id}/share{mediaTypeExtension}`	Immediately shares a single pending update and recalculates times for updates remaining in the queue.
POST	`/updates/{id}/update{mediaTypeExtension}`	Edit an existing, individual status update.
GET	`/updates/{id}{mediaTypeExtension}`	Returns a single social media update.
GET	`/user{mediaTypeExtension}`	Returns a single user.