go-meerkat is a Go library for accessing the Meerkat API. This document also provides details of the API itself.
The Meerkat API is fairly simple and self-describing. All endpoints here have been discovered simply by viewing streams on the web and inspecting the requests.
In some cases, the web server will also show what routes are available if an invalid route is specified. Examples of these are shown below.
Some endpoints require a version parameter (v) to be specified in the URL.
There are several hosts that are used in accessing the API. So far, I've found the following.
- resources.meerkatapp.co
- Primary endpoint, used for accessing broadcasts and users
- social.meerkatapp.co
- Used for taking actions on a user - follow, report, etc
- social-cdn.meerkatapp.co
- Social graph information including following/followers lists
- channels.meerkatapp.co
- Shows actions on a stream - comments, restreams
- cdn.meerkatapp.co
- Hosts playlists
- static.meerkatapp.co
- Static content like profile/cover images
Retrieving http://resources.meerkatapp.co/broadcasts/asdf shows the following error and we can see what resources are available for broadcasts.
Requesting "GET /asdf" on servlet "/broadcasts" but only have:
* GET /
* GET /:broadcastId/activities
* GET /:broadcastId/summary
* GET /:broadcastId/watchers
* GET /:scheduleId/schedule
A similar example for /users on the same host.
Requesting "GET /asdf" on servlet "/users" but only have:
* GET /:uid/privateProfile
* GET /:uid/profile
* GET /leaderboard
And another example on social.meerkatapp.co/users/xxx/asdf?v=2
Requesting "GET /xxx/asdf" on servlet "/users" but only have:
* DELETE /:uid
* DELETE /:uid/fans
* DELETE /:uid/followers
* GET /:uid/followers
* GET /:uid/following
* GET /:uid/profile
* GET /:uid/sweepSessions
* GET /i-am-alive
* OPTIONS /
* OPTIONS /:uid
* OPTIONS /:uid/followers
* OPTIONS /:uid/following
* OPTIONS /:uid/twitterFriendsSignUp
* OPTIONS /search
* POST /
* POST /:uid/fans
* POST /:uid/followers
* POST /:uid/invites
* POST /:uid/reports
* POST /:uid/socialLinks
* POST /:uid/twitterFriends
* POST /:uid/twitterFriendsSignUp
* PUT /
* PUT /:uid
* PUT /:uid/profile
* PUT /available
* PUT /search
Meerkat just added just added user search. The endpoint is https://social.meerkatapp.co/users/search?v=0.1 and requires a content-type header.
curl 'https://social.meerkatapp.co/users/search?v=2' -X PUT -H 'Content-Type: application/json' -d '{"username":"redbull"}'
{
"result": [
"550099452400006f00a5277f"
]
}
A Meerkat broadcast http://resources.meerkatapp.co/broadcasts/36aab946-661a-47af-a249-5d395659fd2c/summary
Broadcasts are a Meerkat video. They contain various information about the video, including broadcaster, statistics, location and tweet ID.
{
"result": {
"broadcaster": {
"displayName": "Red Bull",
"name": "redbull",
"image": "https://static.meerkatapp.co/users/550099452400006f00a5277f/profile-tmb",
"id": "550099452400006f00a5277f",
"profile": "https://resources.meerkatapp.co/users/550099452400006f00a5277f/profile"
},
"location": "Aspen, United States",
"likesCount": 79,
"coverImages": [
"https://static.meerkatapp.co/broadcasts/36aab946-661a-47af-a249-5d395659fd2c/compressed1"
],
"activities": [
{
"content": "c:2015-03-14T18:31:12.899Z,54f4c98f310000b1016d9745,ryanmabbott,Snow sounds crispy. Chill.",
"profile": "https://static.meerkatapp.co/users/54f4c98f310000b1016d9745/profile"
},
...
],
"commentsCount": 46,
"restreamsCount": 39,
"endTime": 1426359163751,
"watchersCount": 384,
"cover": "https://static.meerkatapp.co/broadcasts/36aab946-661a-47af-a249-5d395659fd2c/cover",
"id": "36aab946-661a-47af-a249-5d395659fd2c",
"fans": [],
"influencers": [
"l:5504814922000022000afb4e",
"l:54eda5683f0000ed01af56e1",
"h:DoublePipe",
...
],
"caption": "Behind the scenes at #DoublePipe doubles jam. Catch the show on @redbulltv",
"status": "ended",
"tweetId": 576812556188151808,
"place": ""
},
"followupActions": {
"playlist": "http://cdn.meerkatapp.co/broadcast/36aab946-661a-47af-a249-5d395659fd2c/live.m3u8",
"encore": "https://social.meerkatapp.co/users/550099452400006f00a5277f/fans?v=2",
"activities": "https://resources.meerkatapp.co/broadcasts/36aab946-661a-47af-a249-5d395659fd2c/activities",
"likes": "https://channels.meerkatapp.co/broadcasts/36aab946-661a-47af-a249-5d395659fd2c/likes",
"delete": "https://channels.meerkatapp.co/broadcasts/36aab946-661a-47af-a249-5d395659fd2c",
"restreams": "https://channels.meerkatapp.co/broadcasts/36aab946-661a-47af-a249-5d395659fd2c/restreams",
"watchers": "https://resources.meerkatapp.co/broadcasts/36aab946-661a-47af-a249-5d395659fd2c/watchers",
"comments": "https://channels.meerkatapp.co/broadcasts/36aab946-661a-47af-a249-5d395659fd2c/comments"
}
}
There's some sort of list of broadcast here, it looks to be a list of broadcasts live now: http://channels.meerkatapp.co/broadcasts/
A Meerkat user profile https://resources.meerkatapp.co/users/550099452400006f00a5277f/profile?v=2
User information including name, list of streams, and various stats. Included also is a score of some sort.
One thing to note is that most endTime's are in milliseconds since epoch,
with the exception of scheduled broadcasts. In those cases, they are seconds.
{
"result": {
"info": {
"id": "550099452400006f00a5277f",
"username": "redbull",
"displayName": "Red Bull",
"twitterId": "17540485",
"privacy": "public",
"bio": "#givesyouwings"
},
"stats": {
"streams": [
{
"id": "60dce137-5c49-4040-b650-6460df235bf7",
"endTime": 1426104542049
},
{
"id": "36aab946-661a-47af-a249-5d395659fd2c",
"endTime": 1426359163751
}
],
"streamsCount": 2,
"followingCount": 903,
"followersCount": 3831,
"score": 1680
}
},
"followupActions": {
"profileThumbImage": "https://static.meerkatapp.co/users/550099452400006f00a5277f/profile-tmb",
"profileImage": "https://static.meerkatapp.co/users/550099452400006f00a5277f/profile",
"followers": "https://social-cdn.meerkatapp.co/users/550099452400006f00a5277f/followers?v=2",
"following": "https://social-cdn.meerkatapp.co/users/550099452400006f00a5277f/following?v=2",
"report": "https://social.meerkatapp.co/users/550099452400006f00a5277f/reports?v=2",
"follow": "https://social.meerkatapp.co/users/550099452400006f00a5277f/followers?v=2"
}
}