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 to a Poix account if you haven’t already.
  2. Navigate to the 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: 
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. 
curl --request GET \
  --url https://api.poix.io/search \
  --header 'Authorization: Bearer YOUR_TOKEN'
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!