Competitor Monitoring
Set Competitor Team Titles
Replace the job titles the competitor team search looks for
PUT
/
competitor-team-titles
curl -X PUT https://api.clustr-ai.com/api/public/competitor-team-titles \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"titles": [
{ "title": "account executive", "function": "sales", "enabled": true },
{ "title": "customer success manager", "function": "cs", "enabled": true },
{ "title": "solutions engineer", "function": "sales", "enabled": true }
]
}'
import requests
requests.put(
"https://api.clustr-ai.com/api/public/competitor-team-titles",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"titles": [
{"title": "account executive", "function": "sales", "enabled": True},
{"title": "customer success manager", "function": "cs", "enabled": True},
{"title": "solutions engineer", "function": "sales", "enabled": True},
]
},
)
await fetch("https://api.clustr-ai.com/api/public/competitor-team-titles", {
method: "PUT",
headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({
titles: [
{ title: "account executive", function: "sales", enabled: true },
{ title: "customer success manager", function: "cs", enabled: true },
{ title: "solutions engineer", function: "sales", enabled: true },
],
}),
});
{
"success": true,
"data": {
"titles": [
{ "title": "account executive", "function": "sales", "group": "sales", "enabled": true },
{ "title": "customer success manager", "function": "cs", "group": "cs", "enabled": true },
{ "title": "solutions engineer", "function": "sales", "group": "customer_facing", "enabled": true }
],
"is_default": false
}
}
Replace your workspace’s title list. Send the whole list: a title you leave out is dropped. To
switch a title off without losing it, send it with
enabled: false.
People already tracked stay as they are. The new list applies from the next team search, where the
new matches are followed automatically while you have free slots. Read the current list with
Get Competitor Team Titles.
curl -X PUT https://api.clustr-ai.com/api/public/competitor-team-titles \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"titles": [
{ "title": "account executive", "function": "sales", "enabled": true },
{ "title": "customer success manager", "function": "cs", "enabled": true },
{ "title": "solutions engineer", "function": "sales", "enabled": true }
]
}'
import requests
requests.put(
"https://api.clustr-ai.com/api/public/competitor-team-titles",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"titles": [
{"title": "account executive", "function": "sales", "enabled": True},
{"title": "customer success manager", "function": "cs", "enabled": True},
{"title": "solutions engineer", "function": "sales", "enabled": True},
]
},
)
await fetch("https://api.clustr-ai.com/api/public/competitor-team-titles", {
method: "PUT",
headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({
titles: [
{ title: "account executive", function: "sales", enabled: true },
{ title: "customer success manager", function: "cs", enabled: true },
{ title: "solutions engineer", function: "sales", enabled: true },
],
}),
});
{
"success": true,
"data": {
"titles": [
{ "title": "account executive", "function": "sales", "group": "sales", "enabled": true },
{ "title": "customer success manager", "function": "cs", "group": "cs", "enabled": true },
{ "title": "solutions engineer", "function": "sales", "group": "customer_facing", "enabled": true }
],
"is_default": false
}
}
Authorizations
The API key you created on the API settings page of the Clustr app.
Body
application/json
The titles, from 1 to 300.
Required array length:
1 - 300 elementsShow child attributes
Show child attributes
⌘I
curl -X PUT https://api.clustr-ai.com/api/public/competitor-team-titles \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"titles": [
{ "title": "account executive", "function": "sales", "enabled": true },
{ "title": "customer success manager", "function": "cs", "enabled": true },
{ "title": "solutions engineer", "function": "sales", "enabled": true }
]
}'
import requests
requests.put(
"https://api.clustr-ai.com/api/public/competitor-team-titles",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"titles": [
{"title": "account executive", "function": "sales", "enabled": True},
{"title": "customer success manager", "function": "cs", "enabled": True},
{"title": "solutions engineer", "function": "sales", "enabled": True},
]
},
)
await fetch("https://api.clustr-ai.com/api/public/competitor-team-titles", {
method: "PUT",
headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({
titles: [
{ title: "account executive", function: "sales", enabled: true },
{ title: "customer success manager", function: "cs", enabled: true },
{ title: "solutions engineer", function: "sales", enabled: true },
],
}),
});
{
"success": true,
"data": {
"titles": [
{ "title": "account executive", "function": "sales", "group": "sales", "enabled": true },
{ "title": "customer success manager", "function": "cs", "group": "cs", "enabled": true },
{ "title": "solutions engineer", "function": "sales", "group": "customer_facing", "enabled": true }
],
"is_default": false
}
}