Get users by tag
Show all users with specific tag
GET
/tags/:id/users/
Parameters
Type
Description
id
integer
ID of the tag
curl -X GET -H "Authorization: Token <your_64_char_api_key>" "https://<your_app_subdomain>.user.com/api/public/tags/:id/users/"
Example response
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"email": "example@email.com",
"last_ip": null,
"lists": [],
"google_url": null,
"created_at": "2017-05-29T10:08:59.526286Z",
"first_seen": null,
"last_seen": null,
"attributes": [
{
"name": "Awesome attribute",
"id": 2092,
"name_std": "awesome_attribute",
"value": "Value for the attribute"
}
],
"region": null,
"last_contacted": null,
"notifications": true,
"page_views": 0,
"country": null,
"gender": "unknown",
"timezone": null,
"os_type": null,
"unsubscribed": true,
"gravatar_url": null,
"key": "rQ8mdQ8W6I5t",
"id": 18260675,
"phone_number": null,
"chat_id": "Chat ID is deprecated and will be removed in future",
"facebook_url": null,
"city": null,
"status": "visitor",
"browser_language": null,
"twitter_url": null,
"linkedin_url": null,
"browser": null,
"score": 0,
"name": "John Doe",
"tags": [
{
"name": "My tag",
"id": 31,
}
],
"resolution": null,
"updated_at": "2017-05-29T10:08:59.526309Z"
},
"companies": [
{
"id": 14,
"name": "Company name",
"member_since": "2018-06-14T08:49:56.515083Z"
}
],
{
"email": "example@email.org",
"last_ip": null,
"lists": [],
"google_url": null,
"created_at": "2017-06-13T12:22:38.748373Z",
"first_seen": null,
"last_seen": null,
"attributes": [],
"region": null,
"last_contacted": null,
"notifications": true,
"page_views": 0,
"country": null,
"gender": "unknown",
"timezone": null,
"os_type": null,
"unsubscribed": false,
"gravatar_url": null,
"key": "xSoYQG00fg9z",
"id": 20901703,
"phone_number": null,
"chat_id": "Chat ID is deprecated and will be removed in future",
"facebook_url": null,
"city": null,
"status": "visitor",
"browser_language": null,
"twitter_url": null,
"linkedin_url": null,
"browser": null,
"score": 0,
"name": "Jane Doe",
"tags": [
{
"name": "My tag",
"id": 31,
}
],
"resolution": null,
"updated_at": "2017-06-13T12:51:30.924647Z"
}
]
}
var settings = {
"async": true,
"crossDomain": true,
"url": "https://<your_app_subdomain>.user.com/api/public/tags/:id/users/",
"method": "GET",
"headers": {
"authorization": "Token <your_64_char_api_key>"
}
}
$.ajax(settings).done(function (response) {
console.log(response);
});
var data = null;
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("GET", "https://<your_app_subdomain>.user.com/api/public/tags/:id/users/");
xhr.setRequestHeader("authorization", "Token <your_64_char_api_key>");
xhr.send(data);
var request = require("request");
var options = { method: 'GET',
url: 'https://<your_app_subdomain>.user.com/api/public/tags/:id/users/',
headers: { authorization: 'Token <your_64_char_api_key>' } };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://<your_app_subdomain>.user.com/api/public/tags/:id/users/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_POSTFIELDS => "",
CURLOPT_HTTPHEADER => array(
"authorization: Token <your_64_char_api_key>"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
import requests
url = "https://<your_app_subdomain>.user.com/api/public/tags/:id/users/"
payload = ""
headers = {'authorization': 'Token <your_64_char_api_key>'}
response = requests.request("GET", url, data=payload, headers=headers)
print(response.text)
import http.client
conn = http.client.HTTPSConnection("<your_app_subdomain>.user.com")
payload = ""
headers = { 'authorization': "Token <your_64_char_api_key>" }
conn.request("GET", "/api/public/tags/:id/users/", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))