Brand Sentiment Analysis API
curl --request POST \
--url https://api.socq.ai/v1/brand-monitoring/sentiment \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/brand-monitoring/sentiment"
payload = {
"query": "<string>",
"callback_url": "<string>"
}
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>'})
};
fetch('https://api.socq.ai/v1/brand-monitoring/sentiment', 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/sentiment",
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>'
]),
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/sentiment"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\"\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/sentiment")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/brand-monitoring/sentiment")
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}"
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 Sentiment Analysis
Split the web pages that mention a brand into positive, negative and neutral, and by emotion, with the top sites and countries for each.
POST
/
v1
/
brand-monitoring
/
sentiment
Brand Sentiment Analysis API
curl --request POST \
--url https://api.socq.ai/v1/brand-monitoring/sentiment \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/brand-monitoring/sentiment"
payload = {
"query": "<string>",
"callback_url": "<string>"
}
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>'})
};
fetch('https://api.socq.ai/v1/brand-monitoring/sentiment', 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/sentiment",
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>'
]),
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/sentiment"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\"\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/sentiment")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/brand-monitoring/sentiment")
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}"
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 Sentiment Analysis
One number answers “how does the web feel about us”, and this endpoint gives you the breakdown behind it. Pages mentioning your query are grouped by their main sentiment and, separately, by their strongest emotion: happiness, love, fun, share, sadness and anger. Each group reports how many pages it holds and the sites, countries, languages and site types that contribute most, so you can tell whether criticism comes from news outlets or from a single forum.{
"query": "notion"
}
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 | The query, 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 | Public URL of the result item when available. |
published_at | string | Yes | Time the source item was published, in ISO 8601 format when available. |
collected_at | string | No | Time SocQ collected or processed this result, in ISO 8601 format. |
query | string | Yes | Brand, product or topic that was analyzed. |
sentiments | array<object> | Yes | Pages mentioning the query, grouped by their main sentiment. |
sentiments.label | string | Yes | Sentiment of the group: positive, negative or neutral. |
sentiments.mentions_count | integer | Yes | Number of web pages in this group. |
sentiments.top_domains | array<object> | Yes | Sites with the most pages in this group, largest first. |
sentiments.top_domains.name | string | Yes | Domain of the site. |
sentiments.top_domains.count | integer | Yes | Number of web pages. |
sentiments.countries | array<object> | Yes | Countries of the pages in this group, largest first. |
sentiments.countries.name | string | Yes | Two-letter country code; WW means worldwide. |
sentiments.countries.count | integer | Yes | Number of web pages. |
sentiments.languages | array<object> | Yes | Languages of the pages in this group, largest first. |
sentiments.languages.name | string | Yes | Language code, such as en. |
sentiments.languages.count | integer | Yes | Number of web pages. |
sentiments.page_types | array<object> | Yes | Kinds of sites the pages come from, largest first. |
sentiments.page_types.name | string | Yes | Site kind: news, blogs, message-boards, ecommerce or organization. |
sentiments.page_types.count | integer | Yes | Number of web pages. |
emotions | array<object> | Yes | Pages mentioning the query, grouped by their strongest emotion. |
emotions.label | string | Yes | Emotion of the group: happiness, love, fun, share, sadness or anger. |
emotions.mentions_count | integer | Yes | Number of web pages in this group. |
emotions.top_domains | array<object> | Yes | Sites with the most pages in this group, largest first. |
emotions.top_domains.name | string | Yes | Domain of the site. |
emotions.top_domains.count | integer | Yes | Number of web pages. |
emotions.countries | array<object> | Yes | Countries of the pages in this group, largest first. |
emotions.countries.name | string | Yes | Two-letter country code; WW means worldwide. |
emotions.countries.count | integer | Yes | Number of web pages. |
emotions.languages | array<object> | Yes | Languages of the pages in this group, largest first. |
emotions.languages.name | string | Yes | Language code, such as en. |
emotions.languages.count | integer | Yes | Number of web pages. |
emotions.page_types | array<object> | Yes | Kinds of sites the pages come from, largest first. |
emotions.page_types.name | string | Yes | Site kind: news, blogs, message-boards, ecommerce or organization. |
emotions.page_types.count | integer | Yes | Number of web pages. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-brand-monitoring-sentiment",
"status": "succeeded",
"public_id": "brand-monitoring/sentiment",
"result_count": 1,
"credits_amount": 10,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "brand-sentiment",
"schema_version": "1.0",
"items": [
{
"id": "notion",
"platform": "brand-monitoring",
"resource": "sentiment",
"type": "sentiment",
"url": null,
"published_at": null,
"collected_at": "2026-11-17T23:56:20.984740Z",
"query": "notion",
"sentiments": [
{
"label": "positive",
"mentions_count": 3890592,
"top_domains": [
{
"name": "oychicago.com",
"count": 55456
},
{
"name": "bibleandbookcenter.com",
"count": 39000
},
{
"name": "the-jet-collection.com",
"count": 26240
}
],
"countries": [
{
"name": "US",
"count": 576952
},
{
"name": "FR",
"count": 318248
},
{
"name": "WW",
"count": 183904
}
],
"languages": [
{
"name": "en",
"count": 3071912
},
{
"name": "fr",
"count": 689568
},
{
"name": "es",
"count": 59640
}
],
"page_types": [
{
"name": "blogs",
"count": 2738408
},
{
"name": "organization",
"count": 1192344
},
{
"name": "news",
"count": 602184
}
]
},
{
"label": "negative",
"mentions_count": 4000000,
"top_domains": [
{
"name": "oychicago.com",
"count": 50928
},
{
"name": "acedessays.com",
"count": 46656
},
{
"name": "integrately.com",
"count": 35688
}
],
"countries": [
{
"name": "US",
"count": 837792
},
{
"name": "FR",
"count": 359008
},
{
"name": "WW",
"count": 181512
}
],
"languages": [
{
"name": "en",
"count": 3222480
},
{
"name": "fr",
"count": 685728
},
{
"name": "de",
"count": 34240
}
],
"page_types": [
{
"name": "blogs",
"count": 2728320
},
{
"name": "organization",
"count": 1167856
},
{
"name": "news",
"count": 1141824
}
]
},
{
"label": "neutral",
"mentions_count": 3928936,
"top_domains": [
{
"name": "oychicago.com",
"count": 73112
},
{
"name": "cebh.info",
"count": 47720
},
{
"name": "visualbudget.org",
"count": 43824
}
],
"countries": [
{
"name": "US",
"count": 643752
},
{
"name": "WW",
"count": 144488
},
{
"name": "IN",
"count": 116192
}
],
"languages": [
{
"name": "en",
"count": 3917480
},
{
"name": "fr",
"count": 2832
},
{
"name": "de",
"count": 2144
}
],
"page_types": [
{
"name": "blogs",
"count": 3166704
},
{
"name": "organization",
"count": 1120616
},
{
"name": "news",
"count": 480624
}
]
}
],
"emotions": [
{
"label": "happiness",
"mentions_count": 687456,
"top_domains": [
{
"name": "euskalerriairratia.eus",
"count": 41136
},
{
"name": "eurostarinc.com",
"count": 25168
},
{
"name": "integrately.com",
"count": 15376
}
],
"countries": [
{
"name": "FR",
"count": 229448
},
{
"name": "WW",
"count": 79600
},
{
"name": "US",
"count": 42960
}
],
"languages": [
{
"name": "fr",
"count": 531200
},
{
"name": "en",
"count": 109272
},
{
"name": "de",
"count": 27984
}
],
"page_types": [
{
"name": "blogs",
"count": 433944
},
{
"name": "organization",
"count": 292072
},
{
"name": "ecommerce",
"count": 172496
}
]
},
{
"label": "love",
"mentions_count": 256208,
"top_domains": [
{
"name": "bloomex.ca",
"count": 9576
},
{
"name": "scripturesavvy.com",
"count": 2992
},
{
"name": "explainingthebible.com",
"count": 2656
}
],
"countries": [
{
"name": "US",
"count": 45768
},
{
"name": "FR",
"count": 33984
},
{
"name": "WW",
"count": 15176
}
],
"languages": [
{
"name": "en",
"count": 183144
},
{
"name": "fr",
"count": 66024
},
{
"name": "de",
"count": 3240
}
],
"page_types": [
{
"name": "blogs",
"count": 155704
},
{
"name": "organization",
"count": 114448
},
{
"name": "news",
"count": 61496
}
]
},
{
"label": "fun",
"mentions_count": 30032,
"top_domains": [
{
"name": "ariase.com",
"count": 4296
},
{
"name": "vin-vigne.com",
"count": 3640
},
{
"name": "conseilinformatique.fr",
"count": 768
}
],
"countries": [
{
"name": "FR",
"count": 18648
},
{
"name": "WW",
"count": 1472
},
{
"name": "US",
"count": 816
}
],
"languages": [
{
"name": "fr",
"count": 25520
},
{
"name": "en",
"count": 2288
},
{
"name": "ja",
"count": 1256
}
],
"page_types": [
{
"name": "blogs",
"count": 18152
},
{
"name": "organization",
"count": 16488
},
{
"name": "ecommerce",
"count": 8976
}
]
}
]
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json
Provide a brand, product or topic in query. The result is one row splitting the web pages that mention it by sentiment (positive, negative, neutral) and by emotion, with the leading sites and countries for each.

