FitGIF Data API

Get structured exercise data alongside GIFs with our powerful Data API. Perfect for fitness apps and AI integrations.

Step 1: Enable Data in Request

Simply add "includeData": true to your request body. This tells the API to include structured exercise data alongside the GIF URLs.

fetch("https://fitgif.vercel.app/api/search", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "key": "YOUR_API_KEY",
    "search": "bench press",
    "equipment": "barbell",
    "bodyPart": "chest",
    "target": "pectorals",
    "includeData": true
  })
})

Step 2: Receive Enhanced Response

The API returns the same GIF URLs plus comprehensive exercise data including instructions, muscle targets, difficulty levels, and exercise summaries.

{
  "results": [
    {
      "name": "barbell bench press",
      "bodyPart": "chest",
      "target": "pectorals",
      "equipment": "barbell",
      "url": "https://nvusloarnfslqgqgldhr.supabase.co/storage/v1/object/sign/Bukkit/barbell-bench-press.gif?token=eyJh...",
      "data": {
        "summary": "A barbell exercise targeting Pectorals / Chest.",
        "steps": [
          "Set the bench to a moderate incline and plant your feet.",
          "Unrack the bar over your upper chest with shoulder blades set.",
          "Lower the bar to the upper chest with elbows at about 45 degrees.",
          "Press up smoothly without shrugging.",
          "Repeat for reps, keeping your core braced."],
        "difficulty": "intermediate",
        "force": "push",
        "mechanic": "compound"}
    }
  ],
  "count": 1
}

Step 3: Use Both GIF and Data

Display the GIF for visual demonstration while using the structured data for exercise descriptions, instructions, and workout planning. Perfect for fitness apps and AI assistants.

<div class="exercise-card">
  <img src="https://signed-url-from-api.com/exercise.gif" alt="Barbell Bench Press" />
  <h3>Barbell Bench Press</h3>
  <p><strong>Target:</strong> pectorals</p>
  <p><strong>Equipment:</strong> barbell</p>
  <p><strong>Difficulty:</strong> intermediate</p>
  <p>A barbell exercise targeting Pectorals / Chest.</p>
  <h4>Instructions:</h4>
  <ol>
    <li>Set the bench to a moderate incline and plant your feet.</li>
    <li>Unrack the bar over your upper chest with shoulder blades set.</li>
    <li>Lower the bar to the upper chest with elbows at about 45 degrees.</li>
    <li>Press up smoothly without shrugging.</li>
    <li>Repeat for reps, keeping your core braced.</li>
  </ol>
</div>

Available Data Fields

Exercise Information

Core exercise details that help users understand what the exercise targets and how to perform it.

summarystepsdifficultyforcemechanic

Difficulty Levels

Exercises are categorized by difficulty to help users choose appropriate movements for their fitness level.

beginnerintermediateexpert

Force Types

Indicates whether the exercise involves pushing, pulling, or static movements.

pushpullstatic

Movement Mechanics

Describes whether the exercise works multiple muscle groups or isolates specific muscles.

compoundisolation