Skip to main content

API Changelog

Stay up to date with the latest changes to the Modash Discovery and Raw APIs.

Written by Donna

September 2026

New Features

  • Stories in Collaborations (Discovery API): Stories are now available to all API customers. Within a brand collaboration, you can filter posts by type, including story_original and story_reshared.

    • Coverage is limited to stories collected in 2026, with new sponsored stories added weekly.

  • Post classification (feed_type): Optional feed_type on Collaborations posts (Instagram: feed | reels; null elsewhere). Combine with type for full post classification.

  • Followers growth filter (AI Search): followersGrowthRate is now supported on the /ai/* endpoints for Instagram, TikTok, and YouTube. Takes an interval (i1month–i6months) plus min and/or max as a decimal fraction (0.05 = 5%); at least one bound required. Text search and lookalikes profiles return followersGrowthRate (defaults to i6months), omitted when no rate is available.

Improvements

  • Reports: recentPosts[].thumbnail is now returned for all platforms (previously, YouTube only). Appears gradually, with full coverage after ~30 days due to report caching.

Breaking Changes

  • Search: query can no longer be combined with username. Requests doing so return: "Username filter and other filters cannot be used together. Please use only one of them."

  • Instagram Reports: recentPosts[].id, popularPosts[].id, and sponsoredPosts[].id now return the Instagram post ID instead of an internal ID (e.g. 3769455982611575129_173560420 → DRPzD6oCLFZ).

August 2026

New Features

  • List filters for AI Search (Discovery API): Include or exclude your own influencer lists directly in AI Search across Instagram, TikTok, and YouTube.

    • Include mode: return only creators from a specific list that match the query.

    • Exclude mode: remove creators already on a list (e.g., to avoid duplicate outreach).

    • Limits: up to 20,000 active lists per account, 70,000 creators per list; one list per AI Search request for now.

    • Full list management via API: create, add/remove members by platform user ID, view lists and metadata, and delete.

Improvements

  • Bio & captions filters: Now accept up to 10 phrases; a profile matches if at least one phrase matches.

  • YouTube AI Search: Responses now expose the YouTube video title on matched posts.

July 2026

New Features

  • Full-text bio & captions filters (AI Search): Filter on exact text in a creator's bio or captions. On YouTube, the caption filter searches title and description, so the filter is named keywords.

  • Multi-creator Lookalikes: Specify 1–5 source users and get lookalikes that blend the traits of all of them (previously one user only). Includes minor parameter renaming to reflect the change.

Deprecations

  • TikTok Media Download (Raw API) is deprecated in favor of TikTok Media Download URL. The old endpoint had video size limitations and returned the video file directly; the new endpoint returns a download URL that expires 24 hours after the request.

June 2026

New Features

  • Hashtags & mentions filters (AI Search): Include and exclude specific hashtags and @mentions, plus new dictionary endpoints for popular tags and mentions. Mentions are not supported on YouTube (the filter is skipped for that platform).

  • Average views filter (AI Search): Filter creators by average views using mean or median, across Instagram, TikTok, and YouTube.

Notes

  • Both filters are live with no integration changes required and work alongside existing AI Search filters.

May 2026

Deprecations

  • Legacy Collaborations endpoints removed. Following the August 2025 Collaborations overhaul and full customer migration, the old endpoints have been taken out of service.

April 2026

New Features

  • brand_id: Now returned across collaborations, sponsored posts, reports, and brand dictionary responses. Sponsor accounts belonging to the same brand share a brand_id; use the Brand Dictionary endpoint to retrieve all associated accounts.

  • API status page: status.modash.io is live, powered by the public /health endpoint, with Slack, email, and RSS subscriptions. Raw API status is not covered yet.

Improvements

  • Collaboration & sponsored posts data quality: More accurate sponsored post detection with fewer false positives, plus richer collaboration data.

March 2026

New Features

  • Creator Lookalikes (Discovery API): Find creators similar to a given creator by content style, same-platform or cross-platform.

    • Endpoints: POST /ai/instagram/lookalikes, POST /ai/tiktok/lookalikes, POST /ai/youtube/lookalikes.

    • targetPlatform in the request body controls where lookalikes are searched.

    • Accepts a source user ID or username; standard filters (followers, location, engagement rate, etc.) can be layered on top.

Improvements

  • TikTok AI text search upgraded: Now generates a holistic creator description by synthesizing content themes, captions, posting patterns, and creator identity, matching the Instagram and YouTube behavior. No endpoint changes, no migration; image search unchanged.

Pricing

  • AI Search now bills per result, not per request. Each result costs 0.025 credits (the default 6 results still cost 0.15 credits). Up to 50 results can now be retrieved in a single request. Applies to Lookalikes, too.

February 2026

New Features

  • Collaborations Posts: two new fields (Instagram, TikTok, YouTube):

    • brand_category: Industry category of the sponsor/brand (e.g., Retail, Technology, Travel).

    • collaboration_type: How the partnership was structured: Paid, Gifted, Ambassador, Affiliate, or Unspecified.

Improvements

  • Sponsor coverage: Significant improvements to sponsor detection across all supported platforms.

  • Error handling (/collaborations/posts, /collaborations/summary): When a matched account has no identified collaboration posts, the API now returns 404 posts_not_found instead of a 500. This distinguishes it from account_not_found, and these requests are non-billable.

January 2026

New Features

  • Sponsorship classification (label): Collaboration posts now indicate how a collaboration was identified:

    • Properly Disclosed: Explicit flags such as "Paid Partnership" or #ad.

    • Unclear or Vague: Mentions a sponsor without formal disclosure.

    • Likely Hidden: No clear disclosure, but indicators such as coupon codes, known co-authors, or brand shout-outs.

  • Sponsor username: New field returns the brand's direct handle automatically.

  • Precision time filtering: Filter collaboration posts by specific time intervals via postCreationTimestampMs.

Improvements

  • AI Search v2 (Instagram, then YouTube): Text-based AI search now analyses creator identity holistically (bio, captions, content themes, posting patterns) rather than matching individual posts. Default for all Discovery API users, with no code changes and no impact on billing or credit usage. TikTok followed in March 2026.

    • Tip: frame queries as "<creator type> focusing on <content>" rather than visual keywords.

  • Larger collaboration index: Instagram +32%, TikTok +37%, YouTube +100% identified sponsored content.

  • Rate limiting: Rate limiting now includes a burst budget, so short bursts above your per-second limit are processed instead of rejected.

December 2025

New Features

  • YouTube AI Search (Discovery API): Text-based AI Search is now available for YouTube, covering 3.3M YouTube creators.

  • New AI Search filters:

    • username: target specific handles within AI search queries.

    • maxPostAgeMonths: limit content age (3, 6, 9, or 12 months) to find active creators.

    • Audience credibility: filter out profiles with a high share of fake followers (Instagram only).

Improvements

  • Index update: TikTok AI Search expanded to 17.7M searchable accounts; Instagram to 12.2M.

  • Sort by relevance: Search results can be sorted by audienceRelevance (IG, TT, YT).

  • Match explanations: Lookalikes responses now include a match object explaining why an influencer was returned (IG, TT).

  • Instagram subdivisions: Subdivision support added to Instagram Reports (similar to City in Location) for deeper geographic granularity.

  • Docs (YouTube Raw API): duration and comments on video info marked optional, since they are unavailable in some cases (e.g. "Premieres in X time" videos).

November 2025

New Features

  • TikTok AI Search (Discovery API): Both text-based and image-based search endpoints are now available.

    • Coverage: 12.6 million TikTok creators (10k+ followers).

  • Collaborations Grouping: Added groupBrandCollaborations boolean field. When true, this allows retrieval of brand-level insights across all platforms.

Improvements

  • Discovery API Data Quality:

    • Search: List Users endpoints (IG, TT, YT) now return a larger set of profiles with more frequent updates.

    • AI Search Database: Expanded from 9.5M to 11.2M profiles.

    • Brand Recognition: Added identification for brands like Ipanema, Crocs, Vileda, SodaStream, Revolut, and BYD.

    • Geographic: Significant increase in location coverage.

    • Language Support: Enhanced reporting support for Chinese (Traditional & Simplified), Indonesian, and Filipino.

  • YouTube Raw API: Added members_only_content error return to indicate if content is locked behind channel memberships.

October 2025

New Features

  • AI Search Live (Discovery API):

    • Now available for Instagram creators (10k+ followers).

    • Supports text and image queries.

    • Cost: 0.15 credits per request.

  • Collaborations API Overhaul:

    • New Capabilities: Query by user ID, username, or profile URL.

    • Metrics: Returns past brand partnership metrics (likes, views, shares).

    • Cost: Reduced to 0.2 credits per request (previously 1 credit).

Raw API Updates

  • YouTube: Video Subtitles endpoint now available.

  • Instagram: Profile Address details added to User Info response.

July 2025

Endpoint Updates

/search

  • Calculation Method: Select median or average (mean) for metrics like ER%, likes, comments, and shares.

  • Audience Relevance: New switch in Influencer filters to toggle between finding lookalikes by Audience or Topics (Content).

/reports

  • Calculation Method: Now supports median or average.

  • Stats by Content Type: Returns average metrics by platform-specific types (e.g., Reels, Shorts, Videos). Note: Optimized for performance over /performance-data.

/hashtags & /health

  • Hashtags: Added support for TikTok and YouTube.

  • Health: Now shows status for all major endpoints.

March 2025

Brand Collaboration Endpoints

Launched new endpoints in Discovery API to analyze influencer partnerships and competitor activity.

  • Instagram & TikTok:

    • Query by influencerId: Access list of brand collaborations.

    • Query by brandId: Retrieve influencers a specific brand has worked with.

  • YouTube:

    • Query by influencerId: Access list of brand collaborations.

  • Specs: 1 credit per request. Returns up to 30 entries per page (min 5), sorted new to old.

February 2025

New Features

  • Negative Search Filters (Discovery API):

    • Introduced Boolean logic (AND, OR, NOT) for filters.

    • Constraint: Logic applies between filters, not within a single filter.

    • Reference: filter.influencer.filterOperations.

  • Health Endpoint: Real-time status (Healthy, Degraded, Unhealthy) based on recent request performance.

Raw API Updates (Instagram)

  • User Following Feed: Returns paginated list of accounts followed by a user.

  • Media Likers: Returns a list of accounts that liked a specific post.

2024

Discovery API

  • Search by Email: Returns IG, TT, and YT social accounts associated with a queried email address.

  • Report Data: Added parity data to match recent filter releases across all platforms.

Raw API

  • TikTok:

    • Added Location Tag property to Media Info response.

    • Added support for Restricted Content in Media Info and Download endpoints.

  • Instagram:

    • Audio Info: New endpoint to lookup a sound and discover videos/creators using that audio.

Did this answer your question?