brand-monitoring/
mentions

The Brand Mentions API finds web pages that mention a brand, product or topic and returns each page's passage, author, date, site type, sentiment and emotion scores and authority ranks.

Brand Mentions API

Mentions across the web
Sentiment per passage
Site type filter
Authority and spam scores
10 credits / request + 0.02 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Brand Mentions

A brand mention is a page on the open web, such as a review, news story, forum thread or product listing, whose text names the brand, together with the passage around the name, its author, language, country and publish date. Scored for sentiment and emotion and ranked by page and domain authority, those mentions show where a brand is discussed, which way the conversation leans and which sources carry weight, supporting reputation monitoring, PR tracking and competitor research.

Brand Mentions API Features

  • Keyword or exact-phrase matchingquery takes a brand, product or topic of up to 100 characters, and wrapping a phrase in double quotes matches it exactly rather than word by word.
  • Filter by kind of sitecontent_type limits results to news, blogs, message-boards, ecommerce or organization sites, and page_types records the type of every page returned.
  • Sentiment and emotion for each passagesentiment splits the passage into positive, negative and neutral scores that add up to 1, and emotions scores happiness, love, fun, share, sadness and anger from 0 to 1.
  • Authority and quality signalsdomain_rank and page_rank rate authority from 0 to 1000, while spam_score and content_quality_score help set aside thin or spammy pages.
  • The context of each mentiontitle, the passage in text, author_name, language, country, published_at when given and fetched_at place every mention in time and place.
  • Up to 1,000 pages per requestThe Brand Mentions API takes a results_limit of 1 to 1000 pages, enough to review a brand's web footprint in one pass.

Brand Mentions API Parameters

ParametersRequiredDescription
queryRequiredBrand, product or topic to look for, up to 100 characters. Wrap a phrase in double quotes to match it exactly.
content_typeOptionalKind of site to take mentions from: news, blogs, message-boards, ecommerce or organization.
results_limitOptionalNumber of pages to return, from 1 to 1000. Defaults to 100.

How to Use the Brand Mentions API

Send a brand or product name to the Brand Mentions API and read one mention per row.

  1. POST {"query": "notion", "results_limit": 100} to /v1/brand-monitoring/mentions.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the pages from results.items; when has_more is true, request the next page with results.next_cursor.
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}'

Brand Mentions API Use Cases

  • Reputation monitoring: Flag passages whose sentiment.negative score outweighs the positive one and review them first, together with the page's domain_rank.
  • Press coverage tracking: Set content_type to news and keep author_name, published_at and domain_rank to log which outlets covered a launch and how prominent they are.
  • Comparing brands in the conversation: Run the same Brand Mentions API request for your brand and competitors and compare how their mentions spread across page types, countries and sentiment.
  • Finding forum and community threads: Limit content_type to message-boards to collect the discussions where customers talk about a product in their own words.

Brand Mentions API Pro Tips

  • Put multi-word brand names in double quotes, such as "notion ai", to match the exact phrase.
  • Order by published_at when it is present and fall back to fetched_at for recency, since many pages carry no publish date.
  • Drop rows with a high spam_score or a low content_quality_score before reporting sentiment, so thin pages do not tilt the picture.
  • Pair the Brand Mentions API with Brand Sentiment Analysis API when you need the overall split as well as the individual pages.

Beyond the Brand Mentions API, use these APIs when you need a different type of public Brand Monitoring data.

  • Brand Sentiment Analysis API — Summarize how the web talks about a brand or topic in one row, with page counts by sentiment and emotion and the top domains, countries and languages behind each group.

Explore other platforms

Combine Brand Monitoring data with public data from other supported social platforms.

Brand Mentions API — FAQ

Brand Mentions API is a programmatic interface for finding web pages that mention a brand, product or topic, returning each page's passage, author, date, site type, sentiment and emotion scores, and authority and spam scores.

Any indexed web page whose text matches the query, from news articles and blog reviews to forum threads, shop listings and company sites; content_type narrows the results to one of these kinds.

The passage around the mention is scored: sentiment gives positive, negative and neutral shares that add up to 1, and emotions gives six separate scores from 0 to 1.

Yes. Wrap the name in double quotes in query to match the phrase exactly.

Each request costs 10 credits plus 0.02 credits per page returned; the 10 credits also apply when no page is found.