Workspace Endpoints
Workspaces
Retrieves information about the available workspaces for a specific authentication token.
GET
GET /api/v1/workspaces
Example response
$ curl https://trackmavens.com/api/v1/workspaces/
[
{
"id": 1,
"name": "Development Workspace",
"permissions": {
"ads": true,
"blogs": true,
"brandLimit": null,
"emails": true,
"facebook": true,
"googleplus": true,
"instagram": true,
"linkedin": true,
"news": true,
"pinterest": true,
"search": true,
"traffic": true,
"tumblr": true,
"twitter": true,
"youtube": true
}
}
]
Brands
The list of brands belonging to a workspace.
GET
GET /api/v1/workspaces/{workspace_id}/brands/
Required URL parameters
Example response
$ curl https://trackmavens.com/api/v1/workspaces/1/brands/
[
{
"twitter": {
"retry": false,
"user_id": "",
"name": "",
"description": "",
"error_message": "",
"profile_image_url": "",
"protected": false,
"followers": 0,
"error": false,
"verified": true,
"error_code": "",
"id": 1,
"screen_name": ""
},
"facebook": {
"username": "",
"category": "",
"picture": "",
"is_regional": false,
"name": "",
"phone": null,
"checkins": 0,
"description": "",
"website": "",
"talking_about": 2353977,
"link": "",
"likes": 3402633,
"page_id": "",
"id": 1,
"is_published": true
},
"youtube": {
"username": "",
"retry": false,
"verified": false,
"description": "",
"title": "",
"error_message": "",
"playlist_uploads_id": "",
"channel_id": "",
"thumbnail_url": "",
"subscribers": 2751692,
"error": false,
"id": 1,
"google_plus_user_id": ""
},
"website": {
"domain_url": "",
"id": 1,
"screenshot": ""
},
"blog": {
"id": 1,
"etag": null,
"last_modified": null,
"blog_url": "",
"blog_rss_url": ""
},
"email_entities": [],
"image": "",
"screenshot": "",
"instagram": null,
"linkedin": null,
"pinterest": {
"username": "",
"about": "",
"title": "",
"url": "",
"users_followed": 474,
"followers": 184937,
"pin_count": 21520,
"id": 1,
"board_count": 89
},
"googleplus": null,
"tumblr": null,
"tag": null,
"id": 1,
"modified": "2014-08-13T20:30:29.643Z",
"description": "",
"description_source": "",
"newsentity": null,
"name": "",
"processed": false,
"workspace": 1,
"is_workspace_company": true
},
{
"twitter": {
"retry": false,
"user_id": "",
"name": "",
"description": "",
"error_message": "",
"profile_image_url": "",
"protected": false,
"followers": 0,
"error": false,
"verified": true,
"error_code": "",
"id": 2,
"screen_name": ""
},
"facebook": {
"username": "",
"category": "",
"picture": "",
"is_regional": false,
"name": "Target",
"phone": null,
"checkins": 5,
"description": "",
"website": "",
"talking_about": 45448,
"link": "",
"likes": 23064331,
"page_id": "",
"id": 2,
"is_published": true
},
"youtube": {
"username": "",
"retry": false,
"verified": false,
"description": "",
"title": "",
"error_message": "",
"playlist_uploads_id": "",
"channel_id": "",
"thumbnail_url": "",
"subscribers": 30447,
"error": false,
"id": 2,
"google_plus_user_id": ""
},
"website": {
"domain_url": "",
"id": 2,
"screenshot": ""
},
"blog": {
"id": 2,
"etag": "\"53f4e8c7-3a26\"",
"last_modified": "2014-08-20T18:28:23Z",
"blog_url": "",
"blog_rss_url": ""
},
"email_entities": [],
"image": "",
"screenshot": "",
"instagram": null,
"linkedin": null,
"pinterest": {
"username": "",
"about": "",
"title": "",
"url": "",
"users_followed": 1252,
"followers": 197369,
"pin_count": 28681,
"id": 2,
"board_count": 87
},
"googleplus": null,
"tumblr": null,
"tag": null,
"id": 2,
"modified": "2014-08-13T20:18:31.339Z",
"description": null,
"description_source": null,
"newsentity": null,
"name": "",
"processed": true,
"workspace": 1,
"is_workspace_company": false
}
]
Brand
Retrieve information about a specific brand.
GET
GET /api/v1/workspaces/{workspace_id}/brands/{brand_id}/
Required URL parameters
Example response
$ curl https://trackmavens.com/api/v1/workspaces/1/brands/1/
{
"twitter": {
"retry": false,
"user_id": "",
"name": "",
"description": "",
"error_message": "",
"profile_image_url": "",
"protected": false,
"followers": 0,
"error": false,
"verified": true,
"error_code": "",
"id": 1,
"screen_name": ""
},
"facebook": {
"username": "",
"category": "",
"picture": "",
"is_regional": false,
"name": "",
"phone": null,
"checkins": 0,
"description": "",
"website": "",
"talking_about": 2353977,
"link": "",
"likes": 3402633,
"page_id": "",
"id": 1,
"is_published": true
},
"youtube": {
"username": "",
"retry": false,
"verified": false,
"description": "",
"title": "",
"error_message": "",
"playlist_uploads_id": "",
"channel_id": "",
"thumbnail_url": "",
"subscribers": 2751692,
"error": false,
"id": 1,
"google_plus_user_id": ""
},
"website": {
"domain_url": "",
"id": 1,
"screenshot": ""
},
"blog": {
"id": 1,
"etag": null,
"last_modified": null,
"blog_url": "",
"blog_rss_url": ""
},
"email_entities": [],
"image": "",
"screenshot": "",
"instagram": null,
"linkedin": null,
"pinterest": {
"username": "",
"about": "",
"title": "",
"url": "",
"users_followed": 474,
"followers": 184937,
"pin_count": 21520,
"id": 1,
"board_count": 89
},
"googleplus": null,
"tumblr": null,
"tag": {
"name": "News",
"workspace": 1,
"id": 1
},
"master": {
"website": 1,
"blog": 1,
"description": "",
"pinterest": 1,
"email_entities": [],
"youtube": 1,
"twitter": 1,
"googleplus": null,
"description_source": "",
"modified": "2014-09-23T15:17:20.832Z",
"linkedin": null,
"name": "",
"tumblr": null,
"facebook": 1,
"newsentity": null,
"id": 1,
"instagram": null
},
"id": 1,
"modified": "2014-09-23T15:17:21.094Z",
"description": "",
"description_source": "",
"newsentity": null,
"name": "Buzzfeed",
"processed": false,
"workspace": 1,
"is_workspace_company": true
}
Groups
The list of groups belonging to a workspace.
GET
GET /api/v1/workspaces/{workspace_id}/groups/
Required URL parameters
Example response
$ curl https://trackmavens.com/api/v1/workspaces/1/groups/
[
{
"name": "Shopping",
"id": 2
},
{
"name": "News",
"id": 1
}
]
Group
Retrieve information about a specific group.
GET
GET /api/v1/workspaces/{workspace_id}/groups/{group_id}/
Required URL parameters
Example response
$ curl https://trackmavens.com/api/v1/workspaces/1/groups/1/
{
"name": "News",
"id": 1
}