Back to APIs
Brand monitoring data

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.

CompareBrand Mentions APIBrand Sentiment Analysis API
ResultOne row per web pageOne summary row per query
SentimentScores for each page's passagePage counts per sentiment and emotion group
SourcesDomain, author, site type and authority per pageTop domains, countries, languages and page types per group
Filtersquery, content_type and results_limit up to 1,000query
Pricing10 credits per request plus 0.02 per page10 credits per request

How the Brand Monitoring API works

Both APIs use the same asynchronous task flow.

  1. 1. Send a query

    POST a brand, product or topic to /v1/brand-monitoring/mentions or /v1/brand-monitoring/sentiment.

  2. 2. Track the task

    Poll GET /v1/tasks/{task_id} until status is succeeded; broad terms can take a few minutes.

  3. 3. Read the results

    Read the pages or the summary row in results.items.

Find web mentions of a brand

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.items

Common 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.

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.