Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vintl.io/llms.txt

Use this file to discover all available pages before exploring further.

Each API key has a daily request quota. Limits reset at midnight UTC.

​
Plans

PlanPriceDaily limit
Free$0500
Indie$49/mo10,000
Pro$149/mo50,000
Intelligence$349/mo200,000
Team$799/mo500,000

​
Response headers

Every authenticated response includes rate limit headers: 
RateLimit-Limit: 10000
RateLimit-Remaining: 9987
RateLimit-Reset: 1711235414
X-RateLimit-Tier: indie
HeaderDescription
RateLimit-LimitYour daily quota
RateLimit-RemainingRequests left today
RateLimit-ResetUnix timestamp when the quota resets
X-RateLimit-TierYour plan name
Retry-AfterSeconds until you can retry (only on 429)
Legacy X-RateLimit-* variants are included for backward compatibility.

​
Handling 429

When you exceed your limit, the API returns 429 Too Many Requests with a Retry-After header. Respect it — don’t retry in a loop.
retry.py
import time
import requests

def fetch(url, headers, params=None, retries=3):
    for _ in range(retries):
        resp = requests.get(url, headers=headers, params=params)
        if resp.status_code != 429:
            return resp
        time.sleep(int(resp.headers.get("Retry-After", 60)))
    return resp
Each paginated page counts as one request. Fetching 10,000 rows at limit=1000 uses 10 requests, not 10,000.
Last modified on March 29, 2026