GET v1.3/tags
Lists all of the tags created on this account. this resource supports additional data through the fields parameter
Parameters
Label | Description | Values | Modifiers | Type | Required |
---|---|---|---|---|---|
is_active | Filter tags on whether they are active or not e.g v1.3/tags?is_active=true |
true or false | None | Query string | False |
fields | Return additional data about this resouce e.g v1.3/tags?fields=id,name,url,is_active |
id, name, url, is_active | None | Query string | false |
GET v1.3/tags/:id
Information about one tag. this resource supports additional data through the fields parameter
Parameters
Label | Description | Values | Modifiers | Type | Required |
---|---|---|---|---|---|
id | The unique id of a tag e.g v1.3/tags/2 |
A Tag "id" | None | URL | True |
fields | Return additional data about the accounts resouce e.g v1.3/tags/2?fields=id,name,url,is_active |
id, name, url, is_active | None | Query string | False |
Examples
Basic example
> curl -u username:password "https://api.conversocial.com/v1.3/tags"
{
"tags": [
{
"id": "2",
"url": "https://api.conversocial.com/v1.3/tags/2",
},
...
]
"paging": { ... }
}
Example with additional fields
> curl -u username:password "https://api.conversocial.com/v1.3/tags?fields=name,is_active"
{
"tags": [
{
"id": "2",
"url": "https://api.conversocial.com/v1.3/tags/3",
"name": "Antag",
"is_active": false
},
...
]
"paging": { ... }
}
A Tag resource
> curl -u username:password "https://api.conversocial.com/v1.3/tags/2?fields=name,id"
{
"tag": {
"id": "2",
"url": "https://api.conversocial.com/v1.3/tags/2",
"name": "Complaint",
"is_active": true
}
}