# Content Analysis Phrase Trends API (https://www.socialcrawl.dev/platforms/content_analysis/phrase-trends)

> Returns a time series (one row per day/week/month bucket) of mention volume and sentiment for the keyword over a date range. Each row is a full summary sub-object (total_count, sentiment, top domains, categories…). Track how a brand's web-wide mentions and sentiment move over time.

TL;DR: `GET /v1/content_analysis/phrase-trends` 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 trend. |
| `date_from` | yes | Start of the date range (yyyy-mm-dd). |
| `date_to` | no | End of the date range (yyyy-mm-dd); defaults to today. |
| `date_group` | no | Bucket size: day, week, or month (default month). (day \| week \| month) |
| `page_type` | no | Narrow to one or more page types (comma-separated): ecommerce, news, blogs, message-boards, organization. (ecommerce \| news \| blogs \| message-boards \| organization) |
| `internal_list_limit` | no | Cap on internal arrays per bucket (1–20). |
| `filters` | no | Advanced DataForSEO filter expression as a JSON array (≤8 conditions). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/content_analysis/phrase-trends?keyword=openai&date_from=2025-01-01" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I track brand mentions over time with an API?

Send a GET request to /v1/content_analysis/phrase-trends with the keyword and a date_from. You get a time series of mention volume and sentiment for that term — bucketed by day, week, or month — so you can chart how the conversation moved across a date range.

### What parameters does phrase-trends take?

keyword and date_from (yyyy-mm-dd) are required. date_to defaults to today, and date_group selects day, week, or month buckets (month is the default). internal_list_limit caps any top-N lists. The response is a series of date-bucketed mention and sentiment points.

### Can I see sentiment change, not just volume?

Yes. Each point in the series carries both mention volume and sentiment, so you can watch whether a spike in mentions was favorable or unfavorable — useful for measuring a launch, a campaign, or a reputation event over time.

### How is phrase-trends different from category-trends?

Phrase-trends keys on a keyword you supply; category-trends keys on a numeric category_code from the categories taxonomy instead. Use phrase-trends to follow a specific brand or term, and category-trends to follow a whole content category over time.

### How much does the phrase trends API cost?

Each phrase-trends request costs 5 credits on the advanced tier. New accounts get 100 free credits with no credit card required, so you can chart mention and sentiment trends for several keywords and date ranges before you pay.

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 track brand mention volume and sentiment over time with the SocialCrawl API
- What is the difference between phrase-trends and category-trends?