# Modash.io API ## Table of contents - [info.md](https://docs.modash.io/products/raw_api/docs/info.md) - [Testing the API](https://docs.modash.io/products/discovery_api/docs/info.md) - [Overview](https://docs.modash.io/products/discovery_api/openapi_doc/discovery.md): Discovery API provides powerful products for different use cases. Let us provide a brief overview: Search allows you to build comprehensive search experience to find creators. Use filters, lookalikes and our dictionaries and lists to create stunning user interfaces. Reports provide in depth analytics that include audience demographics, performance metrics, sponsored posts and much more. Our collaborations products enable you to create overviews of past brand partnerships between creators and brands. There is more: Search by Email allows you to lookup which creator accounts are associated with an emails and audience overlap identifies the uniqueness of an audience with ease. # Testing the API ## Search You can test out the [Instagram Search API](#tag/Instagram/paths/~1instagram~1search/post) for free by leaving the filter object empty. Your request body should look similar to this. ``` > POST https://api.modash.io/v1/instagram/search { "sort": { "field": "followers", "direction": "desc" }, "filter": { } } ``` ## Reports To test out the [Instagram Reports API](#tag/Instagram/paths/~1instagram~1profile~1{userId}~1report/get) for free you can set the `userId` as `instagram`. Your request should look like this. ``` > GET https://api.modash.io/v1/instagram/profile/instagram/report ``` We recommend always using the report route and caching the result if necessary. Everything that is included in the overview is also in a report. # Pagination When using the Search API, each response has in total 15 influencers. If you wish to query more influencers for the same query you need to increment the `page` parameter in the request body. By default the `page` parameter is set to `0`. # Dictionaries ## Interests, Locations and brands When finding influencers by interests, locations or brands you need to search by their respective ID. To list all interests, locations or brands you need to call the `https://api.modash.io/v1/instagram/interests`, `https://api.modash.io/v1/instagram/locations`, `https://api.modash.io/v1/instagram/brands` route. You can specify the list of interests, locations or brands returned by using the `query` parameter and limit the amount of list items returned by using the `limit` parameter. By default the `limit` parameter is set to `20`. You can query all list items by setting the `limit` parameter to `1000000`. ## Languages Similar to interests, locations and brands, you first need to find the correct language code to search by. This can be done by calling the `https://api.modash.io/v1/instagram/languages` route. - [Modash.io API (1.5.0)](https://docs.modash.io/index.html.md) - [Overview](https://docs.modash.io/products/raw_api/openapi_doc/raw.md): RAW API endpoints return **real-time, unfiltered data** data from public social media profiles on Instagram, TikTok, and YouTube. Use them to access profiles, content, comments, tags, and hashtag feeds — exactly as they appear on the platforms. These endpoints are ideal for custom analytics, live monitoring, or building your own enrichment workflows. > ⚠️ Data is returned as-is, without filtering. Handle rate limits and pagination as needed. Read the Raw API Best Practices guide →