Google Web Search
Run a real-time Google search and return organic results with position, rank, title, URL, snippet, source, domain, and displayed link. Supports Google advanced operators (site:, inurl:, intitle:). Fetch 1-10 pages of results in a single call: each page is 10 results and every page is merged into one results array. Supports country, language, time window, city-level location, and device targeting. Set include_ai_overview=true to include Google's AI Overview when one is available for the query.
Price: $0.004 per page (+$0.002 flat per request when include_ai_overview=true). Free tier: 50 requests/month.
Request
- Base URL: https://apidirect.io
- URL: https://apidirect.io/v1/web/search
- Auth: API key in header X-API-Key
Query parameters
Search keyword (max 500 characters, measured after leading and trailing whitespace is trimmed). Supports Google advanced operators (site:, inurl:, intitle:, etc.)
Number of result pages to fetch and merge (10 results per page). This is a count, not a page number: pages=3 returns the first 30 results in a single results array. Values above 10 are rejected with 400; values below 1 are treated as 1. Each page is billed as one request.
2-letter ISO 3166-1 alpha-2 country code. A value that is not exactly 2 letters is rejected with 400.
2-letter ISO 639-1 language code. A value that is not exactly 2 letters is rejected with 400.
Time filter for results
City-level geo location (e.g. London,England,United Kingdom)
Device type to simulate
When true, include Google's AI Overview for the query. Only the exact value true (case-insensitive) enables it. When enabled, the response always contains an ai_overview field, which is null if Google generated no overview for the query.
Response
Successful response
Changes
No recorded changes to this operation across all 1 revision of this API.