Skip to main content
This guide walks you through everything you need to make your first successful Vook API call — from creating your account to reading a live JSON response. By the end, you’ll have a working setup you can build on. The whole process takes less than five minutes.

​
Prerequisites

Before you start, make sure you have the following:
  • A Vook account — sign up for free at app.vook.ai if you don’t have one yet.
  • An API key — you’ll generate this in Step 2 below.
  • A way to make HTTP requests — the examples here use curl, but any HTTP client works.

​
Steps

1

Create your account

Head to app.vook.ai and sign up for a free Vook account. Fill in your name, email address, and a password, then confirm your email. Once you’re in, you’ll land on your Vook dashboard.
2

Get your API key

From your dashboard, navigate to Settings → API Keys and click Generate New Key. Give your key a descriptive name — for example, my-first-integration — so you can identify it later.Copy the key immediately and store it somewhere safe, such as a password manager or a .env file. Vook will only show you the full key once.
If you lose your API key, you can always revoke it and generate a new one from the same Settings → API Keys page. Old keys stop working the moment they’re revoked.
3

Make your first request

With your API key in hand, send a request to the Vook API root endpoint. Replace YOUR_API_KEY with the key you just generated:
curl https://api.vook.ai/v1/ \
  -H "Authorization: Bearer YOUR_API_KEY"
This request authenticates you and returns basic information about the API — a good way to confirm everything is wired up correctly before you start building.
4

Check the response

If your request was successful, you’ll receive a 200 OK response with a JSON body like this:
{
  "status": "ok",
  "version": "1.0"
}
A "status": "ok" response means your API key is valid, your request was authenticated, and you’re ready to start using the API. If you see a 401 error instead, double-check that you’ve copied your API key correctly and that it’s included in the Authorization header.
Now that you’ve made your first request, explore the API Reference to see every available endpoint, understand the full request and response schemas, and start building your integration.