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
    }
}