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 API Token

  1. Login to a Poix account if you haven’t already.
  2. Navigate to the Tokens section in your dashboard.
  3. Create a new Token and copy it. Keep this key secure and don’t share it publicly.

Step 2: Authentication

Poix uses API tokens for authentication. Include your Token in the Authorization header of your requests:

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 API key.

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

{
    "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 to learn about other endpoints.
  2. Check out our Guides for best practices and advanced usage.
  3. If you have any questions, contact support.

Happy coding!