Get up and running with the Modash API in minutes. Integrate influencer discovery, audience analytics, and content data directly into your own applications - and unlock the same powerful data that drives the Modash platform, programmatically.
Getting your API key
Log in to your Modash account.
Go to the Developer Portal.
Copy your API key.
Your API key authenticates all requests. Keep it secure and never expose it in client-side code or public repositories.
Authentication
All API requests require your API key. The recommended method is a Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_KEY
You can also pass your key as a body parameter or query parameter (access_token). See the Authentication and rate limits guide for all supported methods.
Include authentication with every request. Requests without a valid key return an authentication error.
Your first API call
A great starting point is the Discovery search endpoint:
POST <https://api.modash.io/v1/discovery/search>
Headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Body:
{
"page": 0,
"limit": 15,
"sort": { "field": "followers", "direction": "desc" },
"filter": {
"influencer": {
"relevance": ["#fitness"]
}
}
}
This searches for creators related to #fitness, sorted by follower count. The response includes profile data, follower counts, engagement rates, and more.
💡 Start with simple searches using just one or two filters. Add more filters gradually as you get comfortable with the response format and available fields.
Available APIs
Modash offers two APIs:
Discovery API: Search and filter 250M+ influencer profiles. Get audience demographics, engagement rates, past brand collaborations, and more. Best for building search features, reporting, and analysis. Priced per credit.
RAW API: Access live, raw social media data. Fetch real-time posts, Stories, comments, and metrics for any public profile. Best for campaign monitoring and data enrichment. Priced per request.
Both APIs share the same authentication method and base URL.
💡 You can learn more at https://docs.modash.io/
Checking API health and usage
Health check:
GET /healthreturns{"status": "ok"}when the API is onlineAccount info:
GET /accountshows your remaining Discovery credits and RAW API requests
Use these endpoints to monitor your integration and stay within your quota.
Key things to know
Filters are passed in the JSON body for POST calls, not as query parameters.
Discovery API covers Instagram and TikTok profiles with roughly 1,000+ followers, and YouTube profiles with roughly 1,000+ subscribers and 5,000+ average views.
RAW API has no follower thresholds and returns data for any accessible public profile.
For complete endpoint documentation, filter schemas, and response formats, visit docs.modash.io. If you need help getting started, email hello+api@modash.io.
FAQs
FAQs
Do I need a special plan to access the API?
Yes. API access requires an API plan, which is separate from the standard Modash platform plans. Contact Modash sales or visit the API page on the website for pricing details.
Can I test the API before committing to a plan?
Contact Modash to discuss trial access. The team can help you evaluate the API for your specific use case.
What programming languages are supported?
The Modash API is a standard REST API, so it works with any language that can make HTTP requests. The documentation includes curl examples that you can adapt to your preferred language.
How do I handle rate limits?
Implement retry logic with exponential backoff. When you receive a rate limit response, wait before retrying. The response headers include information about your remaining quota.
Where can I find the full API documentation?
Visit docs.modash.io for complete documentation including all endpoints, filter schemas, response formats, and code examples.
What symbols are supported in API calls?
API does not accept international symbols like é, ů and others. Only use latin letters in your API calls.