DesiDime

Get deals from a specific category on DesiDime. Resolves the category name to its permalink, so no category ID is needed. Results lead with deal links/permalinks. The response includes `category_permalink` (the category ID) for follow-up calls, and deal `permalink` values that can be reused as `topic_id` in the topic tools. Show each deal with both of its links: the title linking to `read_more_url` (the DesiDime page for the deal) and a separate 'Buy Now' link to `deal_url` (a tracked link to the store's offer), in its own column or line. Keep them as two links, and include 'Buy Now' whenever `deal_url` is present.

get_category_deals

Get full metadata and overview for a specific category on DesiDime. Response includes `category_permalink` (category ID) for easier follow-up calls.

get_category_info

Get full details for a specific DesiDime channel. When to use: "show channel info", "details of channel X" Obtain channel_id (numeric) from: get_channels(), get_subscribed_channels(), get_my_channel_groups() Returns: channel details usable in subscribe_channel(), unsubscribe_channel().

get_channel_by_id

Get all channels on DesiDime. When to use: "show all channels", "find a deals channel", "list DesiDime channels" Returns: channel list with numeric id values usable in get_channel_by_id(), subscribe_channel(), unsubscribe_channel().

get_channels

Get full message history for a chat conversation.

get_chat_messages

Get all conversations for the current user.

get_chats

Get all posts from DesiDime with optional forum filtering.

get_posts

Get detailed information about a specific coupon by its ID. Obtain coupon_id from: get_coupons(), get_latest_coupons(), get_store_coupons(), get_category_coupons(), get_user_coupons(), get_group_coupons(), search_deals(search_type="coupons") → coupons[].id Returns full coupon details including description, redemption count, expiry date, and more. Use this tool when the user wants to: - "Show me details of coupon 544297" - "What's the coupon code for this deal?" - "Get full info about this coupon"

get_coupon_by_id

Get all available coupons on DesiDime with optional filtering. Returns paginated list of coupons with prices, discount details, and redemption info. URL: build from coupon.id + store.permalink — link coupons here rather than to `coupon_url`, which is a tracking redirect. https://www.desidime.com/stores/{store.permalink}?coupon_id={coupon.id} Use this tool when the user wants to: - "Show me available coupons" - "What coupons are there for Amazon?" - "Find fashion coupons" - "Get latest discount codes"

get_coupons

Get information about the current authenticated user on DesiDime. Returns profile info including reputation, karma, referral info, badges, and more. Requires the user to be logged in via the DesiDime OAuth flow. Use this tool when the user wants to: - "Show me my profile" - "What's my current reputation and karma?" - "How many deals have I posted?"

get_current_user

Get details of a specific deal alert by its ID on DesiDime. Obtain alert_id from: get_deal_alerts() → alerts[].permalink, or create_deal_alert() response. Returns alert details including keywords, status, notification preferences, store/category filters, and hotness threshold. Requires the user to be logged in via the DesiDime OAuth flow. Use this tool when the user wants to: - "Show me details of my iPhone 16 alert" - "Get the configuration of the boAt earphones alert" - "What are the settings for my alert?"

get_deal_alert

Get all current deals matching a specific deal alert on DesiDime. When to use: "show deals for my iPhone alert", "what deals matched my alert", "get latest deals from my Samsung alert", or right after create_deal_alert() to list the matching deals. alert_id comes from get_deal_alerts() → alerts[].permalink, or directly from the create_deal_alert() response. Returns deals with price, discount, store info, and links. Show each deal with two links: the DesiDime page (https://www.desidime.com/deals/{permalink}) and a separate 'Buy Now' link to `deal_url` (a tracked link to the store's offer), in its own column or line. Requires login.

get_deal_alert_search_results

Get all deal alerts the user has set up on DesiDime. When to use: "show my deal alerts", "what alerts do I have", "list my alerts", "manage my deal alerts". Limit: the API allows at most 10 active alerts per user, so the alert count here shows how many slots are left before create_deal_alert. Each alert's id/permalink is the alert_id that update_deal_alert and delete_deal_alert accept. Returns each alert's id/permalink (needed for get_deal_alert, update_deal_alert, delete_deal_alert, get_deal_alert_search_results), keywords, active/inactive status, and notification preferences. Requires login.

get_deal_alerts

Get deals from groups subscribed by the current user. Uses `/v4/me/my_deals`. Results lead with deal links/permalinks, and deal `permalink` values can be reused as `topic_id` in the topic tools. Show each deal with both of its links: the title linking to `read_more_url` (the DesiDime page for the deal) and a separate 'Buy Now' link to `deal_url` (a tracked link to the store's offer), in its own column or line. Keep them as two links, and include 'Buy Now' whenever `deal_url` is present. Requires the user to be logged in via the DesiDime OAuth flow. Note: per_page has a minimum value of 20 (API requirement).

get_my_deals

Get deals sorted by most discussed (highest comment count) on DesiDime. Show each deal with both of its links: the title linking to `read_more_url` (the DesiDime page for the deal) and a separate 'Buy Now' link to `deal_url` (a tracked link to the store's offer), in its own column or line. Keep them as two links, and include 'Buy Now' whenever `deal_url` is present. Deal `permalink` values can be reused as `topic_id` in the topic tools.

get_discussed_deals

Get topics from DesiDime discussion forums. When to use: "show forum discussions", "what's being discussed on DesiDime", "latest discussion topics" Obtain forum_ids from: get_groups() → groups[].permalink (for group-specific forums) Returns: topic list with permalink values usable as topic_id in get_topic_details(), reply_to_topic(), vote_topic(), follow_topic().

get_discussion_topics

Get all DesiDime forums. Returns each forum's name, description, type and permalink. A forum's permalink is the `forum_id` that create_topic() accepts, and `forum_type` separates deal forums from discussion, feedback, trading and news forums.

get_forums

Get coupons added to a specific DesiDime group. When to use: "show coupons in group X", "coupons for group Y" Obtain group_id (permalink) from: get_groups(), get_user_groups(), get_user_subscribed_groups() Returns: coupon list with id values usable in get_coupon_by_id(), vote_coupon(). URL: https://www.desidime.com/stores/{store.permalink}?coupon_id={coupon.id} — link coupons here rather than to `coupon_url`, which is a tracking redirect. Requires login.

get_group_coupons

Get deals added to a specific DesiDime group. When to use: "show deals in group X", "deals from group Y". group_id (the group permalink) comes from get_groups(), get_user_groups() or get_user_subscribed_groups(). Returns a deal list; deal `permalink` values can be used as topic_id in get_topic_details(), vote_topic() and reply_to_topic(). Show each deal with both of its links: the title linking to `read_more_url` (the DesiDime page for the deal) and a separate 'Buy Now' link to `deal_url` (a tracked link to the store's offer), in its own column or line. Keep them as two links, and include 'Buy Now' whenever `deal_url` is present. Requires login.

get_group_deals

Get full details for a specific DesiDime group. When to use: "show group info", "details about group X" Obtain group_id (permalink) from: get_groups(), get_user_groups(), get_user_subscribed_groups() Returns: group details with permalink usable in get_group_deals(), get_group_coupons(), subscribe_group(), unsubscribe_group().

get_group_by_id

Get all groups on DesiDime. When to use: "show all groups", "find groups about electronics", "list DesiDime communities" Returns: group list with permalink values usable in get_group_by_id(), get_group_deals(), get_group_coupons(), subscribe_group(), unsubscribe_group().

get_groups

Get groups that a specific user is subscribed to. When to use: "show subscribed groups of [user]", "what groups does [user] follow" Obtain user_id from: get_current_user() → id, get_topic_details() → user_id, search_deals() → user.id Returns: group list with permalink values usable in get_group_by_id(), get_group_deals(), unsubscribe_group(). Note: per_page has a minimum value of 20 (API requirement).

get_user_subscribed_groups

Get hot and trending deals on DesiDime, sorted by hotness score. Show each deal with both of its links: the title linking to `read_more_url` (the DesiDime page for the deal) and a separate 'Buy Now' link to `deal_url` (a tracked link to the store's offer), in its own column or line. Keep them as two links, and include 'Buy Now' whenever `deal_url` is present. Deal `permalink` values can be reused as `topic_id` in the topic tools.

get_hot_deals

Get the latest/newest coupons on DesiDime. Returns paginated list of the most recently added coupons. URL: build from coupon.id + store.permalink — link coupons here rather than to `coupon_url`, which is a tracking redirect. https://www.desidime.com/stores/{store.permalink}?coupon_id={coupon.id} Use this tool when the user wants to: - "Show me the latest coupons" - "What new coupon codes are available?" - "Get recent coupon updates"

get_latest_coupons

Get channels/groups created by the current authenticated user. Requires login.

get_my_channel_groups

Get chat user context for the current authenticated user.

get_chat_user

Fetch the current user's existing review for a store, pre-populated for editing.

get_store_review_for_edit

Get the latest newly posted deals on DesiDime. Show each deal with both of its links: the title linking to `read_more_url` (the DesiDime page for the deal) and a separate 'Buy Now' link to `deal_url` (a tracked link to the store's offer), in its own column or line. Keep them as two links, and include 'Buy Now' whenever `deal_url` is present. Deal `permalink` values can be reused as `topic_id` in the topic tools.

get_new_deals

Get notifications for the current authenticated user on DesiDime. Returns paginated list of user notifications including activity updates and system messages. Requires the user to be logged in via the DesiDime OAuth flow. Use this tool when the user wants to: - "Show me my notifications" - "What notifications do I have?" - "Get my unread notifications"

get_notifications

Get emoji reactions on a specific comment or post. When to use: "show reactions on this comment", "who reacted to post X" Obtain post_id from: get_topic_comments() → posts[].id, get_user_posts() → posts[].id, reply_to_topic() response Requires login.

get_post_reactions

Get threaded replies nested under a parent comment in a topic. When to use: "show replies to this comment", "get thread under post X" Obtain topic_id (permalink) from: search_deals(), get_topic_details() Obtain post_id from: get_topic_comments() → posts[].id Note: per_page minimum is 20 (API requirement). Public endpoint, no login required.

get_child_comments_by_parent

Get similar or related stores for a specific store on DesiDime. When to use: "stores similar to Amazon", "alternatives to Flipkart" store_name: human-readable name (e.g. "amazon") — automatically resolved to permalink. Returns: store list with name values usable in get_store_info(), get_store_deals(), get_store_coupons().

get_similar_stores

Get available coupons for a specific store on DesiDime. Automatically resolves store name to permalink. No store ID needed. Response includes `store_permalink` (store ID) for easier follow-up calls. URL: https://www.desidime.com/stores/{store_permalink}?coupon_id={coupon.id} — link coupons here rather than to `coupon_url`, which is a tracking redirect. The response contains two types of coupons — present them differently based on user intent: - coupon_type == "GenericCoupon": has a real coupon_code (e.g. "MYNTRA500"). Show these when the user asks for "coupon codes", "promo codes", or "discount codes". - coupon_type == "DealCoupon": coupon_code is "DEAL ACTIVATED" — no code to copy. The discount is applied automatically when the user clicks the link. Show these when the user asks for "offers", "deals", or "sale". If the user asks generically for "coupons" without specifying codes or offers, show both types but label GenericCoupons as "Coupon Codes" and DealCoupons as "Offers / Click to Activate".

get_store_coupons

Get deals from a specific store on DesiDime, filtered by deal_type (hot/new/discussed/trending). Best suited to requests for hot, new, discussed or trending deals from a store (e.g. "show me hot deals on Myntra", "new Amazon deals"). Caveat: this endpoint also returns deals from affiliated/partner stores mixed in (e.g. Limeroad deals appear under Myntra), and its `store{}` field comes back empty, so results can't be filtered by store. For a general list of a store's deals, search_desidime(query=store_name, search_type='overview') returns cleaner, store-specific results. Show each deal with both of its links: the title linking to `read_more_url` (the DesiDime page for the deal) and a separate 'Buy Now' link to `deal_url` (a tracked link to the store's offer), in its own column or line. Keep them as two links, and include 'Buy Now' whenever `deal_url` is present.

get_store_deals

Get full overview information for a specific store on DesiDime. When to use: "show info about [store]", "Amazon store details on DesiDime" store_name: human-readable name (e.g. "amazon") — automatically resolved to permalink. Returns: store overview including permalink usable in get_store_deals(), get_store_coupons(), get_store_reviews().

get_store_info

Get user reviews for a specific store on DesiDime.

get_store_reviews

Get stores recommended by a specific user. When to use: "what stores does [user] recommend", "show [user]'s store recommendations" Obtain user_id from: get_current_user() → id, get_topic_details() → user_id, search_deals() → user.id Returns: store list with permalink values usable in get_store_deals(), get_store_coupons(). Note: per_page has a minimum value of 20 (API requirement).

get_user_recommended_stores

Get channels subscribed by the current authenticated user. Requires login.

get_subscribed_channels

Get a single specific comment from a deal/topic thread. When to use: "fetch comment X from deal Y", "get specific reply by ID" Obtain topic_id (permalink) from: search_deals(), get_hot_deals(), get_topic_details() Obtain comment_id from: get_topic_comments() → posts[].id

get_topic_comment_by_id

Get comments/discussion thread for a specific deal or topic. When to use: "show comments on this deal", "what are people saying about [deal]" Obtain topic_id (permalink) from: search_deals(), get_hot_deals(), get_topic_details(), get_user_deals(), get_store_deals(), get_category_deals() Returns: post list with id (post_id) values usable in vote_post(), get_post_reactions(), get_child_comments_by_parent(), follow_post(), report_post_to_admin().

get_topic_comments