Vainu API Free Trial

Get a Free Trial Token

➡️

Request Vainu API Free Trial from https://www.vainu.com/delivery-methods/api/

The trial token is perfect for:

• Testing the API before purchasing
• Evaluating Vainu data for your use case
• Learning the API structure and capabilities
• Prototyping integrations

JWT Authentication for Trial

Get an Access Token

Make a POST request with your refresh token:

import requests

REFRESH_TOKEN = "your_trial_refresh_token"
TOKEN_ENDPOINT = "https://api.vainu.io/api/token/refresh/"

payload = {
    "refresh": REFRESH_TOKEN
}

response = requests.post(TOKEN_ENDPOINT, json=payload)
token_response = response.json()
access_token = token_response["access"]

Use the Access Token

Include in your API requests:

headers = {
    "Authorization": f"Bearer {access_token}",
    "Content-Type": "application/json"
}

# Make API requests with this header

Token Lifecycle

The access token is valid for 12 hours. Refresh it when expired using the refresh token.

Reference Authentication Overview

Trial Limitations

Trial tokens come with the following limitations:

Example: Trial API Call

Make your first API call with trial token:

import requests

# 1. Get access token
REFRESH_TOKEN = "your_trial_refresh_token"
TOKEN_ENDPOINT = "https://api.vainu.io/api/token/refresh/"

token_resp = requests.post(TOKEN_ENDPOINT, json={"refresh": REFRESH_TOKEN})
access_token = token_resp.json()["access"]

# 2. Query companies
COMPANIES_ENDPOINT = "https://api.vainu.io/api/v3/organizations/"

payload = {
    "query": {"?EQ": {"industry_codes_local": ["62"]}},
    "database": "FI",
    "fields": ["business_id", "name", "domain"],
    "limit": 20  # Trial limit
}

headers = {
    "Authorization": f"Bearer {access_token}",
    "Content-Type": "application/json"
}

response = requests.post(COMPANIES_ENDPOINT, headers=headers, json=payload)
companies = response.json()["results"]

print(f"Found {len(companies)} software companies:")
for company in companies:
    print(f"  - {company['name']} ({company['domain']})")

Key Differences from Full API

Response Limit

Trial: Maximum 20 results per request

payload = {
    ...
    "limit": 20  # Max for trial
}

Full API: Up to full database exports

payload = {
    ...
    "limit": 100000
}

`

Rate Limiting

Trial: 1,000 requests per week total

Full API: Up to 5 concurrent requests with higher weekly limits

Concurrent Requests

Trial: 1 concurrent request only

# ✓ Allowed
response1 = requests.post(ENDPOINT, ...)
result1 = response1.json()  # Wait for response

# ✗ Not allowed (won't start until previous completes)
response2 = requests.post(ENDPOINT, ...)

Full API: Up to 5 concurrent requests

Upgrade from Trial

When ready to move to production:

1. Contact Vainu sales
2. Select appropriate pricing tier
3. Migrate to production API keys
4. Increase limits and get support

Common Trial Errors

Error: Rate Limit Exceeded

You've exceeded the 1,000 requests/week limit:

Status: 429 Too Many Requests
Error: Rate limit exceeded

Solution: Wait until next week or upgrade to full API.

Error: Query Exceeds 20 Results

Your limit is 20 results:

# Wrong - will fail
payload = {"limit": 100}

# Correct
payload = {"limit": 20}

Error: Endpoint Not Available

Trial only supports /api/v2/companies:

# Wrong - trial doesn't support this
endpoint = "https://api.vainu.io/api/v3/stats/"

# Correct - use v2
endpoint = "https://api.vainu.io/api/v3/organizations/"

After Trial Expires

When your 30-day trial expires:

• Access tokens will become invalid
• New token refresh will fail
• You'll need to upgrade or request a new trial

Contact support if you need an extension.

Getting Help

During your trial:

• Review API documentation in this guide
• Check code examples and best practices
• Contact support with questions
• Join Community Vainu Community Slack

Next Steps

• Explore Authentication methods
• Learn about Filtering Query Language
• Review Getting Started guide
• Check Organizations API for search capabilities

Ready to get started? Get your free trial token now!