Getting Started

It is quite easy to use RocketScrape API. Just send the URL you would like to scrape to the API, along with your API key, and the API will return the HTML response from your target URL.

API Key & Authentication

RocketScrape uses API keys to authenticate requests. In order to use the API you need to sign up for an account and include your unique API key in every request.

Making Requests

You can use the API to scrape web pages, API endpoints, images, documents, PDFs or other files just as you would any other URL. Note: there is a 2MB limit per request.

You can send GET requests to RocketScrape API via our API endpoint:

https://api.rocketscrape.com?apiKey={YOUR_API_KEY}&url=https://httpbin.org/ip

Or POST request:

https://api.rocketscrape.com/scrape

Body object accepts all parameters that are available for GET request:

{
    "url": "https://httpbin.org/ip",
    "apiKey": "{YOUR_API_KEY}"
}

Note: url and apiKey parameters are required.

What is credit?

A credit is a request inside the service. Every time you do a request, a credit is deducted from your account. We charge 1 credit per "general" request and 20 credits per "premium" request. (domains google, ebay, amazon, aliexpress, similarweb, zoominfo, booking, olx are considered as "premium").

Option render=true will charge additional 5 credits for "premium" and 10 credits for "common" requests.

API Status Codes

The API will return a specific status code after every request depending on whether the request was successful, failed or some other error occurred. RocketScrape API will retry failed requests for up to 60 seconds to try and get a successful response from the target URL before responding with a 500 error indicating a failed request.

Note: To avoid timing out your request before the API has had a chance to complete all retries, remember to set your timeout to 60 seconds.

Should a request fail after 60 seconds of retrying, you will not be charged for it (you are only charged for successful requests: 200 and 404 status codes).

Below is the list of status codes you might receive:

Code

Details

200

Successful response

404

The requested page doesn't exist

500

After retrying for 60 seconds, the API was unable to receive a successful response.

429

You are sending too many requests at once, and exceeding your concurrency limit.

403

You have used up all your API credits.

Last updated