How do I get web mentions of a brand with an API?

Send a GET request to /v1/content_analysis/search with the keyword parameter set to your brand or term. You receive a paginated feed of web pages citing it — each with URL, domain, country, language, title, snippet, 6-axis sentiment, and a positive/negative/neutral connotation split.

What fields does each search result include?

Each item has url, domain and main_domain, country, language, domain_rank, page_types, title, snippet, a 6-axis sentiment object (anger, happiness, love, sadness, share, fun), a connotation split, rating, text_category, and date_published — all in one unified JSON shape.

How does pagination work on the search endpoint?

Search is cursor-paginated. Pass cursor and read next_cursor from the response to fetch the next page; next_cursor is omitted, not null, when there are no more pages. The total field is the global match count, not the page size, so it can run into the millions.

Can I filter mentions by page type?

Yes. Use page_type with a CSV of ecommerce, news, blogs, message-boards, or organization to narrow the feed to those source kinds. You can also pass search_mode, limit, order_by, and an advanced filters expression to scope results further.

How much does the brand mention search cost?

Each search request costs 5 credits on the advanced tier, regardless of how many mentions return on the page. New accounts get 100 free credits with no credit card required, so you can test keywords and filters before you pay anything.

100 free credits — no credit card required

Content Analysis Search API

Name: Content Analysis Search API
Brand: SocialCrawl
Availability: InStock

Scrape Content Analysis Search data with one API call. Returns paginated web citations (news, blogs, ecommerce, message-boards, organization pages) that mention the keyword, each scored on a 6-axis emotional sentiment model (anger, happiness, love, sadness, share, fun) plus positive/negative/neutral connotation probabilities. This is web-wide brand listening over DataForSEO's citation database — page-level mentions, not native platform posts. Cursor-paginated via `cursor`; `total` is the global match count, not the page size.

Start for free View Documentation

Try the Content Analysis Search API

See real data before writing a single line

GET/v1/content_analysis/search

keywordrequired

Brand or term to find mentions of. Wrap in escaped double-quotes for an exact phrase (e.g. "logitech mouse").

6 optional parameters

page_type

Narrow to one or more page types (comma-separated): ecommerce, news, blogs, message-boards, organization. Translated to a page_types filter upstream.

search_mode

as_is (default) returns every matching page; one_per_domain dedupes to the top page per domain.

limit

Number of citations to return per page (1–1000, default 10).

cursor

Opaque pagination cursor — pass the `next_cursor` from the previous response to fetch the next page.

order_by

Sort rules as "field,direction"; separate multiple rules with ";" (e.g. content_info.sentiment_connotations.anger,desc).

filters

Advanced DataForSEO filter expression as a JSON array (≤8 conditions). Combined with page_type via AND when both are present.

Searching 35 platforms in parallel

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Rumble·

Spotify·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

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·

Rumble·

Spotify·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

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·

Rumble·

Spotify·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

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·

Rumble·

Spotify·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·UUtility·

Universal Search

Content Analysis API

What can you do with the Search API?

The Search endpoint gives you structured Content Analysis data with computed fields in a single request. No scraping infrastructure to build or maintain.

Example Request

GET /v1/content_analysis/search?keyword=openai

Parameters

Parameter	Required	Description
keyword	Yes	Brand or term to find mentions of. Wrap in escaped double-quotes for an exact phrase (e.g. "logitech mouse").
page_type	No	Narrow to one or more page types (comma-separated): ecommerce, news, blogs, message-boards, organization. Translated to a page_types filter upstream. (ecommerce \| news \| blogs \| message-boards \| organization)
search_mode	No	as_is (default) returns every matching page; one_per_domain dedupes to the top page per domain. (as_is \| one_per_domain)
limit	No	Number of citations to return per page (1–1000, default 10).
cursor	No	Opaque pagination cursor — pass the `next_cursor` from the previous response to fetch the next page.
order_by	No	Sort rules as "field,direction"; separate multiple rules with ";" (e.g. content_info.sentiment_connotations.anger,desc).
filters	No	Advanced DataForSEO filter expression as a JSON array (≤8 conditions). Combined with page_type via AND when both are present.

API Details

How does the Content Analysis Search 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 Content Analysis Search data?

We handle the complexity of Content Analysis 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 Content Analysis — 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 35 platforms covering 10B+ monthly active users.

One schema, every platform

Query 35 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.

No code required

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"
    }
  }
}

+ 35 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 Content Analysis Search data?

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

Start for free