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

# Quickstart

> Learn how to make your first request using the Poix API

This guide will walk you through making your first request to the Poix API. We'll cover authentication and a simple API call to get you started.

## Step 1: Create Your Token

1. [Login](https://app.poix.io/login) to a Poix account if you haven't already.
2. Navigate to the [Tokens](https://app.poix.io/tokens) page in the dashboard.
3. Create a new Token and copy it. Keep this key secure and don't share it publicly.

## Step 2: Authentication

Poix uses Tokens for authentication. Include your Token in the `Authorization` header of your requests:

```bash theme={null}
Authorization: Bearer YOUR_TOKEN
```

## Step 3: Make Your First API Request

Let's make a simple request to get information about a YouTube video. We'll use the `/search` endpoint for this example.

Replace `YOUR_TOKEN` with your actual Token.

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.poix.io/search \
    --header 'Authorization: Bearer YOUR_TOKEN'
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.poix.io/search"

  headers = {"Authorization": "Bearer YOUR_TOKEN"}

  response = requests.request("GET", url, headers=headers)

  print(response.text)
  ```

  ```js JavaScript theme={null}
  const options = {
    method: 'GET',
    headers: {
      Authorization: 'Bearer YOUR_TOKEN',
    },
  };

  fetch('https://api.poix.io/search', options)
    .then((response) => response.json())
    .then((response) => console.log(response))
    .catch((err) => console.error(err));
  ```
</CodeGroup>

If successful, you'll receive a JSON response with details:

```json theme={null}
{
    "regionCode": "US",
    "totalResults": 1000000,
    "resultsPerPage": 10,
    "nextPageToken": "CAoQAA",
    "data": [
        {
            "kind": "youtube#video",
            "videoId": "VZ91YQ8yhkY",
            "publishedAt": "2024-09-25T17:00:21Z",
            "channelId": "UCtXn8EDGHrAL9gLppoHZXSg",
            "title": "Super Weird Things Only MALE Cats Do For Their",
           // ... other details
```

## Next Steps

Congratulations! You've made your first request to the Poix API. Here are some next steps:

1. Explore the [API Reference](/api-reference) to learn about other endpoints.
2. Check out our [Guides](/guides) for best practices and advanced usage.
3. If you have any questions, [contact support](mailto:support@poix.io).

Happy coding!