Google Scraping

Google Scraping Response

POST /v1/google-search returns an array of parsed organic results under response.

#Request Example

curl -X POST /v1/google-search \
  -H "Authorization: Bearer your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best scraping api",
    "country": "us",
    "page": 1
  }'

#Request Body

{
  "query": "best scraping api",
  "country": "us",
  "page": 1
}

#Example Response

{
  "response": [
    {
      "title": "Example result",
      "description": "Snippet text",
      "meta_data": "3 days ago",
      "url": "https://example.com/article"
    }
  ]
}

#Returned Fields

  • title: parsed result heading
  • description: parsed result snippet
  • meta_data: metadata line, often date or source details
  • url: cleaned destination URL

#Parsing Notes

  • the endpoint removes a duplicated first result when the first two parsed URLs are identical
  • if parsing fails or no data can be extracted, the API returns message: No results found!