Features

Base URL

All requests contain the following base URL:
https://api.supadata.ai/v1

Authentication

For authentication, it’s required to include a x-api-key header.
x-api-key: {YOUR_API_KEY}

Response codes

Supadata employs conventional HTTP status codes to signify the outcome of your requests. Typically, 2xx HTTP status codes denote success, 4xx codes represent failures related to the user, and 5xx codes signal infrastructure problems.
StatusDescription
200Request was successful.
400Verify the correctness of the parameters.
401The API key was not provided.
402Payment required.
404The requested resource could not be located.
429A plan limit has been surpassed.
5xxSignifies a server error with Supadata.
Refer to the Error Codes section for a detailed explanation of all potential API errors.

Rate limit

The Supadata API has a rate limit to ensure the stability and reliability of the service. The rate limit is applied to all endpoints and is based on the number of requests made within a specific time frame and your current subscription plan. When you exceed the rate limit, you will receive a 429 response code.