GET :version/tags

Returns a list of tag objects by created date

A request requires a date range that can be supplied by using created_date_from and created_date_to.

Query parameters

Name	Description	Values	Required
created_date_from	Tags that were created on and after this date	ISO datetime	True
created_date_to	Tags that were created before this date	ISO datetime	True
page_size	Number of results to return	integer	False

Tags created between 4th May and the 5th of May

"https://ca-eu.conversocial.com/api/1/tags?created_date_from=2016-05-04&created_date_to=2016-05-05"

{
  "tags": [
    {
      "action": "add_tag",
      "author": {
        "author_ids": [
          "t:2825986021"
        ],
        "customer_profiles_id": "564b5d829bd56c14074805f0"
      },
      "created_date": "2016-05-05T16:10:51.834000",
      "id": "564b5d709bd56c14074805ea",
      "name": "Trouble maker",
      "user": 16
    }
  ],
  "paging": {
    "next_page": null
  }
}

Tags created on the 1st of March

"https://ca-eu.conversocial.com/api/1/tags?created_date_from=2016-03-01&created_date_to=2016-03-01"

Tags created on the 1st of March, returning only 10 results

"https://ca-eu.conversocial.com/api/1/tags?created_date_from=2016-03-01&created_date_to=2016-03-01&page_size=10"

Examples

# python
import requests

base_url = "https://ca-eu.conversocial.com/api"

response = requests.get(
    "https://ca-eu.conversocial.com/api/1/tags?created_date_from=2016-03-01T14:00:00&created_date_to=2016-03-01T18:00:00",
    auth=("iamausername":"iamapassword"))

print response.status_code
> 200

# bash
curl -u "iamausername:iamapassword"
"https://ca-eu.conversocial.com/api/1/tags?created_date_from=2016-03-01T14:00:00&created_date_to=2016-03-01T18:00:00"