Content Analysis APIFetch keyword web citation and sentiment analytics as structured JSON with one SocialCrawl API key. Analytic reads cost 20 credits. Reference lists cost 1 credit. This is web mention intelligence, not a social scrape.
10 active endpoints. Web citation and sentiment analytics.
Ten live GET endpoints for keyword-based web citation intelligence. Search mentions, roll up summaries, score sentiment, trend phrases and categories, and load reference taxonomies. Data API only. Not native social posts or comments.
/v1/content_analysis/searchPages across news, blogs, shops, and message boards that mention your keyword. Each row carries sentiment and emotional tone. Cursor-paginated for deeper pages.
keyword, page_type, search_mode, limit, cursor, order_by, filters
/v1/content_analysis/summaryOne roll-up of every web mention of a keyword: total count, top domains, sentiment splits, and breakdowns by page type, country, and language.
keyword, page_type, positive_connotation_threshold, filters
/v1/content_analysis/sentimentTwo sentiment views of a keyword's web mentions: positive, negative, and neutral, plus six emotional axes such as anger, happiness, and love.
keyword, page_type, positive_connotation_threshold, filters
/v1/content_analysis/rating-distributionTen-bucket histogram of ratings found in a keyword's web mentions, with sentiment, domains, and categories per bucket. Built for review-heavy products and terms.
keyword, page_type, filters
/v1/content_analysis/phrase-trendsTime series of how often a keyword was mentioned on the web and how sentiment moved, one row per day, week, or month.
keyword, date_from, date_to, date_group, page_type, filters
/v1/content_analysis/category-trendsSame volume and sentiment time series as phrase-trends, keyed on a content category code instead of a keyword. Look up codes with categories first.
category_code, date_from, date_to, date_group, filters
/v1/content_analysis/languagesSupported languages with names and ISO codes. Use them to filter calls or interpret language fields on mentions.
(none)
/v1/content_analysis/locationsSupported locations for content analysis. Use them to interpret country fields on mentions or check coverage.
(none)
/v1/content_analysis/categoriesFull content category taxonomy with code, name, and parent code. Required input map for category-trends and for decoding mention categories.
(none)
/v1/content_analysis/filtersFields you may filter on and the value type each accepts. Build a valid filters expression before search, summary, or sentiment.
(none)
Returns pages across news, blogs, shops, and message boards that mention your keyword, each scored for sentiment and emotional tone.
Use it to read the individual mentions and page through them; for one roll-up per keyword use summary instead.
20 credits
keyword · Brand or term to find mentions of. Wrap in escaped double-quotes for an exact phrase (e.g. "logitech mouse").
$ curl https://www.socialcrawl.dev/v1/content_analysis/search?keyword=openai&search_mode=as_is&limit=10 \
-H "x-api-key: sc_YOUR_API_KEY"// Running this live needs your own API key. Hit "Try it" to see an example responseContent Analysis is a normal SocialCrawl analytics surface. You call GET /v1/content_analysis/… with an API key, spend credits on live misses, and get a single JSON envelope back. No second analytics vendor SDK.
Send your key in the x-api-key header. The same key works across the SocialCrawl catalog. No second vendor key on your side.
All public routes are GET. Pass keyword, category_code, date ranges, filters, limit, and cursor as query strings. We validate formats before charging.
Analytic GETs cost 20 credits. Reference lists cost 1 credit. Cache hits cost 0. Empty or hard failures refund. Bad params never charge.
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists may also carry pagination cursors.
Most products load reference maps once, size a keyword with summary or sentiment, then page mentions or trends only when the signal is worth it.
GET /v1/content_analysis/filtersLanguages, locations, categories, and filter field maps
Resolve codes and valid filters before analytic spend.
GET /v1/content_analysis/search?keyword=…Summary or sentiment roll-up for the keyword
One call characterizes volume and tone before you page raw mentions.
GET /v1/content_analysis/summary?keyword=…Paginated citation search with per-page sentiment
Read individual pages when the roll-up is not enough.
GET /v1/content_analysis/phrase-trends?keyword=…&date_from=…Phrase or category time series over a date range
Track movement after you know the baseline snapshot.
GET /v1/content_analysis/search
?keyword=socialcrawl
&page_type=news
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
# aggregate
GET /v1/content_analysis/summary?keyword=socialcrawl
GET /v1/content_analysis/sentiment?keyword=socialcrawl{
"success": true,
"data": {
"items": [
{
"url": "https://example.com/article",
"title": "Example citation",
"sentiment": "positive",
"published_at": "2026-07-01T00:00:00.000Z"
}
]
},
"credits_used": 20,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}Content Analysis uses Analytics-shaped payloads under the shared SocialCrawl envelope. This is citation intelligence, not Post or Comment leaves from social platforms.
success, data, credits_used, credits_remaining, request_id, cached
citation rows with page metadata, sentiment scores, emotional axes, domains, categories, language, country
totals, domain splits, sentiment ratios, page-type and geo breakdowns, rating histograms
time-series buckets for phrases or categories; static language, location, category, and filter maps
Same request lifecycle as every other /v1 platform endpoint. Content Analysis is not a sidecar.
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit and concurrency per key.
Registry lookup finds content_analysis routes. Required params run first. Invalid input returns 400 with no charge. Valid calls debit 20 or 1 credits before upstream work.
A deterministic cache key is built from platform, resource, and params. Hit: return immediately, credits_used = 0. Miss: analytic GETs run as live content-analysis jobs; reference lists map to static lookups and cache heavily.
Upstream JSON is shaped into Analytics payloads, wrapped in the success envelope, and logged for billing audit. Field maps stay passthrough Analytics rather than social Post leaves.
Billing rules that matter in production
Content Analysis is keyword web citation and sentiment analytics over a large mention database. It is not a scrape of TikTok, X, or other social timelines.
Web-wide brand and keyword listening: news, blogs, shops, message boards, and organization pages. Read-only analytics for research, monitoring, and product jobs.
Public GETs map to live content-analysis jobs for analytics and to static reference lookups for languages, locations, categories, and filters.
A unified JSON envelope: success, data, credits_used, request_id, cached. Mentions carry sentiment axes. Rollups and trends stay under Analytics shapes.
No social platform post scrape on this surface. No write endpoints. No vendor dashboard login. Native social reads live under their own platform routes.
The jobs this API is most often used for.
Brand mention sizing and web sentiment
Callers concentrate on summary and sentiment first, then search pages for evidence. Trends and rating distribution show up for longer brand tracking jobs. Keyword web citation analytics with six-axis sentiment under the same SocialCrawl key and envelope as social platforms. Flat 20-credit analytic tier. Reference maps at 1 credit.
Analytic live jobs are slower than cached reference lists. Reference endpoints are heavily cached and usually return quickly after the first miss.
The jobs Content Analysis data is most often used for. Each one is a full recipe with the endpoint chain and pricing.
Common ways teams put this data to work, and the stack each one tends to run.
Run summary and sentiment on brand terms on a schedule. Open search when volume or tone shifts and evidence pages are needed.
Use rating-distribution and phrase-trends for review-heavy terms. Join category-trends after resolving codes from categories.
Load filters and taxonomies once, then wire analytic GETs into pipelines. Same API key as the rest of SocialCrawl.
Analytic routes cost 20 credits per live call. Reference lists cost 1. Cache hits are free. Start with keyword on summary or search.
curl "https://www.socialcrawl.dev/v1/content_analysis/search?keyword=socialcrawl" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/content_analysis/summary?keyword=socialcrawl" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
Same Content Analysis data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | Build-your-own NLP pipeline |
|---|---|---|
| Setup | One GET per question: mentions, sentiment, and trends are each a single call | Crawler, mention index, and NLP models to build, train, and host |
| Coverage | Web-wide citation database: news, blogs, ecommerce, message boards | Limited to whatever your crawler reaches and you can afford to store |
| Sentiment scoring | 6-axis emotion model plus positive/negative/neutral probabilities, passed through verbatim | Model selection, training data, and accuracy tuning are all on you |
| Pricing | 20 credits per analytic call, 1 credit per reference lookup; 100 free credits to start | Compute, storage, and data engineering time before the first result |
| Maintenance | Endpoints stay stable behind the unified schema | Crawlers and models drift: retraining and fixes never stop |
Setup
Coverage
Sentiment scoring
Pricing
Maintenance
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl