Brand MonitoringBrand MentionsSentiment AnalysisReputationAPI Guide

Brand Monitoring API: Web Mentions With Sentiment, Emotion and Authority Scores

Two new SocQ endpoints collect web pages that mention a brand with sentiment, emotion and authority scores, and split all mentions into positive, negative and neutral.

SocQUpdated November 19, 20266 min read

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 query to POST /v1/brand-monitoring/mentions for a list of web pages that mention it, each with sentiment, emotion and authority scores. Send the same query to POST /v1/brand-monitoring/sentiment for one row that splits all mentions by sentiment and emotion. Poll GET /v1/tasks/{task_id} for the results.

The New Brand Monitoring Endpoints

1 SocQ credit = $0.005.

EndpointWhat it returnsPrice
Brand Mentions APIOne 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 authority10 credits ($0.05) per request + 0.02 credits ($0.0001) per page
Brand Sentiment Analysis APIOne 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 group10 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; WW means worldwide) and page_types, such as news, blogs or ecommerce.
  • What: text, the passage around the mention, and author_name when given.
  • How it feels: sentiment with positive, negative and neutral scores from 0 to 1 that add up to 1, and emotions with six scores from 0 to 1: happiness, love, fun, share, sadness and anger.
  • How much it matters: content_quality_score (0 to 100), spam_score (0 to 100, higher means more signs of spam), domain_rank and page_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 for positive, negative and neutral.
  • emotions: one group each for happiness, love, fun, share, sadness and anger.

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_type set to news or message-boards, then sort by negative sentiment and domain_rank.
  • Investigating a spike: when the sentiment counts move, use the top_domains in 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