diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 210d290..258342d 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.5.1"
+  ".": "0.5.2"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2011c11..52c83a3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.5.2 (2026-07-23)
+
+Full Changelog: [v0.5.1...v0.5.2](https://github.com/Xquik-dev/x-twitter-scraper-java/compare/v0.5.1...v0.5.2)
+
+### Documentation
+
+* map common X data tasks ([#12](https://github.com/Xquik-dev/x-twitter-scraper-java/issues/12)) ([f3438ea](https://github.com/Xquik-dev/x-twitter-scraper-java/commit/f3438ea480f091967958c158a10fc7722d6298fd))
+
 ## 0.5.1 (2026-07-22)
 
 Full Changelog: [v0.5.0...v0.5.1](https://github.com/Xquik-dev/x-twitter-scraper-java/compare/v0.5.0...v0.5.1)
diff --git a/README.md b/README.md
index dd0d4d6..ed07915 100644
--- a/README.md
+++ b/README.md
@@ -10,8 +10,8 @@ Use Xquik's typed Java client for X data and confirmed actions.
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/com.xquik.api/x-twitter-scraper-java)](https://central.sonatype.com/artifact/com.xquik.api/x-twitter-scraper-java/0.5.1)
-[![Javadocs](https://javadoc.io/badge2/com.xquik.api/x-twitter-scraper-java/0.5.1/javadoc.svg)](https://javadoc.io/doc/com.xquik.api/x-twitter-scraper-java/0.5.1)
+[![Maven Central](https://img.shields.io/maven-central/v/com.xquik.api/x-twitter-scraper-java)](https://central.sonatype.com/artifact/com.xquik.api/x-twitter-scraper-java/0.5.2)
+[![Javadocs](https://javadoc.io/badge2/com.xquik.api/x-twitter-scraper-java/0.5.2/javadoc.svg)](https://javadoc.io/doc/com.xquik.api/x-twitter-scraper-java/0.5.2)
 
 <!-- x-release-please-end -->
 
@@ -36,7 +36,7 @@ Use the linked Javadocs for typed method names.
 Gradle:
 
 ```kotlin
-implementation("com.xquik.api:x-twitter-scraper-java:0.5.1")
+implementation("com.xquik.api:x-twitter-scraper-java:0.5.2")
 ```
 
 Maven:
@@ -45,7 +45,7 @@ Maven:
 <dependency>
   <groupId>com.xquik.api</groupId>
   <artifactId>x-twitter-scraper-java</artifactId>
-  <version>0.5.1</version>
+  <version>0.5.2</version>
 </dependency>
 ```
 
diff --git a/build.gradle.kts b/build.gradle.kts
index a59e713..a3f59f6 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -4,7 +4,7 @@ repositories {
 
 allprojects {
     group = "com.xquik.api"
-    version = "0.5.1" // x-release-please-version
+    version = "0.5.2" // x-release-please-version
 }
 
 subprojects {