brand-monitoring/
sentiment

The Brand Sentiment Analysis API returns one summary of how the web talks about a brand: pages grouped by positive, negative or neutral sentiment and by emotion, each with counts and the leading sites and countries.

Brand Sentiment Analysis API

Positive, negative, neutral
Six emotions
Leading sites per group
Countries and languages
10 credits / request
Ready
Ready

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

README

By SocQ · Updated

Brand Sentiment Analysis

Brand sentiment is the overall tone of the pages that mention a brand: how many lean positive, negative or neutral, and which emotions, from happiness and love to sadness and anger, they express most. Broken down by the sites, countries, languages and site types behind each group, that tone shows whether criticism comes from news outlets, forums or one market, which supports reputation reporting, campaign reviews and competitor benchmarking.

Brand Sentiment Analysis API Features

  • Three sentiment groupssentiments reports positive, negative and neutral groups, each with mentions_count, the number of pages that fall into it.
  • Six emotion groupsemotions groups the same pages by their strongest emotion: happiness, love, fun, share, sadness and anger.
  • The sites behind each grouptop_domains lists up to ten sites with the most pages in a group, so you can see which sources drive positive or negative coverage.
  • Countries, languages and site typescountries, languages and page_types show where each group's pages come from, with WW marking worldwide sites and page types such as news, blogs and message-boards.
  • One row per brandA single request returns the whole breakdown for the query, ready to store as a dated snapshot.

Brand Sentiment Analysis API Parameters

ParametersRequiredDescription
queryRequiredBrand, product or topic to analyze, up to 100 characters. Wrap a phrase in double quotes to match it exactly.

How to Use the Brand Sentiment Analysis API

Send a brand or topic to the Brand Sentiment Analysis API and read its sentiment breakdown as one row.

  1. POST {"query": "notion"} to /v1/brand-monitoring/sentiment.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded; broad terms can take a few minutes.
  3. Read the breakdown from results.items; has_more and results.next_cursor follow the usual paging rules and stay empty for this single row.
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"}'

Brand Sentiment Analysis API Use Cases

  • Monthly reputation snapshots: Store the mentions_count of each sentiment group every month to chart how the share of negative pages about a brand moves over time.
  • Tracing the source of criticism: Read top_domains, countries and page_types of the negative group to see whether complaints concentrate on a few sites, one country or forums.
  • Benchmarking against competitors: Run the same query format for your brand and rivals and compare their positive, negative and neutral counts and leading emotions.
  • Reviewing a campaign: Compare emotion groups such as happiness and anger before and after a launch to see how the conversation shifted.

Brand Sentiment Analysis API Pro Tips

  • Analyze a specific product or campaign name rather than a generic word; very broad terms with millions of mentions can take a few minutes to finish.
  • Run competitor queries on the same day as your own, so all snapshots cover the same state of the web.
  • Open Brand Mentions API with the same query to read the actual pages behind a group that changed.

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

  • Brand Mentions API — Find web pages that mention a brand, product or topic, with the passage, author, date, site type, sentiment and emotion scores, and page and domain authority.

Explore other platforms

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

Brand Sentiment Analysis API — FAQ

Brand Sentiment Analysis API is a programmatic interface for summarizing the tone of web pages that mention a brand, product or topic, returning page counts for positive, negative and neutral groups and six emotion groups, each with its leading sites, countries, languages and site types.

Brand Mentions API lists the pages one by one with their own scores; Brand Sentiment Analysis API returns a single summary row that groups all matching pages by sentiment and emotion.

Happiness, love, fun, share, sadness and anger, each reported as its own group with a page count and source breakdown.

Most queries finish in well under a minute; very broad terms with millions of matching pages can take up to a few minutes.

Each request costs 10 credits and returns one row.