Search - ProxyScrape Docs

GET

cURL

curl "https://serp.api.proxyscrape.com/?q=proxyscrape&gl=us&hl=en&start=0&rawhtml=0" \
  -u "<sub-user-username>:<sub-user-password>"

#!/usr/bin/env python3
import requests

username = "<sub-user-username>"
password = "<sub-user-password>"
host = "https://serp.api.proxyscrape.com"

url = host + "?q=proxyscrape&gl=us&hl=en&start=0&rawhtml=0"
headers = {"User-Agent": "curl/8.7.1"}

r = requests.get(url, auth=(username, password), headers=headers)
print(r.text)

const axios = require('axios');

const username = '<sub-user-username>';
const password = '<sub-user-password>';
const host = 'https://serp.api.proxyscrape.com';

const url = host + '?q=proxyscrape&gl=us&hl=en&start=0&rawhtml=0';

axios
  .get(url, { auth: { username, password } })
  .then((res) => console.log(res.data.results[0]))
  .catch((err) => console.error(err));

{
  "query": "proxyscrape",
  "url": "https://www.google.com/search?q=proxyscrape&num=10&start=0&hl=en",
  "results": [
    {
      "Organic": [
        {
          "title": "ProxyScrape - Free Proxy List & Premium Proxies",
          "url": "https://proxyscrape.com/",
          "description": "ProxyScrape provides free proxy lists and premium proxy services...",
          "moreinfo": "",
          "rank": 0
        }
      ],
      "PeopleAlsoSearchFor": [
        {
          "title": "proxyscrape free proxy",
          "url": "https://www.google.com/search?q=proxyscrape+free+proxy",
          "description": "",
          "moreinfo": "",
          "rank": 0
        }
      ],
      "Places": [
        {
          "title": "Example Proxy Co.",
          "url": "",
          "description": "5.0(12) · Software company",
          "moreinfo": "",
          "rank": 0
        }
      ]
    }
  ]
}

{
  "Error": {
    "Status": "INVALID_REQUEST",
    "Message": "The search request parameter is incorrect",
    "Code": 400
  }
}

{
  "Error": {
    "Status": "Unauthorized",
    "Message": "user/credit validation failure",
    "Code": 401
  }
}

{
  "Error": {
    "Status": "INSUFFICIENT_CREDIT",
    "Message": "This request can cost up to 3 units; 1 are available",
    "Code": 402
  }
}

{
  "Error": {
    "Status": "Too Many Requests",
    "Message": "Rate limit exceeded",
    "Code": 429
  }
}

{
  "Error": {
    "Status": "FAILURE",
    "Message": "BLOCKED: Google refused the search (retries exhausted)",
    "Code": 500
  }
}

{
  "Error": {
    "Status": "FAILURE",
    "Message": "UPSTREAM: Google returned an unexpected HTTP status (retries exhausted)",
    "Code": 502
  }
}

{
  "Error": {
    "Status": "FAILURE",
    "Message": "Failed to perform search, try again",
    "Code": 503
  }
}

{
  "Error": {
    "Status": "FAILURE",
    "Message": "TIMEOUT: Google did not respond in time (retries exhausted)",
    "Code": 504
  }
}

Authorizations

Authorization

string

header

required

HTTP Basic Auth using a SERP API sub-user's username and password.

Query Parameters

string

required

The search query. URL-encode it.

string

default:us

Two-letter country code for the search location (Google gl), e.g. us, de, fr.

string

default:en

Two-letter interface language code (Google hl), e.g. en, es.

start

integer

default:0

Result offset for pagination. 0 is the first page, 10 the second, and so on.

Required range: x >= 0

rawhtml

enum<integer>

default:0

Set to 1 to also return the raw HTML of every Google page the answer was read from, in pages. 0 omits it.

Available options:

0,

1

Response

An answer: parsed search results, organic results under results[0].Organic. A search Google finds nothing for is also an answer (HTTP 200) with an empty results[0].Organic, and is not billed.

query

string

The query that was executed.

url

string

The Google search URL the request resolved to.

pages

object[]

Only with rawhtml=1: every Google page the answer was read from, in the order they were read (the first is the results page at url). When the answer would exceed the size limit, the last pages keep their kind and url with html: null and truncated: true.

Show child attributes

results

object[]

Single-element array holding the parsed result groups.

Show child attributes

cURL

curl "https://serp.api.proxyscrape.com/?q=proxyscrape&gl=us&hl=en&start=0&rawhtml=0" \
  -u "<sub-user-username>:<sub-user-password>"

#!/usr/bin/env python3
import requests

username = "<sub-user-username>"
password = "<sub-user-password>"
host = "https://serp.api.proxyscrape.com"

url = host + "?q=proxyscrape&gl=us&hl=en&start=0&rawhtml=0"
headers = {"User-Agent": "curl/8.7.1"}

r = requests.get(url, auth=(username, password), headers=headers)
print(r.text)

const axios = require('axios');

const username = '<sub-user-username>';
const password = '<sub-user-password>';
const host = 'https://serp.api.proxyscrape.com';

const url = host + '?q=proxyscrape&gl=us&hl=en&start=0&rawhtml=0';

axios
  .get(url, { auth: { username, password } })
  .then((res) => console.log(res.data.results[0]))
  .catch((err) => console.error(err));

{
  "query": "proxyscrape",
  "url": "https://www.google.com/search?q=proxyscrape&num=10&start=0&hl=en",
  "results": [
    {
      "Organic": [
        {
          "title": "ProxyScrape - Free Proxy List & Premium Proxies",
          "url": "https://proxyscrape.com/",
          "description": "ProxyScrape provides free proxy lists and premium proxy services...",
          "moreinfo": "",
          "rank": 0
        }
      ],
      "PeopleAlsoSearchFor": [
        {
          "title": "proxyscrape free proxy",
          "url": "https://www.google.com/search?q=proxyscrape+free+proxy",
          "description": "",
          "moreinfo": "",
          "rank": 0
        }
      ],
      "Places": [
        {
          "title": "Example Proxy Co.",
          "url": "",
          "description": "5.0(12) · Software company",
          "moreinfo": "",
          "rank": 0
        }
      ]
    }
  ]
}

{
  "Error": {
    "Status": "INVALID_REQUEST",
    "Message": "The search request parameter is incorrect",
    "Code": 400
  }
}

{
  "Error": {
    "Status": "Unauthorized",
    "Message": "user/credit validation failure",
    "Code": 401
  }
}

{
  "Error": {
    "Status": "INSUFFICIENT_CREDIT",
    "Message": "This request can cost up to 3 units; 1 are available",
    "Code": 402
  }
}

{
  "Error": {
    "Status": "Too Many Requests",
    "Message": "Rate limit exceeded",
    "Code": 429
  }
}

{
  "Error": {
    "Status": "FAILURE",
    "Message": "BLOCKED: Google refused the search (retries exhausted)",
    "Code": 500
  }
}

{
  "Error": {
    "Status": "FAILURE",
    "Message": "UPSTREAM: Google returned an unexpected HTTP status (retries exhausted)",
    "Code": 502
  }
}

{
  "Error": {
    "Status": "FAILURE",
    "Message": "Failed to perform search, try again",
    "Code": 503
  }
}

{
  "Error": {
    "Status": "FAILURE",
    "Message": "TIMEOUT: Google did not respond in time (retries exhausted)",
    "Code": 504
  }
}