# AI Search

AI Search allows you to discover creators using natural language or image queries. Under the hood, it uses vector similarity search to find profiles and content that most closely match the concepts in your prompt. You can also combine these AI queries seamlessly with standard filters.

When to use it: This endpoint is ideal when your criteria go beyond basic metrics. Use it instead of regular Search when you require rich context about a creator's personal identity and niche, or when trying to match a specific visual style.
Choose regular search endpoints when the workflow is mainly filter-based without needing semantic search over post content.

AI Search is limited to creators with more than 10,000 followers.

Available to Discovery API users.

 - [POST /ai/instagram/text-search](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_igtextsearch.md): Find influencers whose posts semantically (what appears in photos and videos) match the text `query`. Put language, locations, and similar criteria in `filters`. `query` does not support negations—use
 - [POST /ai/instagram/image-search](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_igimagesearch.md): Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. Default 1 RPS. Each resulting profile cost
 - [POST /ai/tiktok/text-search](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_tttextsearch.md): Find influencers whose posts semantically (what appears in photos and videos) match the text `query`. Put language, locations, and similar criteria in `filters`. `query` does not support negations—use
 - [POST /ai/tiktok/image-search](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_ttimagesearch.md): Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. Default 1 RPS. Each resulting profile cost
 - [POST /ai/youtube/text-search](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_yttextsearch.md): Find influencers whose posts semantically (what appears in photos and videos) match the text `query`. Put language, locations, and similar criteria in `filters`. `query` does not support negations—use
 - [POST /ai/youtube/image-search](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_ytimagesearch.md): Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. The image is matched against video and sho
 - [POST /ai/instagram/lookalikes](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_iglookalikes.md): Find creators similar to one or more Instagram creators on any platform. Provide 1 to 5 source creator user IDs or usernames in userIds and a target platform. When multiple sources are provided, resul
 - [POST /ai/tiktok/lookalikes](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_ttlookalikes.md): Find creators similar to one or more TikTok creators on any platform. Provide 1 to 5 source creator user IDs or usernames in userIds and a target platform. When multiple sources are provided, results
 - [POST /ai/youtube/lookalikes](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_ytlookalikes.md): Find creators similar to one or more YouTube creators on any platform. Provide 1 to 5 source creator channel IDs or usernames in userIds and a target platform. When multiple sources are provided, resu
 - [GET /ai/brands](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_brandsdictionary.md): Get a list of brands that match the search query. Results from this endpoint are only valid for AI Search filters. Just like other dictionary endpoints, this endpoints costs nothing and there are no s
 - [GET /ai/hashtags](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_hashtagsdictionary.md): Get popular hashtags matching a prefix query for the specified platform. Results are sorted by popularity (number of posts). This endpoint costs nothing and there are no strict rate limits.
 - [GET /ai/mentions](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_mentionsdictionary.md): Get popular mentions matching a prefix query for the specified platform. Results are sorted by popularity (number of posts). YouTube is not supported. This endpoint costs nothing and there are no stri
 - [POST /ai/lists](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_createlist.md): Create an empty list for include/exclude filtering in AI Search. Platform is immutable after create. Each account can have up to 20,000 active lists. If you have a reasonable need for a higher limit,
 - [GET /ai/lists](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_getlists.md): Return metadata for the caller's AI Search lists.<br><br>Does not consume credits.
 - [GET /ai/lists/{listId}](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_getlist.md): Return strongly consistent metadata for a list you own.<br><br>Does not consume credits.
 - [DELETE /ai/lists/{listId}](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_deletelist.md): Hard-delete a list and its members.<br><br>Does not consume credits.
 - [GET /ai/lists/{listId}/members](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_getmembers.md): Paginated platform user IDs in the list. Use this when you need an exact member set or exact count (sum pages); `approximateMemberCount` on metadata is only a fast estimate. Default page size 1000, ma
 - [POST /ai/lists/{listId}/members](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_addmembers.md): Add members by platform user ID only (no usernames). Existing members are no-ops. Max 10,000 unique IDs per request; max 70,000 members per list.<br><br>Does not consume credits.
 - [DELETE /ai/lists/{listId}/members](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchlistscontroller_removemembers.md): Remove members by platform user ID only. Missing members are no-ops. Max 10,000 unique IDs per request.<br><br>Does not consume credits.
 - [POST /ai/text-search](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_textsearch.md): Find influencers whose posts semantically (what appears in photos and videos) match the text `query`. Put language, locations, and similar criteria in `filters`. `query` does not support negations—use
 - [POST /ai/image-search](https://docs.modash.io/products/discovery_api/openapi_doc/discovery/ai-search/aisearchcontroller_imagesearch.md): Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. Default 1 RPS. Each resulting profile cost
