100 free credits — no credit card required.Start building
Logo
100 free credits — no credit card required

Prism Share Of Voice API

Scrape Prism Share Of Voice data with one API call. Per brand, fans out to content_analysis summary/phrase-trends/sentiment plus /search/everywhere (consuming the real per-platform items_by_source counts, not the capped fused list), then computes a published-formula SOV (web + social, equal-weighted by default), optional true-share-of-category (numeric `category_code`), and ESOV (`market_shares`, Binet/Field — a planning signal, not a growth guarantee). Metered at 40cr/brand (20 web-only); a brand whose social search half-failed is automatically cheaper, with the reason legible in `legs[]` + per-brand `coverage`.

Last updated June 2026

Try the Prism Share Of Voice API

See real data before writing a single line

GET/v1/prism/share-of-voice

2-5 competitor brand names (CSV).

6 optional parameters

Numeric DFS taxonomy code for true-share-of-category (use content_analysis/categories to look one up).

JSON map of real market share per brand (fraction or %), e.g. {"notion":0.4,"coda":0.25,"airtable":0.35}, to compute ESOV.

CSV toggles (default `emotions,social`). Drop `social` for the cheaper web-only variant; drop `emotions` to skip the sentiment leg.

Optional surface filter forwarded to the content_analysis legs.

Window start (YYYY-MM-DD). Defaults to 90 days ago.

Window end (YYYY-MM-DD). Defaults to today.

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 Share Of Voice API?

The Share Of Voice 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/share-of-voice?brands=notion%2Ccoda%2Cairtable" \
  -H "x-api-key: YOUR_API_KEY"
import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/prism/share-of-voice",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"brands": "notion,coda,airtable"},
)
data = response.json()
const params = new URLSearchParams({
  "brands": "notion,coda,airtable",
});

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

Parameters

ParameterRequiredDescription
brandsYes2-5 competitor brand names (CSV).
category_codeNoNumeric DFS taxonomy code for true-share-of-category (use content_analysis/categories to look one up).
market_sharesNoJSON map of real market share per brand (fraction or %), e.g. {"notion":0.4,"coda":0.25,"airtable":0.35}, to compute ESOV.
includeNoCSV toggles (default `emotions,social`). Drop `social` for the cheaper web-only variant; drop `emotions` to skip the sentiment leg.
page_typeNoOptional surface filter forwarded to the content_analysis legs. (ecommerce | news | blogs | message-boards | organization)
date_fromNoWindow start (YYYY-MM-DD). Defaults to 90 days ago.
date_toNoWindow end (YYYY-MM-DD). Defaults to today.
API Details

How does the Prism Share Of Voice 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 Share Of Voice 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.

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.

Contact us

Ask AI about SocialCrawl

Ready to scrape Prism Share Of Voice data?

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

Start for free