api.mouse.rip

Gift Links

Recent MouseHunt reward and gift links, newest first. Expired gifts are hidden by default.

GEThttps://api.mouse.rip/gift-links

Query parameters

  • Name
    limit
    Type
    integer
    Description

    Maximum number of links to return. Defaults to 25 and is capped at 250.

  • Name
    expired
    Type
    boolean
    Description

    Include expired gifts when set to true, 1, or yes. Defaults to false.

Properties

  • Name
    count
    Type
    integer
    Description

    Total number of matching stored links before applying limit.

  • Name
    links
    Type
    array
    Description

    The matching links, newest first.

  • Name
    links[].id
    Type
    string
    Description

    Stable identifier for the link.

  • Name
    links[].messageId
    Type
    string
    Description

    ID of the Discord announcement containing the link.

  • Name
    links[].timestamp
    Type
    integer
    Description

    Time the announcement was posted, as a Unix timestamp in milliseconds.

  • Name
    links[].parsed
    Type
    object
    Description

    Values parsed from the announcement, including code, url, reward, finder, and finderName.

  • Name
    links[].gift
    Type
    object
    Description

    Gift details from MouseHunt, including name, image, quantity, expiresAt, id, hash, and url. Details that could not be retrieved are null.

  • Name
    links[].expired
    Type
    boolean
    Description

    Whether the gift's expiration time has passed.

Request

GET
https://api.mouse.rip/gift-links?limit=10
const giftLinks = await fetch(
  'https://api.mouse.rip/gift-links?limit=10',
).then((res) => res.json())

console.log(giftLinks)

Response

{
  "count": 42,
  "links": [
    {
      "id": "1234567890-6ikkbr",
      "messageId": "1234567890",
      "timestamp": 1783706400000,
      "parsed": {
        "code": "6ikkbr",
        "url": "https://mshnt.ca/6ikkbr",
        "reward": "5 Chrome Bits",
        "finder": "About24Pandas",
        "finderName": "About24Pandas"
      },
      "gift": {
        "name": "5 Chrome Bits",
        "image": "https://www.mousehuntgame.com/images/items/stats/large/example.png",
        "quantity": 5,
        "expiresAt": 1784311200000,
        "id": "483392733",
        "hash": "example",
        "url": "https://www.mousehuntgame.com/claimgift.php?gift_id=483392733&gift_hash=example"
      },
      "expired": false
    }
  ]
}