Documentation
UWS Search API Manual
Learn how to integrate UWS Search API into your applications. Fast, affordable, and AI-friendly Web Search API.
Authentication
To authenticate your API requests, you must include your API key in the HTTP headers. You can find or generate your API key in the API Keys menu.
| Header Name | Description |
|---|---|
X-API-KEY | Your unique secret API key. |
Rate Limits
The current API rate limit is set to 60 requests per minute per IP address. Exceeding this limit will result in a 429 Too Many Requests response.
Search Endpoint
Perform real-time web searches. We fully support both standard GET and POST (JSON Body) requests.
GET /api/search
POST /api/search
POST /api/search
Parameters (Query or JSON Body)
| Parameter | Type | Required | Description |
|---|---|---|---|
q | String | Yes | The search query string (e.g., "artificial intelligence"). |
type | String | No | Type of search. Options: search, images, news, maps, places, videos. (Default: search) |
gl | String | No | Geolocation (ISO 3166-1 alpha-2). Supports all Google regions (e.g., us, kr, gb, jp, de, fr, ca, au, cn, es, etc). (Default: us) |
hl | String | No | Host language code (ISO 639-1). Supports all Google languages (e.g., en, ko, ja, de, fr, es, zh-cn, ru, etc). (Default: en) |
tbs | String | No | Time range filter. Options: qdr:h (Past hour), qdr:d (Past 24 hours), qdr:w (Past week), qdr:m (Past month), qdr:y (Past year). |
page | Integer | No | Page number for pagination. Defaults to 1. |
deepFetch | Boolean | No | If true, extracts the core text from the top 3 results (up to 1000 characters each). |
cURL Example (POST - JSON Body)
curl -X POST "https://uwssearch.com/api/search" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "apple inc", "type": "news", "gl": "us", "hl": "en"}'
Python Example (Requests)
import requests
import json
url = "https://uwssearch.com/api/search"
payload = json.dumps({
"q": "apple inc",
"type": "news",
"gl": "us",
"hl": "en"
})
headers = {
"X-API-KEY": "YOUR_API_KEY",
"Content-Type": "application/json"
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.json())
Node.js Example (Fetch)
const fetch = require('node-fetch');
const url = 'https://uwssearch.com/api/search';
const options = {
method: 'POST',
headers: {
'X-API-KEY': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ q: 'apple inc', type: 'news', gl: 'us', hl: 'en' })
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));
Response Format
Loading response format...
Loading...