Fetch the post feed for a tag (the homepage + category pages). Required: tag (Arabic category name like 'حراج السيارات' or 'حراج الأجهزة'). Optional: city (Arabic region like 'الشرقيه'), cities (list of regions), page (default 0), limit (default 21), before_update_date (Unix seconds cursor — pass the last item's updateDate to get the next page), only_with_image (default true), only_with_video (default false), order_main_by_post_id (default false), full (return full Post objects, default false = compact). Returns {count, has_next_page, view_options, posts}.

Fetch the promoted-post carousel for a tag. Required: tag. Optional: city. Returns {count, posts}.

Cities-with-counts for a given tag — powers the city-filter chips on tag pages. Required: tag. Optional: city. Returns [{tag, count, city}].

True/false whether the authenticated user follows tag.

Search haraj by keyword. Required: keyword. Optional: cities (list), city, tag, tags (list), page, limit, only_with_image (default true), only_with_video (default false), hide_show_rooms (default false), order_by_post_id (default false), during_date ('1days'|'3days'|'1week'|'1months'), near ('@lat,lon' e.g. '@26.4336,50.1116'), full (default false = compact). Returns {keyword, count, has_next_page, view_options, posts}.

Fetch a post + 3 related groups (similar posts in the same tag/city, similar images, related offers). This is the canonical 'fetch by id' — there is no direct getById operation in the GraphQL API. Required: post_id. full (default true = full similarPosts response).

{is_like, total, is_following} for a post. Required: post_id.

Comment list for a post. Required: post_id. Optional: page, oldest_first (default true).

Full user profile (rating, followers, location history, badges). Pass either username (URL-encoded Arabic works) or user_id. rating_summary_only (default false) returns just the rating block.

True/false whether the authenticated user follows username.

User notifications (the bell icon). set_read (default false) marks them as read on the server.

Sellers for a tag (used by real-estate / business / investment pages). Required: tags (list of Arabic tag names).

{offerId, isEligible, price} for a post's Locker shipping option. Required: post_id.

{contactText, contactMobile, shouldEnableWhatsApp} for a post. Required: post_id.

Follow (or unfollow) a user. Required: username. Returns the new is_following state.

Live search-box autocomplete. Returns the top 10 suggestions for a typed prefix. Required: prefix (e.g. 'شاشة'). Optional: tag.

Top trending search terms over the last N days. range_in_days (default 7). Returns [{keyword, score}].

'Buy with confidence' (وساطة) escrow requests the user has placed. Optional: page (default 0).

Recent @-mention candidates for the comment / DM composer. Returns [{userId, username, handler}].

Currently-open haraj live shopping streams. Non-GraphQL REST endpoint. Returns [{id, title, cover_url, streamer, num_messages, num_viewers, started_at}]. limit (default 40; the server caps it).

Verify the JWT and lastRequestId in .env are still valid. Returns {ok, expires_at, seconds_remaining, user_id} or {ok: false, error} if the JWT is missing or expired.