# Content Analysis Search API (https://www.socialcrawl.dev/platforms/content_analysis/search)

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

TL;DR: `GET /v1/content_analysis/search` costs 20 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## 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–100, default 10). Paginate via `cursor` for more. |
| `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. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/content_analysis/search?keyword=openai" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### 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.

See the full Content Analysis API: https://www.socialcrawl.dev/platforms/content_analysis

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get a feed of web mentions for a brand with the SocialCrawl API
- What fields does the SocialCrawl content analysis search return?