release: 0.4.0

[stainless-app]

Automated Release PR

0.4.0 (2026-04-22)

Full Changelog: v0.3.0...v0.4.0

Features

• api: api update (7f6712d)
• api: api update (38a6e86)
• api: api update (eb69342)
• api: api update (9c70dea)
• api: api update (4e3a8cc)
• api: api update (1ef9218)
• api: api update (2c678ad)
• api: api update (6506668)
• api: api update (9c2ff12)
• api: api update (3250f4f)
• api: api update (3338eb1)

Bug Fixes

• client: properly generate file params (6e91c34)
• client: resolve serialization issue with unions and enums (52667e8)
• populate enum-typed properties with enum instances (f464198)

Chores

• sync OpenAPI spec (20c9888)
• update SDK settings (7764da9)
• wire production_repo for all targets (a8f180d)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

Note

Release v0.4.0 with typed paginated responses, account health, FileParam uploads, and new community/trends APIs

• All list endpoints (tweets, users, bookmarks, lists, communities) now return PaginatedTweets or PaginatedUsers instead of endpoint-specific response types; user retrieval returns UserProfile and single-resource endpoints return flattened detail types (e.g. XAccountDetail, DraftDetail, EventDetail)
• XAccount, XAccountDetail, AccountNewResponse, and AccountReauthResponse now include a required health property validated against a new Health enum with six states (healthy, locked, needs_reauth, recovering, suspended, temporary_issue)
• FileParam class added to src/Core/FileParam.php enabling file uploads via fromString() or fromResource(); accepted by media upload, avatar/banner update, and profile methods
• New APIs added: AccountsService::bulkRetry(), TweetsService::listByCommunity(), XService::getTrends() with count/woeid params returning typed XGetTrendsResponse
• RadarRetrieveTrendingTopicsParams switches from count to limit, adds after cursor, and accepts typed Category/Source enums; response switches from total to hasMore/nextCursor cursor-based pagination
• Client always sends both API key and bearer auth headers and no longer accepts a per-request security array; IntegrationsService and BotService are removed from the client
• EventType enum removes follower.gained and follower.lost cases; Error enum replaces stream_registration_failed/usage_limit_reached with insufficient_credits/no_credits
• Risk: multiple breaking interface changes across contracts, parameter renames ($tweetID→$id, $username→$id), and removed response wrapper types require callers to update type hints and construction patterns

^{Macroscope summarized 3907056.}

[stainless-app]

🤖 Release is at https://github.com/Xquik-dev/x-twitter-scraper-php/releases/tag/v0.4.0 🌻