Want deep creator data at your fingertips? The RAW API gives you detailed profile data for specific creators - audience reports, engagement metrics, content history, and more - across Instagram, TikTok, and YouTube.
Key endpoints and use cases
The RAW API is built for getting deep data on specific creators:
Profile data: Follower counts, engagement rates, bio information, and content samples
Audience demographics: Age, gender, location, language, and interests of a creator's followers
Audience credibility: Fake follower detection and credibility scores
Growth trends: Historical follower growth and engagement patterns
Brand collaborations: Past sponsored content and brand partnerships
Use the RAW API when you need to vet specific creators, build internal databases, or power custom dashboards with real-time creator data.
Per-request limits
Each RAW API request returns data for a single creator profile. The amount of data depends on the endpoint:
Basic profile data: included with every request.
Audience demographics: requires an unlocked profile or uses a credit.
Historical data: available for unlocked profiles.
Plan your requests to get the data you need without unnecessary API calls.
Rate limit handling
When you hit rate limits, implement exponential backoff:
Catch the 429 (Too Many Requests) response.
Wait 1 second before retrying.
If the retry also fails, double the wait time (2s, 4s, 8s...).
Set a maximum number of retries (for example, 5 attempts) to avoid infinite loops.
Pagination
For endpoints that return lists (like content history), use pagination tokens:
Check the response for a
nexttoken.Include the token in your next request to get the following page.
Continue until no
nexttoken is returned.Don't assume a fixed number of pages. Always check for the token.
💡 The RAW API fetches data directly from social platforms at the time of your request, so you're always getting the latest available information. Cache results locally when real-time freshness isn't critical to save your request quota.
Combining with Discovery API
The most powerful integrations use both APIs together:
Discovery API to search and filter creators matching your criteria.
RAW API to get detailed profile data for the creators you want to evaluate.
This workflow lets you efficiently find and vet creators at scale without wasting API credits on profiles that don't match your needs. It's the same approach that powers Modash's own Discover tool - now available programmatically.
FAQs
FAQs
What platforms does the RAW API support?
Instagram, TikTok, and YouTube. Each platform has slightly different data available.
How fresh is the data I get from the RAW API?
The RAW API fetches live data directly from social platforms at the time of your request, so you're always getting the latest available information.
Does fetching a profile use a credit?
It depends on the endpoint and whether the profile is already unlocked. Check the API documentation for credit usage per endpoint.
Can I get data for private accounts?
No. The RAW API can only access publicly available profile data.
What happens if I request a profile that isn't in the database?
You'll receive a 404 response. You can request that the profile be added, and it typically takes about 48 hours for new profiles to become available.
Is there a bulk endpoint for multiple profiles?
Check the API documentation for batch endpoints. Some data can be requested in bulk to reduce the number of individual API calls.
Why is the video_url field missing from some Instagram carousel items?
The
video_urlfield incarousel_mediais optional and won't always be present, even for carousel items that contain videos. Your integration should handle this field gracefully when it's absent.