📄 Get started with your API

Welcome to Engage IO API! This API allows users to participate in giveaways, track interactions, and claim rewards within their server communities.

🔹 API Features

• 🎉 Giveaways → Enter and track giveaways
• 💬 Interactions → Engage with tweets, claim points
• 🏆 Leaderboards → Check user points

---

📌 Getting Started Guide

1️⃣ Obtain your API key

• You must use a valid API key to access endpoints.
• Generate your API key from Engage dashboard.

2️⃣ Use secure requests

• The API only accepts HTTPS requests.
• Any HTTP request will return a

  301 Redirect

  to its HTTPS equivalent.

3️⃣ Understand rate limits

• API rate limits apply per API key.
• If limits are exceeded, the API returns a

  429 Too Many Requests

  error.

4️⃣ Make your first API request

curl -X GET "https://www.engages.io/api/v1/getGiveaways?guildId=YOUR_GUILD_ID" \
-H "x-api-key: YOUR_API_KEY"