API Direct

Web Search

GET /v1/web/search

Real-time Google organic search results. Returns title, URL, snippet, source and domain for each result, with country/language targeting, time filters, city-level geo, and an optional Google AI Overview.

Cost

$0.004 per page

Free tier

50 requests/month

Parameters

query *

Search keyword (max 500 characters). Supports Google operators (site:, inurl:, intitle:, etc.)

pages

Number of result pages, 1-10 (default: 1). 10 results per page

country

2-letter ISO country code (default: us)

language

2-letter ISO language code (default: en)

time

Time filter: any, hour, day, week, month, year (default: any)

location

City-level geo (e.g. London,England,United Kingdom)

device

desktop or mobile (default: desktop)

include_ai_overview

Set to true to include Google AI Overview when available (+$0.002 flat per request)

Example Request

curl "https://apidirect.io/v1/web/search?query=how%20to%20build%20a%20website&pages=2&country=us&language=en" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/web/search",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "how to build a website",
        "pages": 2,
        "country": "us",
        "language": "en",
        "include_ai_overview": "true"
    }
)
print(response.json())

Example Response

{
  "results": [
    {
      "position": 1,
      "rank": 1,
      "title": "Website Builder - Create a Free Website",
      "url": "https://www.canva.com/website-builder/",
      "snippet": "Design and launch a professional, one-of-a-kind website in minutes...",
      "source": "Canva",
      "domain": "canva.com",
      "displayed_link": "https://www.canva.com › website-builder"
    }
  ],
  "pages": 2,
  "count": 20,
  "ai_overview": {
    "text_parts": [
      {"type": "paragraph", "text": "Building a website involves choosing a platform, designing pages, and publishing..."}
    ],
    "reference_links": [
      {"title": "How to Create a Website From Scratch", "link": "https://www.wix.com/blog/how-to-build-website-from-scratch-guide", "source": "Wix"}
    ]
  }
}

Your Usage

Free tier this month

Recent Activity