Introduction
Serply is extremely fast and accurate with no need for proxies and uses clean USA IPs.
The complete documentation can be found here: https://docs.serply.io/
Note: Serply supports advanced search queries for all results.
Reference this guide for formatting and see examples below.
Note: In addition, all results can also be filtered by country and language. See supported languages and locations below.
Google Search
GET
/api/v1/search/{query}
Perform Search
Perform a Google search via GET request with support for advanced queries.
Parameters
query: string
The query should be a string query to perform a search.
Returns
results: JSON
The response is a JSON array of results
, an array of answers
(people also searched for), and a total
.
{"results": [{"title", "description", "link"}] , "answers": [], "total"}
Example Google Search
Get started with some example queries.
Simple Google Search queries
Simple search for the keyword โpresident usaโ
query:
โq=president+usaโ
Simple search for the keyword โinstagramโ and limit to 100 results
query:
โq=instagram&num=100โ
Advanced Google Search queries
You can use advanced queries to limit searches by location and language.
Advanced search for the keyword โinstagramโ, limiting to 100 results, and limiting the language to German (lang_de - German).
query:
โq=instagram&num=100&lr=lang_deโ
Advanced search for the keyword โinstagramโ, limiting to 100 results, limiting by language, and limiting by location (NO - Norway).
query: โq=instagram&num=100&lr=lang_de&cr=NOโ
Google News
GET
/api/v1/news/{query}
Perform Google News Search
Perform a Google News search via GET request with support for advanced queries.
Parameters
query: string
Returns
results: JSON
The response is a JSON array of entities
, and a feed
object.
{"feed": { "title" : "trump" ...} , "entites": [ {"title" : "Trump doubles down on divisive messaging in speech to honor Independence Day - CNN", "links": []} ...]}
Example Google News queries
Simple query for the top news in the United States
query:
โq=united+statesโ
Simple for the top news for stocks in France, and in English
query:
โq=stocks&cied=FR:enโ
SERP Rankings
POST
/api/v1/serp
Body Parameters
query: string
website: string
Returns
results: JSON
The response is JSON results with keys for query
, website
, searched_results
, and position
.
Note: Position will be set to -1 if website is not found in results
{
"query": "q=google+search+api",
"website": "rapidapi.com",
"searched_results": 9,
"position": -1
}
Example SERP queries
Simple for website:
https://rapidapi.com for the query:
โgoogle search apiโ in the top 100 results.
{
"query": "q=google+search+api&num=100",
"website": "rapidapi.com"
}
Supported Languages
- lang_ar - Arabic
- lang_hy - Armenian
- lang_be - Belarusian
- lang_bg - Bulgarian
- lang_ca - Catalan
- lang_hr - Croatian
- lang_cs - Czech
- lang_da - Danish
- lang_nl - Dutch
- lang_en - English
- lang_eo - Esperanto
- lang_et - Estonian
- lang_tl - Filipino
- lang_fi - Finnish
- lang_fr - French
- lang_de - German
- lang_el - Greek
- lang_iw - Hebrew
- lang_hu - Hungarian
- lang_is - Icelandic
- lang_id - Indonesian
- lang_it - Italian
- lang_ja - Japanese
- lang_ko - Korean
- lang_lv - Latvian
- lang_lt - Lithuanian
- lang_no - Norwegian
- lang_fa - Persian
- lang_pl - Polish
- lang_pt - Portuguese
- lang_ro - Romanian
- lang_ru - Russian
- lang_sr - Serbian
- lang_sk - Slovak
- lang_sl - Slovenian
- lang_es - Spanish
- lang_sv - Swedish
- lang_th - Thai
- lang_tr - Turkish
- lang_uk - Ukrainian
- lang_vi - Vietnamese
- lang_zh-CN - Chinese Simplified
- lang_zh-TW - Chinese Traditional
Supported Countries
- AF - Afghanistan
- AL - Albania
- DZ - Algeria
- AS - American Samoa
- AD - Andorra
- AO - Angola
- AI - Anguilla
- AQ - Antarctica
- AG - Antigua and Barbuda
- AR - Argentina
- AM - Armenia
- AW - Aruba
- AU - Australia
- AT - Austria
- AZ - Azerbaijan
- BS - Bahamas
- BH - Bahrain
- BD - Bangladesh
- BB - Barbados
- BY - Belarus
- BE - Belgium
- BZ - Belize
- BJ - Benin
- BM - Bermuda
- BT - Bhutan
- BO - Bolivia
- BA - Bosnia and Herzegovina
- BW - Botswana
- BV - Bouvet Island
- BR - Brazil
- IO - British Indian Ocean Territory
- BN - Brunei Darussalam
- BG - Bulgaria
- BF - Burkina Faso
- BI - Burundi
- KH - Cambodia
- CM - Cameroon
- CA - Canada
- CV - Cape Verde
- KY - Cayman Islands
- CF - Central African Republic
- TD - Chad
- CL - Chile
- CN - China
- CX - Christmas Island
- CC - Cocos (Keeling) Islands
- CO - Colombia
- KM - Comoros
- CG - Congo
- CD - Congo, Democratic Republic
- CK - Cook Islands
- CR - Costa Rica
- CI - Cote dโIvoire
- HR - Croatia
- CY - Cyprus
- CZ - Czech Republic
- DK - Denmark
- DJ - Djibouti
- DM - Dominica
- DO - Dominican Republic
- TL - East Timor
- EC - Ecuador
- EG - Egypt
- SV - El Salvador
- GQ - Equatorial Guinea
- ER - Eritrea
- EE - Estonia
- ET - Ethiopia
- FK - Falkland Islands (Malvinas)
- FO - Faroe Islands
- FJ - Fiji
- FI - Finland
- FR - France
- GF - French Guiana
- PF - French Polynesia
- TF - French Southern Territories
- GA - Gabon
- GM - Gambia
- GE - Georgia
- DE - Germany
- GH - Ghana
- GI - Gibraltar
- GR - Greece
- GL - Greenland
- GD - Grenada
- GP - Guadeloupe
- GU - Guam
- GT - Guatemala
- GN - Guinea
- GW - Guinea-Bissau
- GY - Guyana
- HT - Haiti
- HM - Heard and McDonald Islands
- HN - Honduras
- HK - Hong Kong
- HU - Hungary
- IS - Iceland
- IN - India
- ID - Indonesia
- IQ - Iraq
- IE - Ireland
- IL - Israel
- IT - Italy
- JM - Jamaica
- JP - Japan
- JO - Jordan
- KZ - Kazakhstan
- KE - Kenya
- KI - Kiribati
- KW - Kuwait
- KG - Kyrgyzstan
- LA - Lao Peopleโs Democratic Republic
- LV - Latvia
- LB - Lebanon
- LS - Lesotho
- LR - Liberia
- LY - Libya
- LI - Liechtenstein
- LT - Lithuania
- LU - Luxembourg
- MO - Macau
- MK - Macedonia
- MG - Madagascar
- MW - Malawi
- MY - Malaysia
- MV - Maldives
- ML - Mali
- MT - Malta
- MH - Marshall Islands
- MQ - Martinique
- MR - Mauritania
- MU - Mauritius
- YT - Mayotte
- MX - Mexico
- FM - Micronesia
- MD - Moldova
- MC - Monaco
- MN - Mongolia
- MS - Montserrat
- MA - Morocco
- MZ - Mozambique
- NA - Namibia
- NR - Nauru
- NP - Nepal
- NL - Netherlands
- AN - Netherlands Antilles
- NC - New Caledonia
- NZ - New Zealand
- NI - Nicaragua
- NE - Niger
- NG - Nigeria
- NU - Niue
- NF - Norfolk Island
- MP - Northern Maria
- a Islands
- NO - Norway
- OM - Oman
- PK - Pakistan
- PW - Palau
- PS - Palestinian Territory
- PA - Panama
- PG - Papua New Guinea
- PY - Paraguay
- PE - Peru
- PH - Philippines
- PN - Pitcairn
- PL - Poland
- PT - Portugal
- PR - Puerto Rico
- QA - Qatar
- RE - Reunion
- RO - Romania
- RU - Russian Federation
- RW - Rwanda
- KN - Saint Kitts and Nevis
- LC - Saint Lucia
- VC - Saint Vincent and the Grenadines
- WS - Samoa
- SM - San Marino
- ST - Sao Tome and Principe
- SA - Saudi Arabia
- SN - Senegal
- CS - Serbia and Montenegro
- SC - Seychelles
- SL - Sierra Leone
- SG - Singapore
- SK - Slovakia
- SI - Slovenia
- SB - Solomon Islands
- SO - Somalia
- ZA - South Africa
- GS - South Georgia and The South Sandwich Islands
- KR - South Korea
- ES - Spain
- LK - Sri Lanka
- SH - St. Helena
- PM - St. Pierre and Miquelon
- SR - Suriname
- SJ - Svalbard and Jan Mayen Islands
- SZ - Swaziland
- SE - Sweden
- CH - Switzerland
- TW - Taiwan
- TJ - Tajikistan
- TZ - Tanzania
- TH - Thailand
- TG - Togo
- TK - Tokelau
- TO - Tonga
- TT - Trinidad and Tobago
- TN - Tunisia
- TR - Turkey
- TM - Turkmenistan
- TC - Turks and Caicos Islands
- TV - Tuvalu
- UG - Uganda
- UA - Ukraine
- AE - United Arab Emirates
- GB - United Kingdom
- US - United States
- UM - United States Minor Outlying Islands
- UY - Uruguay
- UZ - Uzbekistan
- VU - Vanuatu
- VA - Vatican
- VE - Venezuela
- VN - Viet Nam
- VG - Virgin Islands (British)
- VI - Virgin Islands (U.S.)
- WF - Wallis and Futuna Islands
- EH - Western Sahara
- YE - Yemen
- ZM - Zambia
- ZW - Zimbabwe
Device Type
The API supports changing device type between mobile and desktop search results. The default results are desktop. To change device type simply set the X-User-Agent
header to mobile
.
Proxy Location
The API routes query through multiple servers around the world. If you would like the request to go through a specific country you can set the location using the X-Proxy-Location
header to the country alpha abbreviation. The API supports the following countries:
- US
- CA
- IE
- GB
- FR
- DE
- SE
- IN
- JP
- KR
- SG
- AU
- BR