Search

'/api/search' API endpoint allows you to scrape the results from Google search engine via our Scrappa.co service. Head to the playground for a live and interactive demo. You can query 'https://app.scrappa.co/api/search' using a 'GET' request.

Endpoint

GET


                        /api/search

Parameters

query


                                        string

Required

The search query. Supports Google operators like site:, inurl:, intitle:.

Example: coffee shop

google_domain


                                        string

Optional

Google domain to use for search.

Default: google.com

Examples: google.co.uk, google.de, google.fr


                                        string

Optional

Restrict search to one or more countries (pipe-delimited).

Format: country{CODE}|country{CODE}

Example: countryFR|countryDE


                                        string

Optional

2-letter language code for search interface.

Examples: en, es, fr, de

For full list: Google Languages


                                        string

Optional

Restrict results to one or more languages (pipe-delimited).

Format: lang_{code}|lang_{code}

Example: lang_en|lang_fr

ludocid


                                        string

Optional

Google Customer ID for places (from Google Maps/Local results).

Example: 12345678901234567890

lsig


                                        string

Optional

Knowledge graph map signature ID for forcing knowledge graph map view.

Can be found using Local Pack API or Google My Business redirect.

kgmid


                                        string

Optional

Google Knowledge Graph ID for specific entities.

Example: /g/11b6gq7c8p


                                        string

Optional

Encrypted cached search parameters provided by Google.

Returns results for originally encrypted search parameters.

ibp


                                        string

Optional

Controls rendering layouts and expansions for elements.

Example: gwp;0,7 (expand knowledge graph)

uds


                                        string

Optional

Google-provided filter strings for refining search.

Provided by Google in filter options.

tbs


                                        string

Optional

Advanced search parameters including dates, patents, and content filters.

Note: Cannot be used with as_qdr parameter.

Example: cdr:1,cd_min:1/1/2020,cd_max:12/31/2020 (custom date range)

as_qdr


                                        string

Optional

Simple time range filter.

Note: Cannot be used with tbs parameter.

Values: h (hour), d (day), w (week), m (month), y (year)

With numbers: h1, d2, w3, m6, y1

safe


                                        string

Optional

Adult content filtering level.

Values: active (filter explicit content), off (no filtering)

Default: Google blurs explicit content

nfpr


                                        string

Optional

Exclude auto-corrected results when original query is misspelled.

Values: 0 (include corrections), 1 (exclude corrections)

filter


                                        string

Optional

Enable/disable filters for similar and omitted results.

Values: 0 (disable filters), 1 (enable filters, default)

tbm


                                        string

Optional

Type of search to perform.

Values:

isch - Image search
vid - Video search
nws - News search
lcl - Local search
shop - Shopping search
pts - Patents search

start


                                        string

Optional

Result offset for pagination (0-indexed).

Example: 0 (first page), 10 (second page), 20 (third page)

page


                                        string

Optional

Page number (0-indexed). Maps to start internally.

Example: 0 (first page), 1 (second page)

amount


                                        string

Optional

Results per page. Maps to num internally.

Range: 1-100

Request Examples

<?php

$curl = curl_init();

curl_setopt_array($curl, [
	CURLOPT_URL => "https://app.scrappa.co/api/search?query=coffee&hl=en&safe=active&tbm=nws",
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_ENCODING => "",
	CURLOPT_MAXREDIRS => 10,
	CURLOPT_TIMEOUT => 30,
	CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
	CURLOPT_CUSTOMREQUEST => "GET",
	CURLOPT_HTTPHEADER => [
		"x-api-key: YOUR_API_KEY_HERE"
	],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
	echo "cURL Error #:" . $err;
} else {
	echo $response;
}

const url = 'https://app.scrappa.co/api/search?query=coffee&hl=en&safe=active&tbm=nws';
const options = {
	method: 'GET',
	headers: {
		'x-api-key': 'YOUR_API_KEY_HERE',
	}
};

try {
	const response = await fetch(url, options);
	const result = await response.text();
	console.log(result);
} catch (error) {
	console.error(error);
}

require 'uri'
require 'net/http'

url = URI("https://app.scrappa.co/api/search?query=coffee&hl=en&safe=active&tbm=nws")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = 'YOUR_API_KEY_HERE'

response = http.request(request)
puts response.read_body

import http.client

conn = http.client.HTTPSConnection("app.scrappa.co")

headers = {
    'x-api-key': "YOUR_API_KEY_HERE",
}

conn.request("GET", "/api/search?query=coffee&hl=en&safe=active&tbm=nws", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
	.url("https://app.scrappa.co/api/search?query=coffee&hl=en&safe=active&tbm=nws")
	.get()
	.addHeader("x-api-key", "YOUR_API_KEY_HERE")
	.build();

Response response = client.newCall(request).execute();

Response Schema

[
    {
        "title": null,
        "description": null,
        "json_sample": {
            "data": [
                {
                    "url": "https://en.wikipedia.org/wiki/Mike_Tyson",
                    "title": "Mike Tyson - Wikipedia",
                    "domain": "en.wikipedia.org",
                    "position": 1,
                    "sitelinks": [
                        {
                            "url": "https://en.wikipedia.org/wiki/Mike_Tyson_vs._Buster_Douglas",
                            "title": "Vs. Buster Douglas"
                        },
                        {
                            "url": "https://en.wikipedia.org/wiki/Mike_Tyson_(disambiguation)",
                            "title": "Mike Tyson (disambiguation)"
                        },
                        {
                            "url": "https://en.wikipedia.org/wiki/Mike_Tyson_vs._Evander_Holyfield",
                            "title": "Vs. Evander Holyfield"
                        },
                        {
                            "url": "https://en.wikipedia.org/wiki/Mike_Tyson%27s_tattoos",
                            "title": "Tattoos"
                        }
                    ],
                    "description": "Michael Gerard Tyson (born June 30, 1966) is an American former professional boxer who competed between 1985 and 2024. Nicknamed \"Iron Mike\" and \"Kid\u00a0...  \u00b7   \u00b7   \u00b7"
                },
                {
                    "url": "https://x.com/miketyson?lang=en",
                    "title": "Mike Tyson (@MikeTyson) / X",
                    "domain": "x.com",
                    "position": 2,
                    "sitelinks": [],
                    "description": "Condolences to George Foreman's family. His contribution to boxing and beyond will never be forgotten. Image. 3K. 35K. 327K. 8M \u00b7 Mike Tyson reposted \u00b7 TURKI\u00a0..."
                },
                {
                    "url": "https://www.instagram.com/miketyson/",
                    "title": "Mike Tyson (@miketyson) \u2022 Instagram photos and videos",
                    "domain": "www.instagram.com",
                    "position": 3,
                    "sitelinks": [],
                    "description": "Mike Tyson knows what it takes to be the best. Here he is dropping nothing but pure knowledge on how to become one of the greats, no matter what field you're in\u00a0..."
                },
                {
                    "url": "https://www.tiktok.com/@iamjazzysworldtv/video/7437178269297839402?lang=en",
                    "title": "Mike Tyson's Battle: Legacy vs. Jake Paul - TikTok",
                    "domain": "www.tiktok.com",
                    "position": 4,
                    "sitelinks": [],
                    "description": "Nov 14, 2024  \u00b7  give me Muhammad Ali. i'mma show you how great I am! great I am! great I am! this kid's gonna be someone. better than anybody I ever knew. I\u00a0..."
                },
                {
                    "url": "https://www.nytimes.com/athletic/6397953/2025/06/03/new-mike-tyson-biography-author-mark-kriegel/",
                    "title": "Author of new Mike Tyson biography examines boxer's complicated ...",
                    "domain": "www.nytimes.com",
                    "position": 5,
                    "sitelinks": [],
                    "description": "1 day ago  \u00b7  The Athletic's Andrew Marchand talked with Mark Kriegel, author of a new biography of Tyson."
                },
                {
                    "url": "https://boxrec.com/en/box-pro/474",
                    "title": "Mike Tyson - BoxRec",
                    "domain": "boxrec.com",
                    "position": 6,
                    "sitelinks": [
                        {
                            "url": "https://boxrec.com/en/box-pro/584",
                            "title": "James Douglas"
                        },
                        {
                            "url": "https://boxrec.com/en/box-pro/7386",
                            "title": "Kevin McBride"
                        },
                        {
                            "url": "https://boxrec.com/jp/box-am/474",
                            "title": "Box-am"
                        },
                        {
                            "url": "https://boxrec.com/ru/box-pro/6522",
                            "title": "Danny Williams"
                        }
                    ],
                    "description": "ID#, 000474. birth name, Michael Gerard Tyson. sex, male. alias, Iron. age, 58. nationality, USA. stance, orthodox. height, 5\u2032 10\u2033 / 178cm.  \u00b7   \u00b7   \u00b7"
                },
                {
                    "url": "https://www.instagram.com/reel/DBmTTt_yw9k/?hl=en",
                    "title": "Mike Tyson | Jake's wake in 20 days #PaulTyson - Instagram",
                    "domain": "www.instagram.com",
                    "position": 7,
                    "sitelinks": [],
                    "description": "Oct 26, 2024  \u00b7  Jake's wake in 20 days #PaulTyson ... The strongest I've ever seen you. Yeah. Yeah, the strongest I've ever and I know you since you're thirteen."
                },
                {
                    "url": "https://lithub.com/confessions-of-a-pugilist-what-mike-tyson-learned-from-his-mother-and-alexander-the-great/",
                    "title": "Confessions of a Pugilist: What Mike Tyson Learned from His Mother ...",
                    "domain": "lithub.com",
                    "position": 8,
                    "sitelinks": [],
                    "description": "2 hours ago  \u00b7  In December 2013, not long after the publication of Mike Tyson's autobiography, The Wall Street Journal asked him\u2014along with forty\u2011nine\u00a0..."
                },
                {
                    "url": "https://www.tiktok.com/@miketyson?lang=en",
                    "title": "Mike Tyson (@miketyson) - TikTok",
                    "domain": "www.tiktok.com",
                    "position": 9,
                    "sitelinks": [],
                    "description": "Mike Tyson (@miketyson) on TikTok | 29.3M Likes. 6M Followers. Official TikTok of Mike Tyson Shop Tyson gear \u2b07. Former professional boxer, undisputed\u00a0..."
                },
                {
                    "url": "https://www.bbc.com/sport/boxing/articles/c62n06zvj52o",
                    "title": "Moses Itauma: Breaking Mike Tyson's record was 'impossible' - BBC",
                    "domain": "www.bbc.com",
                    "position": 10,
                    "sitelinks": [],
                    "description": "7 days ago  \u00b7  Rising British star Moses Itauma says it was \"impossible\" for him to break Mike Tyson's record for the youngest heavyweight world champion."
                },
                {
                    "url": "https://x.com/MikeTyson/status/1857886940097556646?lang=en",
                    "title": "Mike Tyson on X",
                    "domain": "x.com",
                    "position": 11,
                    "sitelinks": [],
                    "description": "Nov 16, 2024  \u00b7  Mike Tyson \u00b7 @MikeTyson. This is one of those situations when you lost but still won. I'm grateful for last night. No regrets to get in ring\u00a0..."
                },
                {
                    "url": "https://www.espn.com/boxing/story/_/id/45268611/making-mike-tyson-mark-kriegel-excerpt",
                    "title": "The moment a 14-year-old Mike Tyson nearly quit in the ring - ESPN",
                    "domain": "www.espn.com",
                    "position": 12,
                    "sitelinks": [],
                    "description": "2 days ago  \u00b7  Mark Kriegel's excerpt from \"Baddest Man: The Making of Mike Tyson\" looks at the fights of a 14-year-old Tyson."
                },
                {
                    "url": "https://www.youtube.com/watch?v=Aja2KfuoqGA",
                    "title": "Jake Paul vs. Mike Tyson FIGHT HIGHLIGHTS | ESPN Ringside",
                    "domain": "www.youtube.com",
                    "position": 13,
                    "sitelinks": [],
                    "description": "Nov 15, 2024  \u00b7  Watch the highlights of Jake Paul's unanimous decision victory over Mike Tyson at AT&T Stadium in Arlington, Texas. Paul vs."
                },
                {
                    "url": "https://miketyson.com/?srsltid=AfmBOoqL3Gwz6zcFBui-buBqDnwVawJAQKD9DDsvxhNZZlLC2g9nKrki",
                    "title": "Mike Tyson",
                    "domain": "miketyson.com",
                    "position": 14,
                    "sitelinks": [
                        {
                            "url": "https://miketyson.com/products/mike-tyson-signature-hoodie",
                            "title": "Mike Tyson Signature Hoodie"
                        },
                        {
                            "url": "https://miketyson.com/products/iron-mike-collage-tee",
                            "title": "Iron Mike Collage Tee"
                        },
                        {
                            "url": "https://miketyson.com/products/new-tyson-portrait-snow-wash",
                            "title": "Tyson Portrait - Snow Wash"
                        }
                    ],
                    "description": "The official site of Brooklyn's own, Mike Tyson (AKA Iron Mike). Shop exclusive hoodies, tees, accessories, and more.  \u00b7   \u00b7"
                },
                {
                    "url": "https://www.britannica.com/biography/Mike-Tyson",
                    "title": "Mike Tyson | Jake Paul, Age, Record, & Facts | Britannica",
                    "domain": "www.britannica.com",
                    "position": 15,
                    "sitelinks": [],
                    "description": "6 days ago  \u00b7  Mike Tyson (born June 30, 1966, Brooklyn, New York, U.S.) is an American boxer who, at age 20, became the youngest heavyweight champion in\u00a0..."
                },
                {
                    "url": "https://www.youtube.com/watch?v=8Hk_v9wouxI",
                    "title": "Mike Tyson's Deadliest Combos (Breakdown) - YouTube",
                    "domain": "www.youtube.com",
                    "position": 16,
                    "sitelinks": [],
                    "description": "20 hours ago  \u00b7  Learn How Mike Tyson knockouts people out with his combos. Master Effortless Boxing Footwork Step-by-Step:\u00a0..."
                },
                {
                    "url": "https://www.youtube.com/c/miketyson",
                    "title": "Mike Tyson - YouTube",
                    "domain": "www.youtube.com",
                    "position": 17,
                    "sitelinks": [],
                    "description": "Share your videos with friends, family, and the world."
                },
                {
                    "url": "https://boxrec.com/boxer/000474",
                    "title": "Mike Tyson - BoxRec",
                    "domain": "boxrec.com",
                    "position": 18,
                    "sitelinks": [],
                    "description": "Mike Tyson ; career, 1985-2024 ; debut, 1985-03-06 ; ID#, 000474 ; birth name, Michael Gerard Tyson ; sex, male."
                },
                {
                    "url": "https://hive.blog/hive-101690/@ablaze/the-life-and-times-of-iron-mike-tyson",
                    "title": "The life and times of Iron Mike Tyson - Hive",
                    "domain": "hive.blog",
                    "position": 19,
                    "sitelinks": [],
                    "description": "Mike Tyson was one of the best boxers of all time. From the early days, you could see that Mike had something extra which separated him from the rest."
                }
            ],
            "twitter_card": null,
            "total_results": 19,
            "knowledge_graph": {
                "type": "American former professional boxer \u00b7",
                "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSvKE6za_jmmdMsMnoAwRk_AqZG3NgvccbD0A4e6YNv7-GnX5Utm3Xcxg&s=0",
                "title": "Mike Tyson",
                "website": "miketyson.com",
                "attributes": {
                    "Born": "June 30, 1966 (age 58\u00a0years),   Fort Greene, New York, NY",
                    "Coach": "Kevin Rooney   (1985\u20131988)  ,   Freddie Roach   (2003\u20132004)  ,   Jeff Fenech   (2005-)  , and   more",
                    "Height": "5\u2032 10\u2033",
                    "Spouse": "Lakiha Spicer   (m. 2009)  ,   Monica Turner   (m. 1997\u20132003)  , and   Robin Givens   (m. 1988\u20131989)",
                    "Weight": "220\u00a0lbs",
                    "Children": "Miguel Leon Tyson  ,   Exodus Tyson  ,   Amir Tyson  , and   more",
                    "Division": "Heavyweight"
                },
                "source_url": "/url?q=https://en.wikipedia.org/wiki/Mike_Tyson&sa=U&ved=2ahUKEwisgeyv0teNAxViQ_EDHZ2PAUsQmhN6BAgWEAg&usg=AOvVaw3FGHLhnyJj870e6DYTqF3f",
                "description": "Michael Gerard Tyson is an American former professional boxer who competed between 1985 and 2024. Nicknamed \"Iron Mike\" and \"Kid Dynamite\" in his early career, and later known as \"the Baddest Man on the Planet\", Tyson is regarded as one of the...",
                "source_name": "Wikipedia"
            },
            "people_also_ask": [],
            "see_results_about": {
                "link": "/search?num=20&lr=lang_en&sca_esv=41514daaec8f90aa&complete=0&nfpr=1&pws=0&gbv=1&ie=UTF-8&tbs=lr:lang_1en&q=is+mike+tyson+still+alive&sa=X&ved=2ahUKEwisgeyv0teNAxViQ_EDHZ2PAUsQ1QJ6BAgFEAE",
                "title": null,
                "description": null,
                "search_term": "is mike tyson still alive"
            },
            "people_also_search_for": [
                "is mike tyson still alive",
                "mike tyson net worth",
                "mike tyson children",
                "mike tyson movie",
                "mike tyson stats",
                "mike tyson daughter",
                "mike tyson height",
                "mike tyson record"
            ]
        }
    }
]

Try It Live

Test this endpoint in our interactive playground with real data.

Open in Playground