# Audio Download



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Download audio from a URL via HuntAPI and receive a job id.

**Credit cost:** 1 credit per request

**Async:** This endpoint runs asynchronously. Use the jobs endpoint to poll for results.

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/audio/download","method":"post"}]} />


# Credits



Each API call consumes credits from your account balance. The table below lists every endpoint and its cost.

<Callout type="info">
  You are only charged for successful requests (status code `200`). Failed requests do not consume credits.
</Callout>

| Endpoint                          | Method | Path                 | Credits |
| --------------------------------- | ------ | -------------------- | ------- |
| [Audio Download](/audio-download) | `POST` | `/v1/audio/download` | 1       |
| [Jobs](/jobs)                     | `GET`  | `/v1/jobs`           | —       |
| [Usage](/usage)                   | `GET`  | `/usage`             | —       |
| [Video Download](/video-download) | `POST` | `/v1/video/download` | 1       |


# Introduction



Get started with the HuntAPI API in minutes. Make HTTP requests to our endpoints and receive structured JSON responses.

Quick Start [#quick-start]

<Steps>
  <Step>
    Get your API key [#get-your-api-key]

    Sign up on your [dashboard](https://app.huntapi.com) and copy your API key from the **Settings** page.
  </Step>

  <Step>
    Make your first request [#make-your-first-request]

    Include your key in the `x-api-key` header and call any endpoint:

    ```bash
    curl "https://api.huntapi.com/usage" \
      -H "x-api-key: YOUR_API_KEY"
    ```
  </Step>

  <Step>
    Handle the response [#handle-the-response]

    Every successful request returns a JSON object with structured data. See individual endpoint pages for response schemas and examples.
  </Step>
</Steps>

Authentication [#authentication]

All API requests must include an `x-api-key` header. You can find your key in your [dashboard settings](https://app.huntapi.com/settings).

```bash
curl -H "x-api-key: xxxx" https://api.huntapi.com/v1/usage
```

<Callout type="warn">
  Keep your API key secret. Do not expose it in client-side code or public repositories.
</Callout>

Status Codes [#status-codes]

Billing applies to successful requests: `200` for synchronous calls, `201` for asynchronous jobs, and `404` when the resource is not found (unless specified otherwise in the API documentation).

| Code  | Billed | Status              | Action                                                                                |
| ----- | ------ | ------------------- | ------------------------------------------------------------------------------------- |
| `200` | Yes    | Successful API Call | No action required.                                                                   |
| `201` | Yes    | Job Created         | No action required.                                                                   |
| `202` | No     | Accepted (Async)    | The request was accepted and is being processed. Use the job ID to check the status.  |
| `400` | No     | Bad Request         | Verify your parameters and their types. Check the documentation for more information. |
| `401` | No     | Invalid API Key     | Check your API key (`x-api-key` header or `x_api_key` query string).                  |
| `401` | No     | Inactive API Key    | Activate your API key in the API Keys section of your account settings.               |
| `401` | No     | Expired API Key     | Update your API key or generate a new one.                                            |
| `401` | No     | Rate Limit Exceeded | Consider upgrading your current plan or contact our sales team.                       |
| `402` | No     | Payment Required    | Settle any outstanding invoices to continue using the API.                            |
| `403` | No     | Forbidden           | Verify your permissions. Contact us if you believe this is a mistake.                 |
| `404` | Yes    | Not Found           | Result not found for this request. Some APIs do not bill 404.                         |
| `500` | No     | Internal Error      | Retry the action or contact our support team.                                         |

See the [Credits](/credits) page for a full breakdown of credit costs per endpoint.

Endpoints [#endpoints]

Browse all available endpoints in the sidebar, or jump directly:

<Cards>
  <Card title="Audio Download" href="/audio-download" />

  <Card title="Jobs" href="/jobs" />

  <Card title="Usage" href="/usage" />

  <Card title="Video Download" href="/video-download" />
</Cards>


# Jobs



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Fetch the status and result of a HuntAPI async job.

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/jobs","method":"get"}]} />


# Usage



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Get your HuntAPI plan and remaining requests.

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/usage","method":"get"}]} />


# Video Download



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Download a video from a URL via HuntAPI and receive a job id.

**Credit cost:** 1 credit per request

**Async:** This endpoint runs asynchronously. Use the jobs endpoint to poll for results.

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/video/download","method":"post"}]} />