GET v1.1/channels

Search for channels on the account(s) this token belongs to. By default returns just the channel ID and the channel details URL, but different fields may be selected if required. this resource supports additional data through the fields parameter

Parameters

Label	Description	Values	Modifiers	Type	Required
name	The name of a channel to access	a channel "name"	none	query string	false
fields	Return additional data about this resouce e.g v1.1/channels?fields=url,name,id,created	created, name, url, is_active, id, small_image, reports, fans, account, fb_page_url, type	none	query string	false
type	Return channels by type	twitter, facebook, instagram, youtube etc	none	query string	false

GET v1.1/channels/:id

Information about one channel. Includes links to the account that the channel is part of, and a link to the reports generated on the channel data. this resource supports additional data through the fields parameter

Parameters

Label	Description	Values	Modifiers	Type	Required
fields	Return additional data about this resouce e.g v1.1/channels?fields=url,name,id,created	created, name, url, is_active, id, small_image, reports, fans, account, fb_page_url, type	none	query string	false

Examples

Basic example

> curl -u username:password "https://api.conversocial.com/v1.1/channels"
{
  "channels": [
    {
      "url": "https://api.conversocial.com/v1.1/channels/65481",
      "id": "65481"
    },
    {
      "url": "https://api.conversocial.com/v1.1/channels/65483",
      "id": "65483"
    },
    {
      "url": "https://api.conversocial.com/v1.1/channels/65484",
      "id": "65484"
    }
  ]
}

Example with additional fields

> curl -u username:password "https://api.conversocial.com/v1.1/channels?fields=name,created,url,is_active"
{
  "channels": [
    {
      "url": "https://api.conversocial.com/v1.1/channels/65481",
      "id": "65481",
      "is_active": false,
      "name": "@ConverTesting",
      "created": "2014-01-22T11:07:16"
    },
    {
      "url": "https://api.conversocial.com/v1.1/channels/65483",
      "id": "65483",
      "is_active": false,
      "name": "Blogger (Dutch)",
      "created": "2014-01-22T11:26:45"
    }
  ]
}

Example single resource

> curl -u username:password "https://api.conversocial.com/v1.1/channels/65483"
{
  "channel": {
    "account": {
      "url": "https://api.conversocial.com/v1.1/accounts/14047",
      "id": 14047
    },
    "name": "@ConverTesting",
    "created": "2014-01-22T11:07:16",
    "url": "https://api.conversocial.com/v1.1/channels/65481",
    "is_active": false,
    "small_image": "https://pbs.twimg.com/profile_images/378800000152754498/696742d170d741d23de79a324c726036_normal.png",
    "reports": "https://api.conversocial.com/v1.1/reports?channel=65481",
    "fans": "20",
    "fb_page_url": null,
    "type": "twitter",
    "id": "65481"
  }
}