360 Search API
A simple HTTP API for accessing 360 Search results.
Overview
The 360 Search API provides programmatic access to web, news, shopping, and image search results through a single HTTP endpoint.
Requests are sent using GET and responses are returned as JSON. No SDK is required.
GET
https://api.360-search.com/?q=YOUR_QUERY
Endpoint
All API requests use the same endpoint. The search type is selected with the type query parameter.
https://api.360-search.com/?q=example
https://api.360-search.com/?q=example&type=news
https://api.360-search.com/?q=laptop&type=shopping
https://api.360-search.com/?q=cats&type=image
The q parameter is required and may contain up to 500 characters.
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
| q | Yes | None | The search query. Maximum 500 characters. |
| type | No | web | Search type: web, news, shopping, or image. |
| safe | No | moderate | Safe search mode. Use moderate or off. |
| limit | No | 50 | Maximum number of results. Range: 1-100. |
| page | No | 1 | Result page. Range: 1-100. Used by web and image search. |
Search Types
| Type | Description |
|---|---|
| web | General web search results. |
| news | News and recent articles. |
| shopping | Products, prices, ratings, and shopping results. |
| image | Image search results with source URLs and dimensions. |
Responses
Successful requests return JSON containing the original query, search type, result count, and an array of results.
Web response
{
"query": "open source",
"type": "web",
"page": 1,
"result_count": 2,
"results": [
{
"type": "web",
"title": "Example Result",
"url": "https://example.com",
"description": "Example description.",
"thumbnail": "",
"favicon": "",
"source": "example.com",
"age": ""
}
]
}
Shopping response
{
"query": "laptop",
"type": "shopping",
"result_count": 1,
"results": [
{
"type": "shopping",
"title": "Example Laptop",
"url": "https://example.com/product",
"description": "Example product.",
"thumbnail": "",
"price": "$999",
"source": "example.com",
"rating": 4.5,
"reviews": 120
}
]
}
Image response
{
"query": "cats",
"type": "image",
"page": 1,
"result_count": 1,
"total_results": 1000,
"results": [
{
"type": "image",
"title": "Example image",
"url": "https://example.com",
"image": "https://example.com/image.jpg",
"width": 1200,
"height": 800
}
]
}
Examples
Web search
fetch("https://api.360-search.com/?q=open+source")
.then(response => response.json())
.then(data => console.log(data));
News search
fetch("https://api.360-search.com/?q=technology&type=news")
.then(response => response.json())
.then(data => console.log(data));
Shopping search
fetch("https://api.360-search.com/?q=laptop&type=shopping&limit=10")
.then(response => response.json())
.then(data => console.log(data));
Image search
fetch("https://api.360-search.com/?q=cats&type=image&limit=20")
.then(response => response.json())
.then(data => console.log(data));
API Tester
Try the API directly from this page.
Errors
Errors are returned as JSON with an HTTP status code.
| Status | Meaning |
|---|---|
| 400 | Missing, invalid, or excessively long query parameters. |
| 405 | The request method is not supported. |
| 500 | Server configuration error. |
| 502 | An upstream search service returned an error. |
Example error
{
"error": "Missing required parameter: q"
}