{"id":7,"date":"2019-09-28T10:24:15","date_gmt":"2019-09-28T10:24:15","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/?page_id=7"},"modified":"2025-11-18T11:41:16","modified_gmt":"2025-11-18T11:41:16","slug":"home","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/","title":{"rendered":"Introduction"},"content":{"rendered":"

[vc_row][vc_column][vc_column_text css=””]<\/p>\n

Introduction<\/h1>\n

Welcome to DataForSEO API!<\/h3>\n

This is the starting point on your journey towards building powerful SEO software, data analysis pipelines, and robust no-code automations. With DataForSEO you can get all the data you need while saving your time and budget.<\/p>\n

Getting started<\/h3>\n

Follow our recommended learning path to master DataForSEO APIs.<\/p>\n

1. Kickstart Guide to our APIs<\/a>
\n2. Dashboard Guide<\/a>
\n3. Test with API Playground<\/a>
\n4. Free Unlimited Trial Info<\/a>
\n5. Sandbox Best Practices<\/a>\n<\/p>\n

REST technology<\/h3>\n

DataForSEO API is using\u00a0the REST<\/a>\u00a0technology 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.<\/p>\n

Client libraries<\/h3>\n

You can create your REST class or use the following ready-made classes:
\n

\n
\n \"PHP\n \"PHP\n
PHP DataForSEO Client<\/div>\n <\/div>\n
Recommended: officially supported PHP Client. Author \u2013 Vitaliy Lyabakh \u2013 jovixv<\/div>\n <\/a>\n \n
\n \"C#\n \"C#\n
C# DataForSEO Client<\/div>\n <\/div>\n
Recommended: officially supported C# Client. Author \u2013 DataForSEO team<\/div>\n <\/a>\n \n
\n \"Java\n \"Java\n
Java DataForSEO Client<\/div>\n <\/div>\n
Recommended: officially supported Java Client. Author \u2013 DataForSEO team<\/div>\n <\/a>\n \n
\n \"Python\n \"Python\n
Python DataForSEO Client<\/div>\n <\/div>\n
Recommended: officially supported Python Client. Author \u2013 DataForSEO team<\/div>\n <\/a>\n \n
\n \"TypeScript\n \"TypeScript\n
TypeScript DataForSEO Client<\/div>\n <\/div>\n
Recommended: officially supported TypeScript Client. Author \u2013 DataForSEO team<\/div>\n <\/a>\n \n
\n \"PHP\n \"PHP\n
PHP Simple Rest Client<\/div>\n <\/div>\n
PHP REST Client build with cURL. Author \u2013 Fabio Agostinho Boris.<\/div>\n <\/a>\n \n
\n \"Python\n \"Python\n
Python Simple Rest Client<\/div>\n <\/div>\n
Python REST Client. Author \u2013 DataForSEO.<\/div>\n <\/a>\n <\/div>\n

PHP, Python, C# and Postman examples<\/h3>\n

Choose your preferred programming language or API testing tool.
\n

\n
\n \"PHP\n \"PHP\n
PHP Examples<\/div>\n <\/div>\n
PHP code examples<\/div>\n <\/a>\n \n
\n \"Python\n \"Python\n
Python Examples<\/div>\n <\/div>\n
Python code examples<\/div>\n <\/a>\n \n
\n \"C#\n \"C#\n
C# Examples<\/div>\n <\/div>\n
C# code examples<\/div>\n <\/a>\n \n
\n \"POSTMAN\n \"POSTMAN\n
POSTMAN Examples<\/div>\n <\/div>\n
POSTMAN examples<\/div>\n <\/a>\n \n
\n \"POSTMAN\n \"POSTMAN\n
POSTMAN Documenter<\/div>\n <\/div>\n
Online POSTMAN Documenter<\/div>\n <\/a>\n <\/div>\n

Data encoding<\/h3>\n

All data you send to DataForSEO API should be UTF-8<\/a> encoded.<\/p>\n

If you use one of the Clients listed in the first table, gzip<\/a> will be the default format of data exchange. You will see Content-Encoding: gzip<\/code> in the header.<\/p>\n

All the responses are returned in the JSON<\/a>\u00a0format by default, but we also support responses in the XML<\/a>\u00a0format – just append .xml<\/code> 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<\/code> to the end of the request’s URL path.<\/p>\n

For example, the following requests will return response encoded in XML or HTML accordingly:
\nhttps:\/\/api.dataforseo.com\/v3\/appendix\/user_data.xml<\/code>
\nhttps:\/\/api.dataforseo.com\/v3\/serp\/google\/organic\/task_get\/html\/09061543-1535-0066-0000-6240830f56ba.html<\/code><\/p>\n

Rate limits<\/h3>\n

Each of DataForSEO APIs has a certain rate limit, which you can find in the HTTP header of every endpoint.<\/p>\n

Rate limit HTTP headers we use:
\nX-RateLimit-Limit<\/code> \u2013 the rate limit ceiling per minute for the given endpoint;
\nX-RateLimit-Remaining<\/code> \u2013 the number of requests remaining in the current rate limit window.<\/p>\n

If your system requires rate limits to be increased, please contact our support team.<\/p>\n

Results storage<\/h3>\n

The term for storing API results in our system depends on the API and method of data retrieval.<\/p>\n