Brand Monitoring API
Find the web pages that mention a brand, product or topic, score each one for sentiment and emotion, and summarize how the whole web talks about it.
Available Brand Monitoring APIs
Use Brand Mentions API for page-by-page evidence with sentiment and authority scores, or Brand Sentiment Analysis API for one summary row split by sentiment and emotion.
What brand monitoring data can you retrieve?
Both APIs read the same body of indexed web pages: one returns the pages, the other summarizes them.
Mentions on web pages
Page title, URL, the passage around the mention, author, domain, language, country and publish or fetch date.
Sentiment and emotions
Positive, negative and neutral shares that sum to 1, plus 0–1 scores for happiness, love, fun, share, sadness and anger.
Authority and quality
Domain and page rank from 0 to 1000, with spam and content quality scores from 0 to 100.
Site types
Whether each page is news, a blog, a message board, an ecommerce page or an organization site.
Sentiment breakdown
Page counts per sentiment and emotion group, with the top domains, countries, languages and page types behind each group.
Brand Mentions or Brand Sentiment Analysis
Run both on the same query when you need the overall picture and the pages behind it.
| Compare | Brand Mentions API | Brand Sentiment Analysis API |
|---|---|---|
| Result | One row per web page | One summary row per query |
| Sentiment | Scores for each page's passage | Page counts per sentiment and emotion group |
| Sources | Domain, author, site type and authority per page | Top domains, countries, languages and page types per group |
| Filters | query, content_type and results_limit up to 1,000 | query |
| Pricing | 10 credits per request plus 0.02 per page | 10 credits per request |
How the Brand Monitoring API works
Both APIs use the same asynchronous task flow.
1. Send a query
POST a brand, product or topic to /v1/brand-monitoring/mentions or /v1/brand-monitoring/sentiment.
2. Track the task
Poll GET /v1/tasks/{task_id} until status is succeeded; broad terms can take a few minutes.
3. Read the results
Read the pages or the summary row in results.items.
Authenticate with your SocQ API key and send a brand name. A request costs 10 credits plus 0.02 credits per page returned.
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}'
# Poll GET /v1/tasks/{task_id}
# Read the mentions in results.itemsCommon Brand Monitoring API use cases
Reputation monitoring
Flag negative passages on high-authority pages and review them first.
Press coverage tracking
Collect news mentions with author, date and domain rank after a launch or announcement.
Competitive benchmarking
Compare sentiment, emotions and source mix between your brand and competitors.
Community listening
Gather message-board threads where people describe a product in their own words.
Campaign reviews
Compare sentiment and emotion groups before and after a campaign.
Request rules and pricing
These rules apply to both Brand Monitoring APIs.
- query takes a brand, product or topic of up to 100 characters; wrap a phrase in double quotes for an exact match.
- Brand Mentions API accepts content_type news, blogs, message-boards, ecommerce or organization, and returns 1–1,000 pages, 100 by default.
- Most sentiment summaries finish in under a minute; broad terms with millions of matching pages can take a few minutes.
- Brand Mentions API costs 10 credits per request plus 0.02 credits per page returned; Brand Sentiment Analysis API costs 10 credits per request.
Brand Monitoring API frequently asked questions
What is the Brand Monitoring API?
The Brand Monitoring API finds web pages that mention a brand, product or topic and measures their sentiment, either page by page with Brand Mentions API or as one summary with Brand Sentiment Analysis API.
Which Brand Monitoring APIs are available?
Brand Mentions API for individual pages with sentiment, emotion and authority scores, and Brand Sentiment Analysis API for the sentiment and emotion breakdown of all matching pages.
Which websites are covered?
Indexed public web pages such as news articles, blogs, message boards, ecommerce pages and organization sites.
How is sentiment measured?
Each mention's surrounding passage is scored as positive, negative or neutral and for six emotions; the sentiment summary groups pages by these scores.
How are Brand Monitoring requests priced?
Brand Mentions API costs 10 credits per request plus 0.02 credits per page returned. Brand Sentiment Analysis API costs 10 credits per request.
Combine data across platforms for more complete business insights
Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.
AI Search API
Track how AI Overviews, ChatGPT and Google AI Mode answer the questions in your market: the answers that name your brand, how visible you are, and the domains and pages they cite.
Instagram API
Look up or find public profiles and collect follower-list records, following relationships, authored posts, profile-tagged posts, hashtag results, Reels, transcripts, comments, account counts, engagement metrics and media metadata through one asynchronous workflow.
TikTok API
Collect supported public TikTok profiles, direct video metadata, top-level comments, video search results, and videos for specified hashtags through one normalized asynchronous workflow.
YouTube API
Collect supported public YouTube channel profiles, video details, channel videos, comments, Shorts, keyword and hashtag results, and available transcripts through one normalized asynchronous workflow.
Facebook API
Collect public Facebook Page profiles, posts, group posts, comments, keyword-matched events, and available video transcripts with normalized identity, content, source, format, place, media, reaction, attendance, and engagement fields.
X API
Collect public profiles, follower and following relationships, posts, replies, quotes, retweeters, search results, and current trends. Use consistent results for research and monitoring.

