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