Skip to main content
Perform a web search
curl --request GET \
  --url http://api.serping.io/search \
  --header 'Authorization: Bearer <token>'
{
  "searchParameters": {
    "q": "<string>",
    "country": "us",
    "language": "en",
    "page": 1,
    "type": "<string>",
    "autocorrect": true
  },
  "organic": [
    {
      "title": "<string>",
      "link": "<string>",
      "snippet": "<string>",
      "sitelinks": [
        {
          "title": "<string>",
          "link": "<string>"
        }
      ],
      "position": 123,
      "attributes": {},
      "date": "<string>"
    }
  ],
  "knowledgeGraph": {
    "title": "<string>",
    "type": "<string>",
    "website": "<string>",
    "imageUrl": "<string>",
    "description": "<string>",
    "descriptionSource": "<string>",
    "descriptionLink": "<string>",
    "attributes": {}
  },
  "peopleAlsoAsk": [
    {
      "question": "<string>",
      "snippet": "<string>",
      "title": "<string>",
      "link": "<string>"
    }
  ],
  "relatedSearches": [
    {
      "query": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

q
string
required

Query text (required).

country
string
default:us

ISO Country code. Defaults to 'us' if not provided.

city
string

City location. Retrieve available cities from the /city_list endpoint.

language
string
default:en

Language code. Defaults to 'en' if not provided.

time_range
string

Time range filter. Allowed values: 'h' (past hour), 'd' (past day), 'w' (past week), 'm' (past month), 'y' (past year). If omitted, returns results from any time.

num
integer
default:10

Number of results to return. Allowed values: 10, 20, 30, 50, 100. Defaults to 10.

page
integer
default:1

Page number. Defaults to 1.

Response

Successful search response

searchParameters
object
required
organic
object[]
required

List of organic search results.

knowledgeGraph
object

Additional information from the knowledge graph, if available.

peopleAlsoAsk
object[]

List of related questions.

List of related search queries.