> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getjumper.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Your first Jumper app

> Build a small local app that connects to the Jumper API and returns search results.

This guide walks you through building a minimal app on top of the Jumper Public API: a search box, a submit action, and a results list with thumbnails. That is enough to prove the setup works.

<Info>
  **Before you begin:** Jumper is running with [media analyzed](/core-concepts/processing), you have a [Jumper Pro license](/interface/settings-tab#license-key), and you know the path to your [analysis folder](/interface/settings-tab#analysis-folder).
</Info>

You do not need to write the code yourself. Paste the starter prompt below into a coding agent (Cursor, Codex, Claude Code, or similar) and follow its instructions.

## Starter prompt

Copy this into your coding agent:

```
Build a very small local app that connects to the Jumper API.

Goal:
1) Show a search input box
2) Send the query to Jumper
3) Render results as a simple list with thumbnails and clip info

When done, tell me exactly how to test it.

Assume that I have Jumper Pro running and my footage is already analyzed.

Use this API reference: https://docs.getjumper.io/api-reference
```

### Optional: specify a tech stack

If you have a preference, say so in the prompt. Many agents default to JavaScript.

```
Use JavaScript with React, shadcn components, and Tailwind for styling.
```

Other stacks work too, including a CLI in Python, a desktop app, or a plain HTML page. The Jumper API does not care what language or framework you use.

### What the agent will ask for

When testing, the agent or app will usually need:

* Your **Jumper Pro license key**
* The path to your **analysis folder** (the `cache_dir` in API requests)

Point the agent at the [OpenAPI spec](/api-reference/openapi-v1.yaml) if it needs endpoint schemas or request fields.

## Test it

<Steps>
  <Step title="Keep Jumper running">
    The API is local. Your app talks to Jumper on your machine at `http://localhost:6699/api/v1`.
  </Step>

  <Step title="Run the app">
    Follow the instructions the agent gives you. If you are unsure, ask it: "How do I test the app?" or "Can you start the app for me?"
  </Step>

  <Step title="Run a search">
    Enter a query you know should return results from your analyzed footage. Confirm you get thumbnails and clip info back.
  </Step>

  <Step title="Verify the basics">
    Check that results match media you have analyzed in Jumper. Try a second query to confirm the connection is stable.
  </Step>
</Steps>

## If something breaks

Paste the error message back to the agent and ask it to fix the issue. That is usually faster than debugging it yourself.

<AccordionGroup>
  <Accordion title="The app runs but search returns nothing">
    * Confirm Jumper is running
    * Confirm the footage has been [analyzed](/core-concepts/processing)
    * Check the analysis folder path matches the one in [Settings](/interface/settings-tab#analysis-folder)
    * Confirm the `media_paths` in the request point at analyzed files
  </Accordion>

  <Accordion title="The app cannot connect to Jumper">
    * Confirm Jumper is running
    * Confirm the base URL is `http://localhost:6699/api/v1`
    * Try `GET /health` with curl. See [API reference](/api-reference/introduction#example-requests)
  </Accordion>

  <Accordion title="Authentication errors">
    * Confirm you have a Jumper Pro license
    * Check the license key is correct
    * Send the key in the `X-License-Key` header or in the request body as `license_key`
  </Accordion>
</AccordionGroup>

## What's next

Once search works, add features one at a time instead of trying to build everything at once. Common next steps:

* Switch from a list to a card or deck view for review
* Add keyboard shortcuts for faster selects
* Save favorites and batch-export them as clips
* Drag a result to Finder or Explorer to export a trimmed clip
* Combine Jumper results with another API or tool you already use

For inspiration on iterating from a basic search UI to more elaborate review tools, see [Vibe-Coding Your Own Video Editing Tools](https://getjumper.io/blog/vibe_coding_your_own_video_editing_tools) on the Jumper blog.

## Related

<CardGroup>
  <Card title="Developers overview" horizontal arrow="true" href="/developers">
    What Jumper handles, who this is for, and how the pieces fit together
  </Card>

  <Card title="API reference" horizontal arrow="true" href="/api-reference/introduction">
    Authentication, workflow, endpoint groups, and curl examples
  </Card>

  <Card title="Agentic editing" horizontal arrow="true" href="/core-concepts/agentic-editing">
    Use an AI agent to operate Jumper directly instead of building your own app
  </Card>
</CardGroup>