Skip to content

Commit 5cc3d23

Browse files
author
Burak Bayır
authored
Merge pull request #5 from Xquik-dev/release-please--branches--main--changes--next
release: 0.4.0
2 parents 3b366af + cb52b50 commit 5cc3d23

267 files changed

Lines changed: 3433 additions & 9949 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.release-please-manifest.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
{
2-
".": "0.3.0"
2+
".": "0.4.0"
33
}

‎.stats.yml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
configured_endpoints: 117
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/xquik%2Fx-twitter-scraper-d40c57a05527faf060d21c0e013729f371d88017b10680cea7c8fd6780ffaef5.yml
3-
openapi_spec_hash: 597ebc460cf86740b9f6f7c95478dece
4-
config_hash: 30ce23c9cfbf8fb8be9e5dd28a2124fa
1+
configured_endpoints: 110
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/xquik%2Fx-twitter-scraper-2adc33156b4b42a4be18cc20c0205b38f0432d7958da99c65ee9b3f6a555ea0e.yml
3+
openapi_spec_hash: be760f5620a268521d6793f65576a61f
4+
config_hash: 320a9cb2f1293d1a7b73c63ab5865af5

‎CHANGELOG.md‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,32 @@
11
# Changelog
22

3+
## 0.4.0 (2026-04-25)
4+
5+
Full Changelog: [v0.3.0...v0.4.0](https://github.com/Xquik-dev/x-twitter-scraper-java/compare/v0.3.0...v0.4.0)
6+
7+
### Features
8+
9+
* **api:** api update ([30c1879](https://github.com/Xquik-dev/x-twitter-scraper-java/commit/30c1879055bd1a7fb925a8dc674fbbd932c29f9f))
10+
* **api:** api update ([5e2cc73](https://github.com/Xquik-dev/x-twitter-scraper-java/commit/5e2cc73283addfe9ac177efb47623c0f51dedf8e))
11+
* **api:** api update ([6022295](https://github.com/Xquik-dev/x-twitter-scraper-java/commit/6022295c6a25bd0b0797c85ae96304cc3eeb2103))
12+
* **api:** api update ([d4c753a](https://github.com/Xquik-dev/x-twitter-scraper-java/commit/d4c753ab0a9ee134dc567e576dac2892407e7e29))
13+
14+
15+
### Bug Fixes
16+
17+
* escape ampersand in OpenAPI summaries for C# XML docs ([fb78c9a](https://github.com/Xquik-dev/x-twitter-scraper-java/commit/fb78c9aea1252be7535e3b5efcc5f916805831d4))
18+
19+
20+
### Chores
21+
22+
* sync OpenAPI spec ([c225ad8](https://github.com/Xquik-dev/x-twitter-scraper-java/commit/c225ad8eb377c71093ce3f9b5292257ce191ed3a))
23+
* wire production_repo for all targets ([1a3de89](https://github.com/Xquik-dev/x-twitter-scraper-java/commit/1a3de8994dc023e9602bc359a0f5067f03082e9a))
24+
25+
26+
### Documentation
27+
28+
* add Contributor Covenant 2.1 Code of Conduct ([#2192](https://github.com/Xquik-dev/x-twitter-scraper-java/issues/2192)) ([afb97b0](https://github.com/Xquik-dev/x-twitter-scraper-java/commit/afb97b0d326a8ff3602f871cd12daa63c7a3d847))
29+
330
## 0.3.0 (2026-04-08)
431

532
Full Changelog: [v0.2.0...v0.3.0](https://github.com/Xquik-dev/x-twitter-scraper-java/compare/v0.2.0...v0.3.0)

‎README.md‎

Lines changed: 18 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -2,40 +2,39 @@
22

33
[![Ask DeepWiki](https://deepwiki.com/badge.svg?url=https%3A%2F%2Fgithub.com%2FXquik-dev%2Fx-twitter-scraper-java)](https://deepwiki.com/Xquik-dev/x-twitter-scraper-java)
44

5-
> Maven Central publication is pending. Build from source until the
6-
> `com.x_twitter_scraper.api:x-twitter-scraper-java` artifact resolves in Maven
7-
> Central.
5+
[![Maven Central](https://img.shields.io/maven-central/v/com.x_twitter_scraper.api/x-twitter-scraper-java)](https://central.sonatype.com/artifact/com.x_twitter_scraper.api/x-twitter-scraper-java/0.4.0)
6+
[![javadoc](https://javadoc.io/badge2/com.x_twitter_scraper.api/x-twitter-scraper-java/0.4.0/javadoc.svg)](https://javadoc.io/doc/com.x_twitter_scraper.api/x-twitter-scraper-java/0.4.0)
7+
8+
<!-- x-release-please-end -->
89

910
The X Twitter Scraper Java SDK provides convenient access to the [X Twitter Scraper REST API](https://xquik.com) from applications written in Java.
1011

1112
The X Twitter Scraper Java SDK is similar to the X Twitter Scraper Kotlin SDK but with minor differences that make it more ergonomic for use in Java, such as `Optional` instead of nullable values, `Stream` instead of `Sequence`, and `CompletableFuture` instead of suspend functions.
1213

1314
It is generated with [Stainless](https://www.stainless.com/).
1415

15-
The REST API documentation can be found on [xquik.com](https://xquik.com). Generated Javadocs can be built locally from source.
16-
17-
## Installation
16+
<!-- x-release-please-start-version -->
1817

19-
Maven Central publication is pending. Until registry metadata is live, use a source build instead of Gradle or Maven dependency coordinates.
18+
The REST API documentation can be found on [xquik.com](https://xquik.com). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.x_twitter_scraper.api/x-twitter-scraper-java/0.4.0).
2019

21-
### Source Build
20+
<!-- x-release-please-end -->
2221

23-
```bash
24-
git clone https://github.com/Xquik-dev/x-twitter-scraper-java.git
25-
cd x-twitter-scraper-java
26-
./gradlew build
27-
```
22+
## Installation
2823

29-
### Local Maven Testing
24+
### Gradle
3025

31-
```bash
32-
./gradlew publishToMavenLocal -PpublishLocal
26+
```kotlin
27+
implementation("com.x_twitter_scraper.api:x-twitter-scraper-java:0.4.0")
3328
```
3429

35-
Before restoring Maven Central badges or dependency snippets, verify:
30+
### Maven
3631

37-
```bash
38-
curl -f https://repo1.maven.org/maven2/com/x_twitter_scraper/api/x-twitter-scraper-java/maven-metadata.xml
32+
```xml
33+
<dependency>
34+
<groupId>com.x_twitter_scraper.api</groupId>
35+
<artifactId>x-twitter-scraper-java</artifactId>
36+
<version>0.4.0</version>
37+
</dependency>
3938
```
4039

4140
## Requirements
@@ -82,7 +81,6 @@ import com.x_twitter_scraper.api.client.okhttp.XTwitterScraperOkHttpClient;
8281

8382
XTwitterScraperClient client = XTwitterScraperOkHttpClient.builder()
8483
.apiKey("My API Key")
85-
.bearerToken("My Bearer Token")
8684
.build();
8785
```
8886

@@ -561,21 +559,6 @@ TweetSearchParams params = TweetSearchParams.builder()
561559

562560
These can be accessed on the built object later using the `_additionalHeaders()`, `_additionalQueryParams()`, and `_additionalBodyProperties()` methods.
563561

564-
To set undocumented parameters on _nested_ headers, query params, or body classes, call the `putAdditionalProperty` method on the nested class:
565-
566-
```java
567-
import com.x_twitter_scraper.api.core.JsonValue;
568-
import com.x_twitter_scraper.api.models.integrations.IntegrationCreateParams;
569-
570-
IntegrationCreateParams params = IntegrationCreateParams.builder()
571-
.config(IntegrationCreateParams.Config.builder()
572-
.putAdditionalProperty("secretProperty", JsonValue.from("42"))
573-
.build())
574-
.build();
575-
```
576-
577-
These properties can be accessed on the nested built object later using the `_additionalProperties()` method.
578-
579562
To set a documented parameter or property to an undocumented or not yet supported _value_, pass a [`JsonValue`](x-twitter-scraper-java-core/src/main/kotlin/com/x_twitter_scraper/api/core/Values.kt) object to its setter:
580563

581564
```java

‎build.gradle.kts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ repositories {
88

99
allprojects {
1010
group = "com.x_twitter_scraper.api"
11-
version = "0.3.0" // x-release-please-version
11+
version = "0.4.0" // x-release-please-version
1212
}
1313

1414
subprojects {

‎buildSrc/src/main/kotlin/x-twitter-scraper.publish.gradle.kts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ configure<MavenPublishBaseExtension> {
4343

4444
pom {
4545
name.set("Xquik API")
46-
description.set("Xquik is an all-in-one X (Twitter) automation API with 40+ endpoints for\nreading, writing, and monitoring X data. **Read endpoints** let you look up\ntweets, search tweets, fetch user profiles, list followers & following, browse\ntimelines, bookmarks, notifications, communities, lists, trending topics, and\ndownload media. **Write endpoints** let you post tweets, reply, like, unlike,\nretweet, unretweet, follow, unfollow, send DMs, upload media, update profiles,\nand manage communities. **Automation endpoints** power bulk data extractions (20\ntool types), giveaway draws from tweet replies, real-time account monitoring\nwith webhooks & Telegram integrations, tweet composition with AI, and writing\nstyle analysis. Authenticate with an API key or OAuth 2.1 bearer token.\nPay-per-use endpoints are also available without an account.")
46+
description.set("Look up any tweet, user, or trend on X. Search tweets, check follower\nrelationships, download media, and monitor accounts in real time. 32 pay-per-use\nread endpoints work without a subscription — just pay per call. Write endpoints\n(post, like, retweet, follow, DM) and automation endpoints (bulk extractions,\ngiveaway draws, monitors, webhooks) require an API key or OAuth 2.1 bearer\ntoken.")
4747
url.set("https://xquik.com")
4848

4949
licenses {

‎x-twitter-scraper-java-core/src/main/kotlin/com/x_twitter_scraper/api/client/XTwitterScraperClient.kt‎

Lines changed: 18 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,12 @@ package com.x_twitter_scraper.api.client
55
import com.x_twitter_scraper.api.core.ClientOptions
66
import com.x_twitter_scraper.api.services.blocking.AccountService
77
import com.x_twitter_scraper.api.services.blocking.ApiKeyService
8-
import com.x_twitter_scraper.api.services.blocking.BotService
98
import com.x_twitter_scraper.api.services.blocking.ComposeService
109
import com.x_twitter_scraper.api.services.blocking.CreditService
1110
import com.x_twitter_scraper.api.services.blocking.DraftService
1211
import com.x_twitter_scraper.api.services.blocking.DrawService
1312
import com.x_twitter_scraper.api.services.blocking.EventService
1413
import com.x_twitter_scraper.api.services.blocking.ExtractionService
15-
import com.x_twitter_scraper.api.services.blocking.IntegrationService
1614
import com.x_twitter_scraper.api.services.blocking.MonitorService
1715
import com.x_twitter_scraper.api.services.blocking.RadarService
1816
import com.x_twitter_scraper.api.services.blocking.StyleService
@@ -59,25 +57,25 @@ interface XTwitterScraperClient {
5957
*/
6058
fun withOptions(modifier: Consumer<ClientOptions.Builder>): XTwitterScraperClient
6159

62-
/** Account info & settings */
60+
/** Account info and settings */
6361
fun account(): AccountService
6462

6563
/** API key management (session auth only) */
6664
fun apiKeys(): ApiKeyService
6765

68-
/** Subscription & billing */
66+
/** Subscription, billing, and credits */
6967
fun subscribe(): SubscribeService
7068

71-
/** Tweet composition, drafts, writing styles & radar */
69+
/** AI tweet composition, drafts, writing styles, and radar */
7270
fun compose(): ComposeService
7371

74-
/** Tweet composition, drafts, writing styles & radar */
72+
/** AI tweet composition, drafts, writing styles, and radar */
7573
fun drafts(): DraftService
7674

77-
/** Tweet composition, drafts, writing styles & radar */
75+
/** AI tweet composition, drafts, writing styles, and radar */
7876
fun styles(): StyleService
7977

80-
/** Tweet composition, drafts, writing styles & radar */
78+
/** AI tweet composition, drafts, writing styles, and radar */
8179
fun radar(): RadarService
8280

8381
/** Real-time X account monitoring */
@@ -92,23 +90,17 @@ interface XTwitterScraperClient {
9290
/** Giveaway draws from tweet replies */
9391
fun draws(): DrawService
9492

95-
/** Webhook endpoint management & delivery */
93+
/** Webhook endpoint management and delivery */
9694
fun webhooks(): WebhookService
9795

98-
/** Push notification integrations (Telegram) */
99-
fun integrations(): IntegrationService
100-
101-
/** X data lookups (subscription required) */
10296
fun x(): XService
10397

104-
/** Trending topics by region */
98+
/** Trending topics and hashtags by region */
10599
fun trends(): TrendService
106100

107-
fun bot(): BotService
108-
109101
fun support(): SupportService
110102

111-
/** Subscription & billing */
103+
/** Subscription, billing, and credits */
112104
fun credits(): CreditService
113105

114106
/**
@@ -138,25 +130,25 @@ interface XTwitterScraperClient {
138130
modifier: Consumer<ClientOptions.Builder>
139131
): XTwitterScraperClient.WithRawResponse
140132

141-
/** Account info & settings */
133+
/** Account info and settings */
142134
fun account(): AccountService.WithRawResponse
143135

144136
/** API key management (session auth only) */
145137
fun apiKeys(): ApiKeyService.WithRawResponse
146138

147-
/** Subscription & billing */
139+
/** Subscription, billing, and credits */
148140
fun subscribe(): SubscribeService.WithRawResponse
149141

150-
/** Tweet composition, drafts, writing styles & radar */
142+
/** AI tweet composition, drafts, writing styles, and radar */
151143
fun compose(): ComposeService.WithRawResponse
152144

153-
/** Tweet composition, drafts, writing styles & radar */
145+
/** AI tweet composition, drafts, writing styles, and radar */
154146
fun drafts(): DraftService.WithRawResponse
155147

156-
/** Tweet composition, drafts, writing styles & radar */
148+
/** AI tweet composition, drafts, writing styles, and radar */
157149
fun styles(): StyleService.WithRawResponse
158150

159-
/** Tweet composition, drafts, writing styles & radar */
151+
/** AI tweet composition, drafts, writing styles, and radar */
160152
fun radar(): RadarService.WithRawResponse
161153

162154
/** Real-time X account monitoring */
@@ -171,23 +163,17 @@ interface XTwitterScraperClient {
171163
/** Giveaway draws from tweet replies */
172164
fun draws(): DrawService.WithRawResponse
173165

174-
/** Webhook endpoint management & delivery */
166+
/** Webhook endpoint management and delivery */
175167
fun webhooks(): WebhookService.WithRawResponse
176168

177-
/** Push notification integrations (Telegram) */
178-
fun integrations(): IntegrationService.WithRawResponse
179-
180-
/** X data lookups (subscription required) */
181169
fun x(): XService.WithRawResponse
182170

183-
/** Trending topics by region */
171+
/** Trending topics and hashtags by region */
184172
fun trends(): TrendService.WithRawResponse
185173

186-
fun bot(): BotService.WithRawResponse
187-
188174
fun support(): SupportService.WithRawResponse
189175

190-
/** Subscription & billing */
176+
/** Subscription, billing, and credits */
191177
fun credits(): CreditService.WithRawResponse
192178
}
193179
}

0 commit comments

Comments
 (0)