Introduction
Welcome to DataForSEO API!
DataForSEO API is the starting point on your journey towards building powerful SEO software. With DataForSEO you can get all the data you need to build an efficient application while also saving your time and budget.
DataForSEO API is using the REST technology for interchanging data between your application and our service. The data exchange is made through the widely used HTTP protocol, which allows applying our API to almost all programming languages.
You can create your REST class or use the following ready-made classes:
| Language | Description |
|---|---|
| PHP DataForSEO Client | Recommended: officially supported PHP Client. Author Vitaliy Lyabakh – jovixv |
| C# DataForSEO Client | Recommended: officially supported C# Client. Author – DataForSEO team |
| Java DataForSEO Client | Recommended: officially supported Java Client. Author – DataForSEO team |
| Python DataForSEO Client | Recommended: officially supported Python Client. Author – DataForSEO team |
| TypeScript DataForSEO Client | Recommended: officially supported TypeScript Client. Author – DataForSEO team |
| PHP Simple Rest Client | PHP REST Client build with cURL. Author Fabio Agostinho Boris. |
| Python Simple Rest Client | Python REST Client. Author DataForSEO. |
To get started with the DataForSEO SERP API and LangChain integration, visit the DataForSEO API Wrapper page.
Below you’ll find PHP, Python, C# examples:
| Language | Description |
|---|---|
| PHP Examples | PHP code examples |
| Python Examples | Python code examples |
| C# Examples | C# code examples |
| POSTMAN Examples | POSTMAN examples |
| POSTMAN Documenter | Online POSTMAN Documenter |
Data encoding
All data you send to DataForSEO API should be UTF-8 encoded.
If you use one of the Clients listed in the first table, gzip will be the default format of data exchange. You will see Content-Encoding: gzip in the header.
All the responses are returned in the JSON format by default, but we also support responses in the XML format – just append .xml to the end of your request. In addition to that, you can request HTML results from endpoints that return HTML-encoded results by appending .html to the end of the request’s URL path.
For example, the following requests will return response encoded in XML or HTML accordingly:
https://api.dataforseo.com/v3/appendix/user_data.xml
https://api.dataforseo.com/v3/serp/google/organic/task_get/html/09061543-1535-0066-0000-6240830f56ba.html
Rate Limits
Each of DataForSEO APIs has a certain rate limit, which you can find in the HTTP header of every endpoint.
Rate limit HTTP headers we use:
X-RateLimit-Limit – the rate limit ceiling per minute for the given endpoint;
X-RateLimit-Remaining – the number of requests remaining in the current rate limit window.
If your system requires rate limits to be increased, please contact our support team.
Results storage
The term for storing API results in our system depends on the API and method of data retrieval.
Standard method: results are stored for 30 days*
Live method: results are not stored*
HTML results: results are stored for 7 days
*for SERP API in both Standard and Live methods, the results in JSON format are stored for 30 days.
To learn more about the terms of results storage, check this Help Center article.