Service usage
‘s browser service navigates intelligently on your behalf, rendering JavaScript,
solving captchas, and retrying failed requests. The service
has a RESTful interface that accepts GET requests at
https:///browser.
Webpages can be localized with geotargeting parameters. They’re
retrieved in real time by default or optionally queued for subsequent
retrieval. Up to 3 minutes is allotted per real-time API call to accommodate
captcha-solving, multiple retries, and other mitigations. Usage data is
published regularly.
If a site you’re targeting remains blocked, even with different browsing params, let us know. We can usually help unblock any site within 48
hours. Authentication
You can access the service by including your secret API token in an Authorization header:
Authorization: Bearer [API token here]
$ curl -H "Authorization: Bearer $MASSIVE_TOKEN" \
'https://unblocker.joinmassive.com/browser'\
'?url=https://example.com/'
This endpoint autoscales; if you receive a 503 response, maintain traffic and expect errors to resolve within a few minutes.
Browsing parameters
Besides the geotargeting and scheduling params linked above, required and optional
browsing params can be added in a
standard query string.
The keys and values supports are as follows:
| Key | Required | Premium | Value |
|---|
url | ✅ | ⬜ | The URL of the page to browse; any unsafe characters require URL encoding |
difficulty | ⬜ | ✅ | The difficulty pool to attempt to access the URL from, low, medium, or high (coming soon); low is the default difficulty |
speed | ⬜ | ✅ | The speed to attempt to access the URL at, light, ridiculous, or ludicrous (planned), where ridiculous is 30 percent faster on average than light speed; light is the default speed |
device | ⬜ | ⬜ | The name as returned by the devices resource of the device to emulate browsing on (these names are case insensitive but must include form- or URL-encoded spaces and punctuation marks); device emulation is unused by default |
ip | ⬜ | ⬜ | The type of IP address to browse from, residential, isp, or datacenter (planned); a random IP type is used by default |
captcha | ⬜ | ⬜ | The intended resolution of any detected captcha, solved, ignored, or rejected, where rejected results in a 403 response; solved is the default captcha resolution |
readiness | ⬜ | ⬜ | The standard ready event to await before snapshotting browsed content, load or domcontentloaded; load is the default ready event |
delay | ⬜ | ⬜ | The number of supplemental seconds to delay before snapshotting browsed content, from .1 to 10 inclusive; no delay is used by default |
format | ⬜ | ⬜ | The format to output to, rendered, raw, or markdown (see the section below); rendered is the default format |
expiration | ⬜ | ⬜ | The age in days of when to consider cached content expired, where 0 disables caching; 1 is the default number of days before expiration |
Device emulation
The device param lets you fetch device-specific content, rather than the default desktop content.
For a list of supported smartphone and tablet devices, make a request with your API token and no
params to https:///browser/devices:
$ curl -H "Authorization: Bearer $MASSIVE_TOKEN" \
'https://unblocker.joinmassive.com/browser/devices'
[
"Blackberry PlayBook",
"Blackberry PlayBook landscape",
"BlackBerry Z30",
"[Remaining device names here]"
]
$ curl -H "Authorization: Bearer $MASSIVE_TOKEN" \
'https://unblocker.joinmassive.com/browser'\
'?url=https://crackberry.com/'\
'&device=blackberry+playbook'
Sticky sessions
To reuse a browser session across requests, set a cookie named session:
$ curl -H "Authorization: Bearer $MASSIVE_TOKEN" \
-H 'Cookie: session=12345' \
'https://unblocker.joinmassive.com/browser'\
'?url=https://www.imdb.com/title/tt0094012'
Additional examples
Cachebusting
$ curl -H "Authorization: Bearer $MASSIVE_TOKEN" \
'https://unblocker.joinmassive.com/browser'\
'?url=https://api.weather.gov/alerts'\
'&expiration=0'
