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. Sandbox environment also works with pingback_url
and postback_url
functions.
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.
Sandbox has the same rate limits as the production environment and allows sending 2000 API calls per minute with each POST call containing no more than 100 tasks. The live method allows sending 2000 API calls per minute as well, but each POST call can contain only 1 task.
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 Domain Analytics API?
To send a request to any Domain 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/domain_analytics/technologies/aggregation_technologies/live
Since all Domain Analytics API endpoints have the live method of delivering data, you won’t have to make a separate GET request to retrieve results.
How to use Sandbox for DataForSEO Labs API?
To send a request to any DataForSEO Labs 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/dataforseo_labs/google/related_keywords/live
Since all DataForSEO Labs API endpoints have the live method of delivering data, you won’t have to make a separate GET request to retrieve results.
How to use Sandbox for Backlinks API?
To send a request to any Backlinks 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/backlinks/referring_domains/live
Since all Backlinks API endpoints have the live method of delivering data, you won’t have to make a separate GET request to retrieve results.
How to use Sandbox for OnPage API?
To send a request to any OnPage 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/on_page/task_post
After that, make another POST request to the API server to retrieve sample results with the same change in the URL structure:
https://sandbox.dataforseo.com/v3/on_page/pages
https://sandbox.dataforseo.com/v3/on_page/links
How to use Sandbox for Content Analysis API?
To send a request to any Content Analysis API endpoint, change the hostname in the URL of your request according to the example:
https://sandbox.dataforseo.com/v3/content_analysis/search/live
The API server will provide you with sample results in response.
How to use Sandbox for Merchant API?
To send a request to any Merchant 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/merchant/google/products/task_post
After that, make another GET request to the API server to retrieve sample results with the same change in the URL structure:
https://sandbox.dataforseo.com/v3/merchant/google/products/task_get/advanced/$id
How to use Sandbox for App Data API?
To send a request to any App 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/app_data/google/app_searches/task_post
After that, make another GET request to the API server to retrieve sample results with the same change in the URL structure:
https://sandbox.dataforseo.com/v3/app_data/google/app_searches/task_get/advanced/$id
How to use Sandbox for Business Data API?
To send a request to any Business 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/business_data/google/hotel_info/task_post
After that, make another GET request to the API server to retrieve sample results with the same change in the URL structure:
https://sandbox.dataforseo.com/v3/business_data/google/hotel_info/task_get/advanced/$id
Sandbox for Live tasks
Sandbox is also available for Live tasks in any 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/dataforseo_labs/google/ranked_keywords/live
https://sandbox.dataforseo.com/v3/dataforseo_labs/google/related_keywords/live
https://sandbox.dataforseo.com/v3/dataforseo_labs/google/competitors_domain/live
https://sandbox.dataforseo.com/v3/backlinks/referring_domains/live