@youmind-openlab/rettiwt-api 1.0.1 → 1.0.3

package/src/models/data/UserAbout.ts

@@ -0,0 +1,161 @@
+import { LogActions } from '../../enums/Logging';
+import { LogService } from '../../services/internal/LogService';
+import {
+	IUserAbout,
+	IUserAboutProfile,
+	IUserAboutUsernameChanges,
+	IUserAboutVerificationInfo,
+} from '../../types/data/UserAbout';
+import { IUserAboutResponse, IUserAboutResult } from '../../types/raw/user/About';
+
+/* eslint-disable @typescript-eslint/naming-convention */
+type IRawUsernameChanges = {
+	count?: string;
+	last_changed_at_msec?: string;
+};
+/* eslint-enable @typescript-eslint/naming-convention */
+
+/**
+ * The about profile details of a single user.
+ *
+ * @public
+ */
+export class UserAbout implements IUserAbout {
+	/** The raw about profile details. */
+	private readonly _raw: IUserAboutResult;
+
+	public aboutProfile?: IUserAboutProfile;
+	public createdAt: string;
+	public fullName: string;
+	public id: string;
+	public isProtected?: boolean;
+	public isVerified: boolean;
+	public profileImage: string;
+	public profileImageShape?: string;
+	public userName: string;
+	public verificationInfo?: IUserAboutVerificationInfo;
+
+	/**
+	 * @param user - The raw about profile details.
+	 */
+	public constructor(user: IUserAboutResult) {
+		this._raw = { ...user };
+
+		this.id = user.rest_id ?? user.id ?? '';
+		this.userName = user.core?.screen_name ?? '';
+		this.fullName = user.core?.name ?? '';
+		this.createdAt = new Date(user.core?.created_at ?? 0).toISOString();
+		this.profileImage = user.avatar?.image_url ?? '';
+		this.profileImageShape = user.profile_image_shape;
+		this.isVerified = user.is_blue_verified ?? false;
+		this.isProtected = user.privacy?.protected;
+		this.aboutProfile = UserAbout._buildAboutProfile(user);
+		this.verificationInfo = UserAbout._buildVerificationInfo(user);
+	}
+
+	/** The raw about profile details. */
+	public get raw(): IUserAboutResult {
+		return { ...this._raw };
+	}
+
+	private static _buildAboutProfile(user: IUserAboutResult): IUserAboutProfile | undefined {
+		const profile = user.about_profile;
+
+		if (!profile) {
+			return undefined;
+		}
+
+		const usernameChanges = UserAbout._buildUsernameChanges(profile.username_changes);
+
+		return {
+			createdCountryAccurate: profile.created_country_accurate,
+			accountBasedIn: profile.account_based_in,
+			locationAccurate: profile.location_accurate,
+			learnMoreUrl: profile.learn_more_url,
+			source: profile.source,
+			usernameChanges: usernameChanges,
+		};
+	}
+
+	private static _buildUsernameChanges(changes?: IRawUsernameChanges): IUserAboutUsernameChanges | undefined {
+		if (!changes) {
+			return undefined;
+		}
+
+		return {
+			count: UserAbout._toNumber(changes.count),
+			lastChangedAt: UserAbout._toIsoFromMsec(changes.last_changed_at_msec),
+		};
+	}
+
+	private static _buildVerificationInfo(user: IUserAboutResult): IUserAboutVerificationInfo | undefined {
+		const info = user.verification_info;
+
+		if (!info) {
+			return undefined;
+		}
+
+		return {
+			isIdentityVerified: info.is_identity_verified,
+			verifiedSince: UserAbout._toIsoFromMsec(info.reason?.verified_since_msec),
+		};
+	}
+
+	private static _toIsoFromMsec(value?: string | number): string | undefined {
+		const parsed = UserAbout._toNumber(value);
+
+		return parsed === undefined ? undefined : new Date(parsed).toISOString();
+	}
+
+	private static _toNumber(value?: string | number): number | undefined {
+		if (value === undefined || value === null) {
+			return undefined;
+		}
+
+		const parsed = typeof value === 'number' ? value : Number(value);
+
+		return Number.isFinite(parsed) ? parsed : undefined;
+	}
+
+	/**
+	 * Extracts and deserializes a single target user about profile from the given raw response data.
+	 *
+	 * @param response - The raw response data.
+	 *
+	 * @returns The target deserialized user about profile.
+	 */
+	public static single(response: NonNullable<unknown>): UserAbout | undefined {
+		const result = (response as IUserAboutResponse)?.data?.user_result_by_screen_name?.result;
+
+		if (!result || result.__typename !== 'User') {
+			LogService.log(LogActions.WARNING, {
+				action: LogActions.DESERIALIZE,
+				message: `User not found, skipping`,
+			});
+			return undefined;
+		}
+
+		// Logging
+		LogService.log(LogActions.DESERIALIZE, { id: result.rest_id ?? result.id });
+
+		return new UserAbout(result);
+	}
+
+	/**
+	 * @returns A serializable JSON representation of `this` object.
+	 */
+	public toJSON(): IUserAbout {
+		return {
+			id: this.id,
+			userName: this.userName,
+			fullName: this.fullName,
+			createdAt: this.createdAt,
+			profileImage: this.profileImage,
+			profileImageShape: this.profileImageShape,
+			isVerified: this.isVerified,
+			isProtected: this.isProtected,
+			aboutProfile: this.aboutProfile,
+			verificationInfo: this.verificationInfo,
+		};
+	}
+}

package/src/requests/List.ts

@@ -67,7 +67,7 @@ export class ListRequests {
 	public static members(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/Bnhcen0kdsMAU1tW7U79qQ/ListMembers',
+			url: 'https://x.com/i/api/graphql/7FPk01hdc1jyzL6Gj8vMZw/ListMembers',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -153,7 +153,7 @@ export class ListRequests {
 	public static tweets(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/fqNUs_6rqLf89u_2waWuqg/ListLatestTweetsTimeline',
+			url: 'https://x.com/i/api/graphql/aJxgBm1YveGJCRiWJFx5WA/ListLatestTweetsTimeline',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({

package/src/requests/Space.ts

@@ -0,0 +1,76 @@
+import { AxiosRequestConfig } from 'axios';
+
+/**
+ * Collection of requests related to spaces.
+ *
+ * @public
+ */
+export class SpaceRequests {
+	/**
+	 * @param id - The id of the space whose details are to be fetched.
+	 * @param withReplays - Whether to include replay information.
+	 * @param withListeners - Whether to include listeners information.
+	 * @param isMetatagsQuery - Whether the request is a metatags query.
+	 */
+	public static details(
+		id: string,
+		withReplays?: boolean,
+		withListeners?: boolean,
+		isMetatagsQuery?: boolean,
+	): AxiosRequestConfig {
+		return {
+			method: 'get',
+			url: 'https://x.com/i/api/graphql/rR7CQrr8kxb6fatlUaB61Q/AudioSpaceById',
+			params: {
+				/* eslint-disable @typescript-eslint/naming-convention */
+				variables: JSON.stringify({
+					id: id,
+					isMetatagsQuery: isMetatagsQuery ?? false,
+					withReplays: withReplays ?? true,
+					withListeners: withListeners ?? false,
+				}),
+				features: JSON.stringify({
+					spaces_2022_h2_spaces_communities: true,
+					spaces_2022_h2_clipping: true,
+					creator_subscriptions_tweet_preview_api_enabled: true,
+					profile_label_improvements_pcf_label_in_post_enabled: true,
+					responsive_web_profile_redirect_enabled: false,
+					rweb_tipjar_consumption_enabled: false,
+					verified_phone_label_enabled: false,
+					premium_content_api_read_enabled: false,
+					communities_web_enable_tweet_community_results_fetch: true,
+					c9s_tweet_anatomy_moderator_badge_enabled: true,
+					responsive_web_grok_analyze_button_fetch_trends_enabled: false,
+					responsive_web_grok_analyze_post_followups_enabled: true,
+					responsive_web_jetfuel_frame: true,
+					responsive_web_grok_share_attachment_enabled: true,
+					responsive_web_grok_annotations_enabled: false,
+					articles_preview_enabled: true,
+					responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+					responsive_web_edit_tweet_api_enabled: true,
+					graphql_is_translatable_rweb_tweet_is_translatable_enabled: true,
+					view_counts_everywhere_api_enabled: true,
+					longform_notetweets_consumption_enabled: true,
+					responsive_web_twitter_article_tweet_consumption_enabled: true,
+					tweet_awards_web_tipping_enabled: false,
+					responsive_web_grok_show_grok_translated_post: false,
+					responsive_web_grok_analysis_button_from_backend: true,
+					post_ctas_fetch_enabled: true,
+					creator_subscriptions_quote_tweet_preview_enabled: false,
+					freedom_of_speech_not_reach_fetch_enabled: true,
+					standardized_nudges_misinfo: true,
+					tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled: true,
+					longform_notetweets_rich_text_read_enabled: true,
+					longform_notetweets_inline_media_enabled: true,
+					responsive_web_grok_image_annotation_enabled: true,
+					responsive_web_grok_imagine_annotation_enabled: true,
+					responsive_web_graphql_timeline_navigation_enabled: true,
+					responsive_web_grok_community_note_auto_translation_is_enabled: false,
+					responsive_web_enhance_cards_enabled: false,
+				}),
+				/* eslint-enable @typescript-eslint/naming-convention */
+			},
+			paramsSerializer: { encode: encodeURIComponent },
+		};
+	}
+}

package/src/requests/Tweet.ts

@@ -34,7 +34,7 @@ export class TweetRequests {
 	public static bulkDetails(ids: string[]): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/-R17e8UqwApFGdMxa3jASA/TweetResultsByRestIds',
+			url: 'https://x.com/i/api/graphql/vojBqBFpEyYMQ-LfRIKU4Q/TweetResultsByRestIds',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -99,7 +99,7 @@ export class TweetRequests {
 	public static details(id: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/aFvUsJm2c-oDkJV75blV6g/TweetResultByRestId',
+			url: 'https://x.com/i/api/graphql/d6YKjvQ920F-D4Y1PruO-A/TweetResultByRestId',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -237,7 +237,7 @@ export class TweetRequests {
 
 		return {
 			method: 'post',
-			url: 'https://x.com/i/api/graphql/Uf3io9zVp1DsYxrmL5FJ7g/CreateTweet',
+			url: 'https://x.com/i/api/graphql/Ah3G_byjEDs_HSlgU0PyZw/CreateTweet',
 			data: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: {
@@ -294,7 +294,7 @@ export class TweetRequests {
 	public static replies(id: string, cursor?: string, sortBy?: RawTweetRepliesSortType): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/97JF30KziU00483E_8elBA/TweetDetail',
+			url: 'https://x.com/i/api/graphql/ooUbmy0T2DmvwfjgARktiQ/TweetDetail',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -474,7 +474,7 @@ export class TweetRequests {
 
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/M1jEez78PEfVfbQLvlWMvQ/SearchTimeline',
+			url: 'https://x.com/i/api/graphql/cGK-Qeg1XJc2sZ6kgQw_Iw/SearchTimeline',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -520,6 +520,8 @@ export class TweetRequests {
 					responsive_web_grok_imagine_annotation_enabled: true,
 					responsive_web_grok_community_note_auto_translation_is_enabled: false,
 					responsive_web_enhance_cards_enabled: false,
+					post_ctas_fetch_enabled: true,
+					responsive_web_grok_annotations_enabled: false,
 				}),
 				/* eslint-enable @typescript-eslint/naming-convention */
 			},
@@ -584,7 +586,7 @@ export class TweetRequests {
 	public static unretweet(id: string): AxiosRequestConfig {
 		return {
 			method: 'post',
-			url: 'https://x.com/i/api/graphql/iQtK4dl5hBmXewYZuEOKVw/DeleteRetweet',
+			url: 'https://x.com/i/api/graphql/G4MoqBiE6aqyo4QWAgCy4w/DeleteRetweet',
 			data: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: {

package/src/requests/User.ts

@@ -11,6 +11,20 @@ import { IProfileUpdateOptions } from '../types/args/ProfileArgs';
  * @public
  */
 export class UserRequests {
+	/**
+	 * @param userName - The username of the user whose about profile is to be fetched.
+	 */
+	public static aboutByUsername(userName: string): AxiosRequestConfig {
+		return {
+			method: 'get',
+			url: 'https://x.com/i/api/graphql/zs_jFPFT78rBpXv9Z3U2YQ/AboutAccountQuery',
+			params: {
+				variables: JSON.stringify({ screenName: userName }),
+			},
+			paramsSerializer: { encode: encodeURIComponent },
+		};
+	}
+
 	/**
 	 * @param id - The id of the user whose affiliates are to be fetched.
 	 * @param count - The number of affiliates to fetch. Only works as a lower limit when used with a cursor.
@@ -231,6 +245,7 @@ export class UserRequests {
 	public static bookmarks(count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
+			// TODO: Bookmarks listing removed from Twitter bundle 2026-02-13
 			url: 'https://x.com/i/api/graphql/-LGfdImKeQz0xS_jjUwzlA/Bookmarks',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
@@ -317,7 +332,7 @@ export class UserRequests {
 	public static detailsById(id: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/Bbaot8ySMtJD7K2t01gW7A/UserByRestId',
+			url: 'https://x.com/i/api/graphql/pBP53RhZiQHExruxf-I8ig/UserByRestId',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({ userId: id, withSafetyModeUserFields: true }),
@@ -346,7 +361,7 @@ export class UserRequests {
 	public static detailsByUsername(userName: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/-oaLodhGbbnzJBACb1kk2Q/UserByScreenName',
+			url: 'https://x.com/i/api/graphql/AWbeRIdkLtqTRN7yL_H8yw/UserByScreenName',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({ screen_name: userName, withGrokTranslatedBio: false }),
@@ -394,7 +409,7 @@ export class UserRequests {
 	public static followed(count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/_qO7FJzShSKYWi9gtboE6A/HomeLatestTimeline',
+			url: 'https://x.com/i/api/graphql/7LL9B2gjCKU7swZw3aKF7g/HomeLatestTimeline',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -454,7 +469,7 @@ export class UserRequests {
 	public static followers(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/kuFUYP9eV1FPoEy4N-pi7w/Followers',
+			url: 'https://x.com/i/api/graphql/efNzdTpE-mkUcLARCd3RPQ/Followers',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -514,7 +529,7 @@ export class UserRequests {
 	public static following(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/C1qZ6bs-L3oc_TKSZyxkXQ/Following',
+			url: 'https://x.com/i/api/graphql/M3LO-sJg6BCWdEliN_C2fQ/Following',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -570,7 +585,7 @@ export class UserRequests {
 	public static highlights(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/kzKWdUA6Y1LCqlvaVILZwQ/UserHighlightsTweets',
+			url: 'https://x.com/i/api/graphql/dZc2IL7haTg9IbZ-vDV3xw/UserHighlightsTweets',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -631,7 +646,7 @@ export class UserRequests {
 	public static likes(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/JR2gceKucIKcVNB_9JkhsA/Likes',
+			url: 'https://x.com/i/api/graphql/JPxbOQGc_tXQ0Y29mvHKSw/Likes',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -695,7 +710,7 @@ export class UserRequests {
 	public static lists(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/9mQl9vR31wjodBP9b7_wyQ/ListsManagementPageTimeline',
+			url: 'https://x.com/i/api/graphql/FHavhcMS-6NrywtPkWiOHg/ListsManagementPageTimeline',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({ count: 100, cursor: cursor }),
@@ -750,7 +765,7 @@ export class UserRequests {
 	public static media(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/MMnr49cP_nldzCTfeVDRtA/UserMedia',
+			url: 'https://x.com/i/api/graphql/SJpoWbz8n_i3vN3sOPfXvw/UserMedia',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -869,7 +884,7 @@ export class UserRequests {
 	public static recommended(count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/V7xdnRnvW6a8vIsMr9xK7A/HomeTimeline',
+			url: 'https://x.com/i/api/graphql/y_gEr8-rsIu-XEOVAkh00A/HomeTimeline',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -941,7 +956,7 @@ export class UserRequests {
 	public static search(userName: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/M1jEez78PEfVfbQLvlWMvQ/SearchTimeline',
+			url: 'https://x.com/i/api/graphql/cGK-Qeg1XJc2sZ6kgQw_Iw/SearchTimeline',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -1002,7 +1017,7 @@ export class UserRequests {
 	public static subscriptions(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/fl06vhYypYRcRxgLKO011Q/UserCreatorSubscriptions',
+			url: 'https://x.com/i/api/graphql/5nn_EKhv4toQ_rhMjjwGoA/UserCreatorSubscriptions',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -1061,7 +1076,7 @@ export class UserRequests {
 	public static tweets(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/-V26I6Pb5xDZ3C7BWwCQ_Q/UserTweets',
+			url: 'https://x.com/i/api/graphql/eApPT8jppbYXlweF_ByTyA/UserTweets',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -1124,7 +1139,7 @@ export class UserRequests {
 	public static tweetsAndReplies(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/61HQnvcGP870hiE-hCbG4A/UserTweetsAndReplies',
+			url: 'https://x.com/i/api/graphql/aDl2OEiH_EFH10mA_ewZ9A/UserTweetsAndReplies',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({

package/src/services/public/SpaceService.ts

@@ -0,0 +1,65 @@
+import { Extractors } from '../../collections/Extractors';
+import { ResourceType } from '../../enums/Resource';
+import { Space } from '../../models/data/Space';
+import { RettiwtConfig } from '../../models/RettiwtConfig';
+import { ISpaceDetailsOptions } from '../../types/args/FetchArgs';
+import { IAudioSpaceByIdResponse } from '../../types/raw/space/AudioSpaceById';
+
+import { FetcherService } from './FetcherService';
+
+/**
+ * Handles interacting with resources related to spaces.
+ *
+ * @public
+ */
+export class SpaceService extends FetcherService {
+	/**
+	 * @param config - The config object for configuring the Rettiwt instance.
+	 *
+	 * @internal
+	 */
+	public constructor(config: RettiwtConfig) {
+		super(config);
+	}
+
+	/**
+	 * Get the details of a space.
+	 *
+	 * @param id - The ID of the target space.
+	 * @param options - Additional options for the fetch.
+	 *
+	 * @returns The details of the space with the given ID.
+	 *
+	 * @example
+	 *
+	 * ```ts
+	 * import { Rettiwt } from 'rettiwt-api';
+	 *
+	 * const rettiwt = new Rettiwt({ apiKey: API_KEY });
+	 *
+	 * rettiwt.space.details('1YqJDNEzvoVKV', { withListeners: true })
+	 * .then(res => {
+	 * 	console.log(res);
+	 * })
+	 * .catch(err => {
+	 * 	console.log(err);
+	 * });
+	 * ```
+	 */
+	public async details(id: string, options?: ISpaceDetailsOptions): Promise<Space | undefined> {
+		const resource = ResourceType.SPACE_DETAILS;
+
+		// Fetching raw space details
+		const response = await this.request<IAudioSpaceByIdResponse>(resource, {
+			id: id,
+			withReplays: options?.withReplays,
+			withListeners: options?.withListeners,
+			isMetatagsQuery: options?.isMetatagsQuery,
+		});
+
+		// Deserializing response
+		const data = Extractors[resource](response);
+
+		return data;
+	}
+}

package/src/services/public/UserService.ts

@@ -9,8 +9,10 @@ import { List } from '../../models/data/List';
 import { Notification } from '../../models/data/Notification';
 import { Tweet } from '../../models/data/Tweet';
 import { User } from '../../models/data/User';
+import { UserAbout } from '../../models/data/UserAbout';
 import { RettiwtConfig } from '../../models/RettiwtConfig';
 import { IProfileUpdateOptions } from '../../types/args/ProfileArgs';
+import { IUserAboutResponse } from '../../types/raw/user/About';
 import { IUserAffiliatesResponse } from '../../types/raw/user/Affiliates';
 import { IUserAnalyticsResponse } from '../../types/raw/user/Analytics';
 import { IUserBookmarkFoldersResponse } from '../../types/raw/user/BookmarkFolders';
@@ -52,6 +54,47 @@ export class UserService extends FetcherService {
 		super(config);
 	}
 
+	/**
+	 * Get the about profile of a user.
+	 *
+	 * @param userName - The username/screenname of the target user.
+	 *
+	 * @returns The about profile of the user.
+	 *
+	 * @example
+	 *
+	 * ```ts
+	 * import { Rettiwt } from 'rettiwt-api';
+	 *
+	 * // Creating a new Rettiwt instance using the given 'API_KEY'
+	 * const rettiwt = new Rettiwt({ apiKey: API_KEY });
+	 *
+	 * // Fetching the about profile of the User with username 'user1' or '@user1'
+	 * rettiwt.user.about('user1') // or @user1
+	 * .then(res => {
+	 * 	console.log(res);
+	 * })
+	 * .catch(err => {
+	 * 	console.log(err);
+	 * });
+	 * ```
+	 */
+	public async about(userName: string): Promise<UserAbout | undefined> {
+		const resource = ResourceType.USER_ABOUT_BY_USERNAME;
+
+		if (userName.startsWith('@')) {
+			userName = userName.slice(1);
+		}
+
+		// Fetching raw about profile
+		const response = await this.request<IUserAboutResponse>(resource, { id: userName });
+
+		// Deserializing response
+		const data = Extractors[resource](response);
+
+		return data;
+	}
+
 	/**
 	 * Get the list affiliates of a user.
 	 *

package/src/types/args/FetchArgs.ts

@@ -71,7 +71,7 @@ export interface IFetchArgs {
 	 *
 	 * @remarks
 	 * - Required for all resources except {@link ResourceType.TWEET_SEARCH} and {@link ResourceType.USER_TIMELINE_RECOMMENDED}.
-	 * - For {@link ResourceType.USER_DETAILS_BY_USERNAME} and {@link ResourceType.USER_SEARCH}, can be alphanumeric, while for others, is strictly numeric.
+	 * - For {@link ResourceType.USER_DETAILS_BY_USERNAME}, {@link ResourceType.USER_ABOUT_BY_USERNAME}, and {@link ResourceType.USER_SEARCH}, can be alphanumeric, while for others, is strictly numeric.
 	 */
 	id?: string;
 
@@ -83,6 +83,30 @@ export interface IFetchArgs {
 	 */
 	ids?: string[];
 
+	/**
+	 * Whether to include replay information when fetching space details.
+	 *
+	 * @remarks
+	 * - Only works for {@link ResourceType.SPACE_DETAILS}.
+	 */
+	withReplays?: boolean;
+
+	/**
+	 * Whether to include listeners information when fetching space details.
+	 *
+	 * @remarks
+	 * - Only works for {@link ResourceType.SPACE_DETAILS}.
+	 */
+	withListeners?: boolean;
+
+	/**
+	 * Whether to request metatags for space details.
+	 *
+	 * @remarks
+	 * - Only works for {@link ResourceType.SPACE_DETAILS}.
+	 */
+	isMetatagsQuery?: boolean;
+
 	/**
 	 * The sorting to use for tweet results.
 	 *
@@ -132,6 +156,22 @@ export interface IFetchArgs {
 	showVerifiedFollowers?: boolean;
 }
 
+/**
+ * Options specifying the data that is to be fetched for space details.
+ *
+ * @public
+ */
+export interface ISpaceDetailsOptions {
+	/** Whether to include replay information. */
+	withReplays?: boolean;
+
+	/** Whether to include listeners information. */
+	withListeners?: boolean;
+
+	/** Whether the request is a metatags query. */
+	isMetatagsQuery?: boolean;
+}
+
 /**
  * The filter to be used for searching tweets.
  *