How do I find the filterable fields for content analysis?

Send a GET request to /v1/content_analysis/filters. You get the map of every filterable field and the value type each expects, so you can build the advanced filters expression that search and summary accept for precise brand mention queries.

What does the filters endpoint return?

It returns a field-to-type map: each filterable field paired with the kind of value it takes. Use it as the reference for constructing the filters parameter — a JSON array of conditions — when page_type alone is not specific enough.

How do I use the filters in a search?

Pass an advanced filters expression as a JSON array (up to eight conditions) to the search or summary endpoint. The filters endpoint tells you which fields are valid and what value types they expect, so your expression is accepted on the first try.

Is the filters map static or live?

It is static reference data, not a live mention query. The field map changes rarely, so SocialCrawl caches it and repeat calls are effectively free in practice. Fetch it once, build your filter expressions, and reuse them.

How much does the filters endpoint cost?

Filters is a standard-tier reference endpoint at 1 credit per call, versus 5 credits for the analytic endpoints. New accounts get 100 free credits with no credit card required, so you can pull the field map at no real cost.

100 free credits — no credit card required

Content Analysis Filters API

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

Scrape Content Analysis Filters data with one API call. Returns the map of filterable fields → value types (str, num, time, array.num, array.str) accepted by the advanced `filters` param on the search/summary/sentiment endpoints. Use it to build valid filter expressions. Heavily cached.

Start for free View Documentation

Try the Content Analysis Filters API

See real data before writing a single line

GET/v1/content_analysis/filters

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 Filters API?

The Filters 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/filters

API Details

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

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

Start for free