NAVNavbar
Logo
php python csharp java

Sandbox

Sandbox is a technical environment for developers where DataForSEO API can be used without unnecessary expenses.

Description of the dynamic field:

path API path
specify the path to the endpoint you’d like to test
example:
serp/google/maps/task_post

 

Sandbox cost and use case

Sandbox is completely free for any registered user at DataForSEO. The main use case for Sandbox is configuring your software to work with our data.

It is not necessary to spend money on actual API calls while integrating DataForSEO API. The sandbox allows sending requests to any DataForSEO API and getting the results for free.

Note that these will be only generic responses. All the results you receive within Sandbox contain dummy data. However, the structure and fields of the sandbox response are identical to that of the actual API response.

How to use Sandbox for SERP API?

In order to use sandbox endpoints, you need to change the hostname in the URL when sending an API call from api.dataforseo.com/v3/ to sandbox.dataforseo.com/v3/

There is no need to adjust the code or make any other changes to POST data.

If you want to set a SERP API task through the sandbox, you should use the following URL structure:
https://sandbox.dataforseo.com/v3/serp/google/organic/task_post

To collect the results of the task through the sandbox, it’s necessary to make a GET request with the URL structure as in the example:
https://sandbox.dataforseo.com/v3/serp/google/organic/task_get/advanced/$id

If you want to use the sandbox to see the structure of all available SERP features and extra elements on the search engine results page, you can request the following URL:
https://sandbox.dataforseo.com/v3/serp/google/organic/task_get/advanced/00000000-0000-0000-0000-000000000000
The response will include all available items in the Google Organic SERP Advanced endpoint with the fields containing dummy data.

How to use Sandbox for Keywords Data API?

To send a request to any Keywords Data API endpoint, you should follow the same principle.

Just change the hostname in the URL of your request according to the example:
https://sandbox.dataforseo.com/v3/keywords_data/google/search_volume/task_post

After that, make a GET request to the API server to retrieve sample results with the same change in the URL structure:
https://sandbox.dataforseo.com/v3/keywords_data/google/search_volume/task_get/$id

How to use Sandbox for Traffic Analytics API?

To send a request to any Traffic Analytics API endpoint, you should follow the same principle.

Just change the hostname in the URL of your request according to the example:
https://sandbox.dataforseo.com/v3/traffic_analytics/similarweb/task_post

After that, make a GET request to the API server to retrieve sample results with the same change in the URL structure:
https://sandbox.dataforseo.com/v3/traffic_analytics/similarweb/task_get/$id

Sandbox for Live tasks

Sandbox is also available for Live tasks in both SERP API and Keywords Data API.
If you want to test the Live method, use the URL structure as provided below:

https://sandbox.dataforseo.com/v3/keywords_data/google/search_volume/live
https://sandbox.dataforseo.com/v3/serp/google/organic/live/regular
https://sandbox.dataforseo.com/v3/traffic_analytics/similarweb/live