Brand Mentions API
curl --request POST \
--url https://api.socq.ai/v1/brand-monitoring/mentions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"callback_url": "<string>",
"results_limit": 100
}
'import requests
url = "https://api.socq.ai/v1/brand-monitoring/mentions"
payload = {
"query": "<string>",
"callback_url": "<string>",
"results_limit": 100
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({query: '<string>', callback_url: '<string>', results_limit: 100})
};
fetch('https://api.socq.ai/v1/brand-monitoring/mentions', 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.socq.ai/v1/brand-monitoring/mentions",
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([
'query' => '<string>',
'callback_url' => '<string>',
'results_limit' => 100
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.socq.ai/v1/brand-monitoring/mentions"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.socq.ai/v1/brand-monitoring/mentions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/brand-monitoring/mentions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Brand Monitoring
Brand Mentions
Collect web pages that mention a brand, with sentiment and emotion scores, author, date, site type and authority.
POST
/
v1
/
brand-monitoring
/
mentions
Brand Mentions API
curl --request POST \
--url https://api.socq.ai/v1/brand-monitoring/mentions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"callback_url": "<string>",
"results_limit": 100
}
'import requests
url = "https://api.socq.ai/v1/brand-monitoring/mentions"
payload = {
"query": "<string>",
"callback_url": "<string>",
"results_limit": 100
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({query: '<string>', callback_url: '<string>', results_limit: 100})
};
fetch('https://api.socq.ai/v1/brand-monitoring/mentions', 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.socq.ai/v1/brand-monitoring/mentions",
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([
'query' => '<string>',
'callback_url' => '<string>',
'results_limit' => 100
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.socq.ai/v1/brand-monitoring/mentions"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.socq.ai/v1/brand-monitoring/mentions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/brand-monitoring/mentions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Brand Mentions
Each row is a page somewhere on the web that mentions your query: blog reviews, news coverage, forum threads, product listings. Next to the URL and title you get the passage around the mention, the author when given, the page’s language and country, its site type, a positive/negative/neutral sentiment split for the passage, six emotion scores, and authority and spam scores for the page and its domain. Filter to news or forums only with content_type, and wrap a phrase in double quotes to match it exactly.{
"query": "notion",
"results_limit": 100
}
Standard Result Fields
Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, usefields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | Yes | URL of the page, used as the identifier. |
platform | string | No | Platform the result belongs to, such as instagram or linkedin. |
resource | string | No | SocQ resource represented by the result, such as videos or comments. |
type | string | No | Category of the result item, such as video, post, or comment. |
url | string | Yes | URL of the page that mentions the query. |
published_at | string | Yes | Time the page was published, in ISO 8601 format, when given. |
collected_at | string | No | Time SocQ collected or processed this result, in ISO 8601 format. |
title | string | Yes | Title of the page. |
text | string | Yes | Passage of the page around the mention. |
author_name | string | Yes | Author of the page, when given. |
domain | string | Yes | Domain of the page. |
language | string | Yes | Language code of the page. |
country | string | Yes | Two-letter country code of the site; WW means worldwide. |
page_types | array<string> | Yes | Kinds of site the page belongs to, such as news, blogs or ecommerce. |
sentiment | object | Yes | Sentiment of the passage, as scores from 0 to 1 that add up to 1. |
sentiment.positive | number | Yes | Positive score. |
sentiment.negative | number | Yes | Negative score. |
sentiment.neutral | number | Yes | Neutral score. |
emotions | object | Yes | Emotions in the passage, as scores from 0 to 1. |
emotions.happiness | number | Yes | Happiness score. |
emotions.love | number | Yes | Love score. |
emotions.fun | number | Yes | Fun score. |
emotions.share | number | Yes | Score for wanting to share. |
emotions.sadness | number | Yes | Sadness score. |
emotions.anger | number | Yes | Anger score. |
content_quality_score | integer | Yes | Quality score of the page’s content from 0 to 100. |
spam_score | integer | Yes | Spam score of the page from 0 to 100; higher means more signs of spam. |
domain_rank | integer | Yes | Authority score of the domain from 0 to 1000. |
page_rank | integer | Yes | Authority score of the page from 0 to 1000. |
fetched_at | string | Yes | Time the page was last read, in ISO 8601 format. |
query | string | Yes | Brand, product or topic that was searched for. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-brand-monitoring-mentions",
"status": "succeeded",
"public_id": "brand-monitoring/mentions",
"result_count": 1,
"credits_amount": 10.02,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "brand-mention",
"schema_version": "1.0",
"items": [
{
"id": "https://play.google.com/store/apps/details?id=com.bynge.story&hl=en_US",
"platform": "brand-monitoring",
"resource": "mentions",
"type": "mention",
"url": "https://play.google.com/store/apps/details?id=com.bynge.story&hl=en_US",
"published_at": null,
"collected_at": "2026-11-17T23:55:01.265294Z",
"title": "Notion Press",
"text": "Unlock the full potential of your publishing journey with the Notion Press App, offering an enhanced and user-friendly author dashboard. Whether you're tracking your earnings, managing book sales, or utilizing exclusive coupon codes, the Notion Press App is here for you.\nSeamless Author Login: Easily access your Notion Press author account and stay connected with your publishing progress anytime, anywhere.\nEnhanced …",
"author_name": "Notion Press",
"domain": "play.google.com",
"language": "en",
"country": "WW",
"page_types": [
"ecommerce"
],
"sentiment": {
"positive": 0.3241,
"negative": 0.1386,
"neutral": 0.5374
},
"emotions": {
"happiness": 0.3779,
"love": 0.2316,
"fun": 0.1624,
"share": 0.151,
"sadness": 0.0405,
"anger": 0.0367
},
"content_quality_score": 91,
"spam_score": 0,
"domain_rank": 1000,
"page_rank": 669,
"fetched_at": "2025-12-28T11:41:43Z",
"query": "notion"
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json
Provide a brand, product or topic in query. Each row is one web page that mentions it, with the page's sentiment and emotion scores, author, date, site type and authority. results_limit defaults to 100 and accepts integers from 1 to 1000.

