What is the SocialCrawl Brand Mentions API?

GET /v1/prism/brand-mentions takes one keyword and returns mention volume over time, a sentiment split, top source domains, and recent mentions in a single call. It also adds a computed trajectory — the volume slope and direction — that no single content-analysis endpoint produces on its own.

How is the sentiment in brand-mentions calculated?

Sentiment is NLP-derived from the underlying content-analysis corpus, not from an LLM, and is returned as a positive/negative/neutral split plus a per-bucket timeline. The optional digest narrates those numbers in one paragraph but never invents new figures.

How much does a brand-mentions call cost?

Each call is a flat 20 credits and runs three content-analysis legs in parallel. New accounts get 100 free credits with no credit card. If a strict majority of the legs fail, half the cost is refunded automatically; if all three fail, the full 20 credits come back.

Can I get a volume and sentiment trajectory over time?

Yes. The computed.trajectory block returns a volume_slope (ordinary-least-squares mentions per bucket), a noise-aware volume_direction of rising, flat, or falling, and a negative_share_slope. The timeline carries one bucket per day, week, or month over your date window.

What does include=digest add to the response?

Adding include=digest appends a short, plain-language summary of the volume and sentiment trajectory written by a fast language model. The price stays a flat 20 credits — the digest is included, not metered — and if the model fails the rest of the response is unaffected.

100 free credits — no credit card required

Prism Brand Mentions API

Name: Prism Brand Mentions API
Brand: SocialCrawl
Availability: InStock
Rating: 4.9 (200 reviews)

Scrape Prism Brand Mentions data with one API call. Fans out to content_analysis summary, phrase-trends, and search in parallel, then folds them into one envelope with a computed volume/sentiment trajectory (OLS slope + a noise-aware direction) and an optional LLM digest (`include=digest`). Sentiment is NLP-derived (content_analysis), and mention freshness lags the live web by days. The `computed` block carries stable keys + a `methodology_version` so a monitor can diff runs. `legs[]` reports each leg's status, cost, and latency; if one of the three data legs fails the call still returns a degraded result, and a strict-majority failure refunds half.

Last updated June 2026

Start for free View Documentation

Try the Prism Brand Mentions API

See real data before writing a single line

GET/v1/prism/brand-mentions

Searching 42 platforms in parallel

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·UUtility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·UUtility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·UUtility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·UUtility·

Universal Search

Prism API

What can you do with the Brand Mentions API?

The Brand Mentions endpoint gives you structured Prism data with computed fields in a single request. No scraping infrastructure to build or maintain.

Example Request

curl "https://www.socialcrawl.dev/v1/prism/brand-mentions?keyword=socialcrawl&date_from=2026-06-01" \
  -H "x-api-key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/prism/brand-mentions",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"keyword": "socialcrawl", "date_from": "2026-06-01"},
)
data = response.json()

const params = new URLSearchParams({
  "keyword": "socialcrawl",
  "date_from": "2026-06-01",
});

const response = await fetch(`https://www.socialcrawl.dev/v1/prism/brand-mentions?${params}`, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

Parameters

Parameter	Required	Description
keyword	Yes	The brand or term to track. Wrap in quotes for exact-phrase semantics.
date_from	Yes	Window start (YYYY-MM-DD). Required by the trend leg.
date_to	No	Window end (YYYY-MM-DD). Defaults to the latest crawl.
date_group	No	Trend bucket size: day (default), week, or month. (day \| week \| month)
page_type	No	Optional surface filter: ecommerce, news, blogs, message-boards, or organization. (ecommerce \| news \| blogs \| message-boards \| organization)
include	No	Set `digest` to add an LLM narrative summary leg.

API Details

How does the Prism Brand Mentions API work?

Send a GET request with your API key and get back clean, structured JSON. Every response follows our unified schema with computed fields.

Method

GET

Response

JSON

Why SocialCrawl

Why use SocialCrawl for Prism Brand Mentions data?

We handle the complexity of Prism data extraction so you can focus on building. Unified schema, AI enrichment, and zero platform logic in your code.

One schema for every platform — write your integration once
Computed fields on every response: engagement rate, reach, category, language
No scraping infrastructure to build, no proxies to manage, no rate limits to fight
Real-time data from Prism — no caching, no delays

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 42 platforms covering 10B+ monthly active users.

One schema, every platform

Query 42 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

Every response includes engagement_rate, estimated_reach, content_category, and language — ready to use.

See your data before you code

Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()

[ .JSON ]

{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}

+ 42 platforms

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Ask AI about SocialCrawl

Ask ChatGPT Ask Perplexity Ask Gemini Ask Claude Ask Grok

Ready to scrape Prism Brand Mentions data?

Get your API key and start pulling Prism data in under 60 seconds.

Start for free