Overview

Welcome to the Serpq API documentation. Our API provides a powerful, high-performance interface to access real-time search engine results. It's designed for developers who need fast, reliable, and structured data from Google Search for their applications, whether for SEO analytics, AI chatbots, or market research.

Authentication

To use the Serpq API, you need an API key. You can authenticate your requests by including your key in one of two ways:

1. X-API-KEY Header

The recommended method is to pass your API key in the X-API-KEY HTTP header.

curl --request GET \ 
  --url 'https://api.serpq.com/search?query=pizza' \ 
  --header 'X-API-KEY: YOUR_API_KEY'

2. Query Parameter

Alternatively, you can pass the API key as a query parameter named key.

curl --request GET \ 
  --url 'https://api.serpq.com/search?query=pizza&key=YOUR_API_KEY'

GEThttps://api.serpq.com

Search API Reference

The Search API allows you to retrieve real-time search engine result pages (SERP) from global Google nodes. Query parameters allow you to refine location, language, and search tools.

Query Parameters

Parameter	Type	Description
queryRequired	string	The search string you want to query. URL-encoded.
gl	string	The country code (e.g., 'us', 'uk'). Defaults to 'us'.
hl	string	The language code (e.g., 'en', 'es'). Defaults to 'en'.
page	integer	The result page number. Typically 1-10.
tbs	string	Time frame parameter (e.g., 'qdr:h' for past hour).
udm	string	Search type filter (e.g., '1' for Places, '2' for Images).

Dynamic Options

tbs Options (Time)

qdr:hPast Hour

qdr:dPast 24 Hours

qdr:wPast Week

qdr:mPast Month

udm Options (Type)

1Places / Maps

2Images

3Videos

14News

Localization Reference

Countries (gl)

Afghanistan	af
United States	us
United Kingdom	uk
Germany	de

Languages (hl)

English	en
Arabic	ar
French	fr
Japanese	ja

{ "searchParameters": { "q": "United State", "gl": "us", "hl": "en", "udm": 0, "page": 1, "tbs": [ "qdr:h", "..." ] }, "knowledgeGraph": { "title": "United States", "type": "Country in North America", "attributes": { "Capital": "Washington, D.C.", "President": "Donald Trump", "Population": "340.1 million (2024)", "Dialing code": "+1" } }, "organic": [ { "title": "United States", "link": "https://en.wikipedia.org/wiki/United_States", "snippet": "The United States of America (USA), also known as the United States (U.S.) It is a federal republic of 50 states and a federal capital district, Washington, D. ...", "position": 1 }, "..." ], "images": [ { "tbnid": "UDM5y1Fob95WTM", "title": "U.S. state - Wikipedia", "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ_-eBVDbfHoKW-T-v3Xw92xU2oTm0QUYpc_A&s", "original": "https://upload.wikimedia.org/wikipedia/commons/thumb/9/92/Map_of_USA_with_state_names_2.svg/1280px-Map_of_USA_with_state_names_2.svg.png", "dimensions": "1280x791" }, "..." ], "places": [], "videos": [], "weather": {}, "topStories": [], "peopleAlsoAsk": [ { "question": "What is the name of the 50 states?" }, "..." ], "relatedSearches": [] }