Brand monitoring usually starts with two questions: where is the web talking about us, and how does it feel about us? The first needs page-level data you can read and route. The second needs an aggregate you can chart without downloading millions of pages.
On 2026-11-17 SocQ launched the Brand Monitoring platform with one endpoint for each question. This guide covers what they return, the requests, the price and when to use each.
Quick answer: Send a brand, product or topic in
querytoPOST /v1/brand-monitoring/mentionsfor a list of web pages that mention it, each with sentiment, emotion and authority scores. Send the samequerytoPOST /v1/brand-monitoring/sentimentfor one row that splits all mentions by sentiment and emotion. PollGET /v1/tasks/{task_id}for the results.
The New Brand Monitoring Endpoints
1 SocQ credit = $0.005.
| Endpoint | What it returns | Price |
|---|---|---|
| Brand Mentions API | One row per web page that mentions the query: URL, title, the passage around the mention, author, language, country, site type, sentiment and emotion scores, and page and domain authority | 10 credits ($0.05) per request + 0.02 credits ($0.0001) per page |
| Brand Sentiment Analysis API | One row that groups all pages mentioning the query by main sentiment and by strongest emotion, with page counts and the leading sites, countries, languages and site types in each group | 10 credits ($0.05) per call |
For Brand Mentions the 10-credit base also applies when no page is found.
Authentication and the Async Task Flow
All SocQ requests authenticate with an API key, and the same header is used for submit, task status and result requests:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Every collection runs as a background task:
submit -> task_id -> queued -> running -> succeeded
\-> failed
The submit response contains data.task_id and data.status. Poll the task with that ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
When status is succeeded, the response includes the first page of normalized records in data.results.items. limit defaults to 50 and goes up to 500; if has_more is true, pass results.next_cursor as cursor to read the next page. While a task is queued, running or failed, the endpoint returns task metadata without results.
An optional callback_url in the submit body makes SocQ send one POST with a task summary when the task finishes; read the records with GET /v1/tasks/{task_id}. A client-side timeout does not cancel a task, so resume with the same task ID instead of paying for a duplicate. 402 means insufficient credits; 429 means the key hit a rate or credit limit.
Brand Mentions API: Every Page That Mentions You
The Brand Mentions API returns pages from across the web that mention your query: blog reviews, news coverage, forum threads and product listings. Provide a brand, product or topic in query, up to 100 characters. Wrap a phrase in double quotes to match it exactly. content_type limits results to news, blogs, message-boards, ecommerce or organization sites. results_limit defaults to 100 and accepts 1 to 1,000.
curl -X POST "https://api.socq.ai/v1/brand-monitoring/mentions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "notion",
"results_limit": 100
}'
Each row describes one page:
- Where:
url,title,domain,language,country(two letters;WWmeans worldwide) andpage_types, such asnews,blogsorecommerce. - What:
text, the passage around the mention, andauthor_namewhen given. - How it feels:
sentimentwithpositive,negativeandneutralscores from 0 to 1 that add up to 1, andemotionswith six scores from 0 to 1:happiness,love,fun,share,sadnessandanger. - How much it matters:
content_quality_score(0 to 100),spam_score(0 to 100, higher means more signs of spam),domain_rankandpage_rank(0 to 1,000). - When:
fetched_at, the time the page was last read.
The authority and spam scores let you sort a large result set so the team reads high-authority, low-spam pages first, while the sentiment split flags pages that need a reply. 100 pages cost 12 credits ($0.06), and the maximum of 1,000 pages costs 30 credits ($0.15). Full field list: Brand Mentions docs.
To watch only the press, add a filter:
{
"query": "\"notion ai\"",
"content_type": "news",
"results_limit": 200
}
Brand Sentiment Analysis API: The Breakdown Behind the Number
The Brand Sentiment Analysis API answers "how does the web feel about us" without returning individual pages. Pages mentioning your query are grouped by their main sentiment and, separately, by their strongest emotion. Each group reports how many pages it holds and the sites, countries, languages and site types that contribute most.
curl -X POST "https://api.socq.ai/v1/brand-monitoring/sentiment" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "notion"
}'
The single result row has two arrays:
sentiments: one group each forpositive,negativeandneutral.emotions: one group each forhappiness,love,fun,share,sadnessandanger.
Every group has a label, a mentions_count, and top_domains, countries, languages and page_types, each a list of name and count, largest first. That structure lets you tell whether criticism comes from news outlets or from a single forum, and which countries drive it. Each request costs 10 credits ($0.05). Very broad terms with millions of mentions take longer to analyze, up to a few minutes, so poll patiently. See the Brand Sentiment Analysis docs.
Which Endpoint to Use
- A weekly reputation dashboard: run Brand Sentiment Analysis for your brand and each competitor, store the counts, and chart them over time. Four brands cost 40 credits ($0.20) per run.
- A triage queue for the comms team: run Brand Mentions with
content_typeset tonewsormessage-boards, then sort bynegativesentiment anddomain_rank. - Investigating a spike: when the sentiment counts move, use the
top_domainsin the negative group to see which sites drive it, then pull those pages with Brand Mentions.
Both endpoints work on web pages in the five site types above. For posts and comments on social networks, use the platform endpoints described in the unified social media API guide. For what AI assistants say about your brand, see the AI Search API guide.
FAQ
What is a brand monitoring API?
An API that finds where a brand, product or topic is mentioned and how those mentions feel. SocQ's version returns page-level mentions with sentiment, emotion and authority scores, plus an aggregate sentiment and emotion breakdown.
How do I match an exact phrase?
Wrap it in double quotes inside query, for example "\"notion ai\"" in JSON. The query can be up to 100 characters.
Which kinds of sites are covered?
Pages are classified as news, blogs, message-boards, ecommerce or organization. Brand Mentions can be limited to one of those types with content_type.
Am I charged when nothing is found?
Brand Mentions charges its 10-credit base even when no page is found, plus 0.02 credits per page returned. Brand Sentiment Analysis costs 10 credits per request.
Why is my sentiment task still running?
Very broad terms with millions of mentions take longer to analyze, up to a few minutes. Keep polling the same task_id; do not resubmit.
BRAND MONITORING API
Test the workflow with a public Brand Monitoring URL
Submit public inputs and receive normalized records with traceable source context.
Explore Brand Monitoring APIs