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 (739e7ff)
• api: api update (8d82368)
• api: api update (3a5a9e7)
• api: api update (5000bc9)

Bug Fixes

• tests: round-trip urls correctly (1773360)

Chores

• sync OpenAPI spec (9ad82a2)
• wire production_repo for all targets (3eb0d89)

---

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 new account health fields, radar model expansion, and security option simplification

• XAccount, XAccountDetail, AccountCreateResponse, and AccountReauthResponse now expose a typed Health enum property; responses also gain CreatedAt, XUserID, and optional LoginCountry fields
• RadarItem gains required ID, CreatedAt, Language, sourceId, and metadata fields; Category and Source are now strongly-typed enums (RadarItemCategory, RadarItemSource)
• RadarRetrieveTrendingTopicsParams replaces Count with After/limit pagination and an enum-backed Category; the response replaces Total with HasMore and NextCursor
• AccountRetrieveResponse renames CurrentPeriod to CreditInfo with new fields (AutoTopupEnabled, Balance, lifetimePurchased, lifetimeUsed); callers accessing CurrentPeriod will break
• TweetCreateParams makes Text optional and adds a Media array body field
• ParamsBase.QueryString and AddDefaultHeaders drop the SecurityOptions parameter; headers are now added whenever ApiKey/BearerToken are present on ClientOptions
• IXTwitterScraperClient removes the Bot and Integration service properties; ErrorError removes StreamRegistrationFailed/UsageLimitReached and adds InsufficientCredits/NoCredits; EventType removes follower.gained and follower.lost
• Risk: multiple breaking model and API surface changes (CurrentPeriod → CreditInfo, removed enum values, removed services, required Health fields)

^{Macroscope summarized 04f94c2.}

[greptile-apps]

Too many files changed for review. (309 files found, 200 file limit)

[stainless-app]

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