Skip to main content

​
Service usage

‘s search service delivers all organic and paid result types from popular search engines, reliably, as structured or raw data. The service has a RESTful interface that accepts GET requests at https://‍/search. Searches can be localized with geotargeting parameters. They’re performed live by default or optionally queued for subsequent retrieval. Live searches take an average of a few seconds but may require multiple retries, in which case up to 3 minutes is allocated per API call. Usage data is published regularly.

​
Authentication

You can access the service by including your secret API token in an Authorization header: 
Authorization: Bearer [API token here]
Here’s an example request that uses the common Curl command: 
curl -H "Authorization: Bearer $MASSIVE_TOKEN" \
'https://unblocker.joinmassive.com/search'\
'?terms=foo+bar+baz'

​
Search parameters

Besides the geotargeting and scheduling params linked above, required and optional search params can be added in a standard query string. The keys and values supports are as follows:
KeyRequiredValue
terms✅The broad or exact word or phrase of up to 255 characters to query (e.g., foo bar baz or "foo bar baz"); the terms require form or URL encoding (with any space character being replaced by a + character or %20 sequence)
serps⬜The number of results pages to retrieve, from 1 to 10 inclusive; 1 is the default count
size⬜The number of results per page to retrieve, from 0 to 100 inclusive; page size is unset by default
offset⬜The number of initial results to skip, from 0 to 100 inclusive; results aren’t offset by default
uule⬜The proprietary encoded string for emulating the location to search from; if possible, the actual location is searched from not emulated; location emulation is unused by default
language⬜The commonly spelled name, two-letter ISO code, or Google code of the language to search in (these names and codes are case insensitive but required to include form- or URL-encoded spaces and punctuation marks); the language is unset by default
display⬜The commonly spelled name, two-letter ISO code, or Google code of the search interface’s display language (these names and codes are case insensitive but required to include form- or URL-encoded spaces and punctuation marks); the display language is unset by default or set to the language if given
awaiting⬜The lazy result features to wait to load, an ai overview or “People also ask” answers; any AI overview, which can take significant time to generate, is awaited for a maximum of 1 minute; multiple features can be provided by repeating the key; lazy results aren’t awaited by default
expiration⬜The age in days of when to consider cached results expired, where 0 disables caching; 1 is the default number of days before expiration

​
Response format

Search results are returned as rendered HTML. If you request multiple results pages that don’t feature infinite scrolling, the HTML of each page will be separated from the next by an empty line (\n\n).

​
Additional examples

​
Results omission

curl -H "Authorization: Bearer $MASSIVE_TOKEN" \
'https://unblocker.joinmassive.com/search'\
'?terms=vpn+comparison'\
'&size=100'\
'&offset=20'

​
Lazy results

curl -H "Authorization: Bearer $MASSIVE_TOKEN" \
'https://unblocker.joinmassive.com/search'\
'?terms=how+tall+is+mount+everest'\
'&awaiting=ai'\
'&awaiting=answers'