curl --request POST \
--url https://api.mentionlab.io/api/analytics/tags/models \
--header 'Content-Type: application/json' \
--header 'x-project-id: <x-project-id>' \
--data '
{
"tagType": "execution",
"startDate": "2025-01-01",
"endDate": "2025-01-31",
"countries": [
"BE",
"FR"
],
"languages": [
"en",
"fr"
],
"models": [
"gpt-4o",
"claude-3-5-sonnet"
],
"queryIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"queryTagIds": [
"42"
],
"execTagIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"queryTagGroupIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"execTagGroupIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"queryTypes": [],
"timezone": "UTC",
"groupByEntityGroup": false,
"showAllEntities": false,
"entityIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"tagIds": [
"pricing",
"features"
],
"limit": 5,
"offset": 0
}
'import requests
url = "https://api.mentionlab.io/api/analytics/tags/models"
payload = {
"tagType": "execution",
"startDate": "2025-01-01",
"endDate": "2025-01-31",
"countries": ["BE", "FR"],
"languages": ["en", "fr"],
"models": ["gpt-4o", "claude-3-5-sonnet"],
"queryIds": ["3fa85f64-5717-4562-b3fc-2c963f66afa6"],
"queryTagIds": ["42"],
"execTagIds": ["3fa85f64-5717-4562-b3fc-2c963f66afa6"],
"queryTagGroupIds": ["3fa85f64-5717-4562-b3fc-2c963f66afa6"],
"execTagGroupIds": ["3fa85f64-5717-4562-b3fc-2c963f66afa6"],
"queryTypes": [],
"timezone": "UTC",
"groupByEntityGroup": False,
"showAllEntities": False,
"entityIds": ["3fa85f64-5717-4562-b3fc-2c963f66afa6"],
"tagIds": ["pricing", "features"],
"limit": 5,
"offset": 0
}
headers = {
"x-project-id": "<x-project-id>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-project-id': '<x-project-id>', 'Content-Type': 'application/json'},
body: JSON.stringify({
tagType: 'execution',
startDate: '2025-01-01',
endDate: '2025-01-31',
countries: ['BE', 'FR'],
languages: ['en', 'fr'],
models: ['gpt-4o', 'claude-3-5-sonnet'],
queryIds: ['3fa85f64-5717-4562-b3fc-2c963f66afa6'],
queryTagIds: ['42'],
execTagIds: ['3fa85f64-5717-4562-b3fc-2c963f66afa6'],
queryTagGroupIds: ['3fa85f64-5717-4562-b3fc-2c963f66afa6'],
execTagGroupIds: ['3fa85f64-5717-4562-b3fc-2c963f66afa6'],
queryTypes: [],
timezone: 'UTC',
groupByEntityGroup: false,
showAllEntities: false,
entityIds: ['3fa85f64-5717-4562-b3fc-2c963f66afa6'],
tagIds: ['pricing', 'features'],
limit: 5,
offset: 0
})
};
fetch('https://api.mentionlab.io/api/analytics/tags/models', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mentionlab.io/api/analytics/tags/models",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tagType' => 'execution',
'startDate' => '2025-01-01',
'endDate' => '2025-01-31',
'countries' => [
'BE',
'FR'
],
'languages' => [
'en',
'fr'
],
'models' => [
'gpt-4o',
'claude-3-5-sonnet'
],
'queryIds' => [
'3fa85f64-5717-4562-b3fc-2c963f66afa6'
],
'queryTagIds' => [
'42'
],
'execTagIds' => [
'3fa85f64-5717-4562-b3fc-2c963f66afa6'
],
'queryTagGroupIds' => [
'3fa85f64-5717-4562-b3fc-2c963f66afa6'
],
'execTagGroupIds' => [
'3fa85f64-5717-4562-b3fc-2c963f66afa6'
],
'queryTypes' => [
],
'timezone' => 'UTC',
'groupByEntityGroup' => false,
'showAllEntities' => false,
'entityIds' => [
'3fa85f64-5717-4562-b3fc-2c963f66afa6'
],
'tagIds' => [
'pricing',
'features'
],
'limit' => 5,
'offset' => 0
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-project-id: <x-project-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.mentionlab.io/api/analytics/tags/models"
payload := strings.NewReader("{\n \"tagType\": \"execution\",\n \"startDate\": \"2025-01-01\",\n \"endDate\": \"2025-01-31\",\n \"countries\": [\n \"BE\",\n \"FR\"\n ],\n \"languages\": [\n \"en\",\n \"fr\"\n ],\n \"models\": [\n \"gpt-4o\",\n \"claude-3-5-sonnet\"\n ],\n \"queryIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTagIds\": [\n \"42\"\n ],\n \"execTagIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTagGroupIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"execTagGroupIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTypes\": [],\n \"timezone\": \"UTC\",\n \"groupByEntityGroup\": false,\n \"showAllEntities\": false,\n \"entityIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"tagIds\": [\n \"pricing\",\n \"features\"\n ],\n \"limit\": 5,\n \"offset\": 0\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-project-id", "<x-project-id>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.mentionlab.io/api/analytics/tags/models")
.header("x-project-id", "<x-project-id>")
.header("Content-Type", "application/json")
.body("{\n \"tagType\": \"execution\",\n \"startDate\": \"2025-01-01\",\n \"endDate\": \"2025-01-31\",\n \"countries\": [\n \"BE\",\n \"FR\"\n ],\n \"languages\": [\n \"en\",\n \"fr\"\n ],\n \"models\": [\n \"gpt-4o\",\n \"claude-3-5-sonnet\"\n ],\n \"queryIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTagIds\": [\n \"42\"\n ],\n \"execTagIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTagGroupIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"execTagGroupIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTypes\": [],\n \"timezone\": \"UTC\",\n \"groupByEntityGroup\": false,\n \"showAllEntities\": false,\n \"entityIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"tagIds\": [\n \"pricing\",\n \"features\"\n ],\n \"limit\": 5,\n \"offset\": 0\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mentionlab.io/api/analytics/tags/models")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-project-id"] = '<x-project-id>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tagType\": \"execution\",\n \"startDate\": \"2025-01-01\",\n \"endDate\": \"2025-01-31\",\n \"countries\": [\n \"BE\",\n \"FR\"\n ],\n \"languages\": [\n \"en\",\n \"fr\"\n ],\n \"models\": [\n \"gpt-4o\",\n \"claude-3-5-sonnet\"\n ],\n \"queryIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTagIds\": [\n \"42\"\n ],\n \"execTagIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTagGroupIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"execTagGroupIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTypes\": [],\n \"timezone\": \"UTC\",\n \"groupByEntityGroup\": false,\n \"showAllEntities\": false,\n \"entityIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"tagIds\": [\n \"pricing\",\n \"features\"\n ],\n \"limit\": 5,\n \"offset\": 0\n}"
response = http.request(request)
puts response.read_body{
"total": 27,
"tags": [
{
"tagId": "550e8400-e29b-41d4-a716-446655440000",
"tagName": "Week 1",
"tagColor": "#4f46e5",
"resultCount": 340,
"visibility": 40,
"models": [
{
"model": "gpt-5-mini",
"resultCount": 120,
"visibility": 42.5
}
]
}
]
}{
"statusCode": 400,
"message": "Validation failed",
"error": "Bad Request"
}{
"statusCode": 400,
"message": "Validation failed",
"error": "Bad Request"
}{
"statusCode": 400,
"message": "Validation failed",
"error": "Bad Request"
}Get per-tag brand visibility broken down by model
Returns a paginated list of tags ranked by project brand visibility, each with a per-model visibility breakdown; narrow to specific tags with tagIds.
curl --request POST \
--url https://api.mentionlab.io/api/analytics/tags/models \
--header 'Content-Type: application/json' \
--header 'x-project-id: <x-project-id>' \
--data '
{
"tagType": "execution",
"startDate": "2025-01-01",
"endDate": "2025-01-31",
"countries": [
"BE",
"FR"
],
"languages": [
"en",
"fr"
],
"models": [
"gpt-4o",
"claude-3-5-sonnet"
],
"queryIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"queryTagIds": [
"42"
],
"execTagIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"queryTagGroupIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"execTagGroupIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"queryTypes": [],
"timezone": "UTC",
"groupByEntityGroup": false,
"showAllEntities": false,
"entityIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"tagIds": [
"pricing",
"features"
],
"limit": 5,
"offset": 0
}
'import requests
url = "https://api.mentionlab.io/api/analytics/tags/models"
payload = {
"tagType": "execution",
"startDate": "2025-01-01",
"endDate": "2025-01-31",
"countries": ["BE", "FR"],
"languages": ["en", "fr"],
"models": ["gpt-4o", "claude-3-5-sonnet"],
"queryIds": ["3fa85f64-5717-4562-b3fc-2c963f66afa6"],
"queryTagIds": ["42"],
"execTagIds": ["3fa85f64-5717-4562-b3fc-2c963f66afa6"],
"queryTagGroupIds": ["3fa85f64-5717-4562-b3fc-2c963f66afa6"],
"execTagGroupIds": ["3fa85f64-5717-4562-b3fc-2c963f66afa6"],
"queryTypes": [],
"timezone": "UTC",
"groupByEntityGroup": False,
"showAllEntities": False,
"entityIds": ["3fa85f64-5717-4562-b3fc-2c963f66afa6"],
"tagIds": ["pricing", "features"],
"limit": 5,
"offset": 0
}
headers = {
"x-project-id": "<x-project-id>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-project-id': '<x-project-id>', 'Content-Type': 'application/json'},
body: JSON.stringify({
tagType: 'execution',
startDate: '2025-01-01',
endDate: '2025-01-31',
countries: ['BE', 'FR'],
languages: ['en', 'fr'],
models: ['gpt-4o', 'claude-3-5-sonnet'],
queryIds: ['3fa85f64-5717-4562-b3fc-2c963f66afa6'],
queryTagIds: ['42'],
execTagIds: ['3fa85f64-5717-4562-b3fc-2c963f66afa6'],
queryTagGroupIds: ['3fa85f64-5717-4562-b3fc-2c963f66afa6'],
execTagGroupIds: ['3fa85f64-5717-4562-b3fc-2c963f66afa6'],
queryTypes: [],
timezone: 'UTC',
groupByEntityGroup: false,
showAllEntities: false,
entityIds: ['3fa85f64-5717-4562-b3fc-2c963f66afa6'],
tagIds: ['pricing', 'features'],
limit: 5,
offset: 0
})
};
fetch('https://api.mentionlab.io/api/analytics/tags/models', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mentionlab.io/api/analytics/tags/models",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tagType' => 'execution',
'startDate' => '2025-01-01',
'endDate' => '2025-01-31',
'countries' => [
'BE',
'FR'
],
'languages' => [
'en',
'fr'
],
'models' => [
'gpt-4o',
'claude-3-5-sonnet'
],
'queryIds' => [
'3fa85f64-5717-4562-b3fc-2c963f66afa6'
],
'queryTagIds' => [
'42'
],
'execTagIds' => [
'3fa85f64-5717-4562-b3fc-2c963f66afa6'
],
'queryTagGroupIds' => [
'3fa85f64-5717-4562-b3fc-2c963f66afa6'
],
'execTagGroupIds' => [
'3fa85f64-5717-4562-b3fc-2c963f66afa6'
],
'queryTypes' => [
],
'timezone' => 'UTC',
'groupByEntityGroup' => false,
'showAllEntities' => false,
'entityIds' => [
'3fa85f64-5717-4562-b3fc-2c963f66afa6'
],
'tagIds' => [
'pricing',
'features'
],
'limit' => 5,
'offset' => 0
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-project-id: <x-project-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.mentionlab.io/api/analytics/tags/models"
payload := strings.NewReader("{\n \"tagType\": \"execution\",\n \"startDate\": \"2025-01-01\",\n \"endDate\": \"2025-01-31\",\n \"countries\": [\n \"BE\",\n \"FR\"\n ],\n \"languages\": [\n \"en\",\n \"fr\"\n ],\n \"models\": [\n \"gpt-4o\",\n \"claude-3-5-sonnet\"\n ],\n \"queryIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTagIds\": [\n \"42\"\n ],\n \"execTagIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTagGroupIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"execTagGroupIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTypes\": [],\n \"timezone\": \"UTC\",\n \"groupByEntityGroup\": false,\n \"showAllEntities\": false,\n \"entityIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"tagIds\": [\n \"pricing\",\n \"features\"\n ],\n \"limit\": 5,\n \"offset\": 0\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-project-id", "<x-project-id>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.mentionlab.io/api/analytics/tags/models")
.header("x-project-id", "<x-project-id>")
.header("Content-Type", "application/json")
.body("{\n \"tagType\": \"execution\",\n \"startDate\": \"2025-01-01\",\n \"endDate\": \"2025-01-31\",\n \"countries\": [\n \"BE\",\n \"FR\"\n ],\n \"languages\": [\n \"en\",\n \"fr\"\n ],\n \"models\": [\n \"gpt-4o\",\n \"claude-3-5-sonnet\"\n ],\n \"queryIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTagIds\": [\n \"42\"\n ],\n \"execTagIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTagGroupIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"execTagGroupIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTypes\": [],\n \"timezone\": \"UTC\",\n \"groupByEntityGroup\": false,\n \"showAllEntities\": false,\n \"entityIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"tagIds\": [\n \"pricing\",\n \"features\"\n ],\n \"limit\": 5,\n \"offset\": 0\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mentionlab.io/api/analytics/tags/models")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-project-id"] = '<x-project-id>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tagType\": \"execution\",\n \"startDate\": \"2025-01-01\",\n \"endDate\": \"2025-01-31\",\n \"countries\": [\n \"BE\",\n \"FR\"\n ],\n \"languages\": [\n \"en\",\n \"fr\"\n ],\n \"models\": [\n \"gpt-4o\",\n \"claude-3-5-sonnet\"\n ],\n \"queryIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTagIds\": [\n \"42\"\n ],\n \"execTagIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTagGroupIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"execTagGroupIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"queryTypes\": [],\n \"timezone\": \"UTC\",\n \"groupByEntityGroup\": false,\n \"showAllEntities\": false,\n \"entityIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"tagIds\": [\n \"pricing\",\n \"features\"\n ],\n \"limit\": 5,\n \"offset\": 0\n}"
response = http.request(request)
puts response.read_body{
"total": 27,
"tags": [
{
"tagId": "550e8400-e29b-41d4-a716-446655440000",
"tagName": "Week 1",
"tagColor": "#4f46e5",
"resultCount": 340,
"visibility": 40,
"models": [
{
"model": "gpt-5-mini",
"resultCount": 120,
"visibility": 42.5
}
]
}
]
}{
"statusCode": 400,
"message": "Validation failed",
"error": "Bad Request"
}{
"statusCode": 400,
"message": "Validation failed",
"error": "Bad Request"
}{
"statusCode": 400,
"message": "Validation failed",
"error": "Bad Request"
}Headers
Project ID to specify the project context
Body
Which tag system to break down by model (query tags or response/execution tags)
query, execution "execution"
Start date (inclusive)
"2025-01-01"
End date (inclusive)
"2025-01-31"
Filter by country codes
["BE", "FR"]
Filter by language codes
["en", "fr"]
Filter by AI models
["gpt-4o", "claude-3-5-sonnet"]
Filter by query IDs
["3fa85f64-5717-4562-b3fc-2c963f66afa6"]
Filter by source presence: "sources" (only with sources), "no_sources" (only without), "all" (no filter). Legacy true/false values are still accepted.
all, sources, no_sources Filter by shopping presence: "shopping" (only with shopping), "no_shopping" (only without), "all" (no filter). Legacy true/false values are still accepted.
all, shopping, no_shopping Filter by sponsored-ad presence: "ads" (only with ads), "no_ads" (only without), "all" (no filter). Legacy true/false values are still accepted.
all, ads, no_ads Filter by query tag IDs (numeric — bigint column)
["42"]
Filter by execution tag IDs
["3fa85f64-5717-4562-b3fc-2c963f66afa6"]
Filter by query tag group IDs — matches rows carrying any tag filed under a selected group. Combines with queryTagIds per queryTagMode.
["3fa85f64-5717-4562-b3fc-2c963f66afa6"]
Filter by execution tag group IDs — matches rows carrying any tag filed under a selected group. Combines with execTagIds per execTagMode.
["3fa85f64-5717-4562-b3fc-2c963f66afa6"]
Filter by query type. Include "untyped" to also match queries without a type. Results from since-deleted queries are excluded when this filter is set.
comparative, informative, perception, untyped Query tag matching mode: "or" matches ANY tag (default), "and" matches ALL tags.
and, or Execution tag matching mode: "or" matches ANY tag (default), "and" matches ALL tags.
and, or Deprecated and ignored. Date bounds and buckets are always UTC. Accepted for backward compatibility only.
"UTC"
Row grouping level for entity results. "none" = one row per entity, "division" = one row per division (entities not in a division get their own row), "group" = one row per top-level group (divisions roll up into their group). Defaults to "none".
none, division, group Deprecated — use groupBy instead. true is equivalent to groupBy="group".
false
Include entities that have only ever been seen in a single AI response. These are mostly one-off extraction noise and are hidden by default.
false
Entity IDs for the project brand (defaults to primary non-blacklisted)
["3fa85f64-5717-4562-b3fc-2c963f66afa6"]
Restrict to specific tag IDs (omit for all tags)
["pricing", "features"]
Max number of tags (rows) to return for this page, ranked by visibility. Defaults to 5.
5
Number of tags (rows) to skip for pagination. Defaults to 0.
0