Aerys Public API Free

REST API access to the search engine. No registration or API key required.

Overview

Base URL: https://aerys.site/api.php
Method: GET  |  Format: JSON  |  Encoding: UTF-8

Endpoints

GET api.php Web Search
ParameterDescriptionDefault
q Required Search query —
page Optional Page number 1
lang Optional Language filter (tr, en, de…) —
format Optional pretty = formatted JSON output —
Example Request
GET api.php?q=artificial+intelligence&page=1&lang=en
Example Response
{ "query": "artificial intelligence", "type": "web", "page": 1, "data": { "results": [ { "url": "https://example.com/article", "title": "What is Artificial Intelligence?", "description": "AI explained in detail...", "domain": "example.com", "language": "en", "favicon": "https://..." } ], "total": 42, "page": 1, "total_pages": 5, "has_more": true, "time_ms": 18.4 }, "powered_by": "Aerys", "total_time_ms": 21.2 }
Try it live
GET api.php?type=images Image Search
ParameterDescription
qRequiredSearch query
typeRequiredMust be images
pageOptionalPage number
GET api.php?q=mountains&type=images
Try it live
GET api.php?ai=1 AI-Powered Search
ParameterDescription
qRequiredSearch query
aiRequiredSet to 1
langOptionalResponse language (en, tr, de…)
Response — includes extra ai field
{ ... "ai": { "answer": "Artificial intelligence refers to...", "sources": [ { "title": "Article Title", "domain": "example.com", "url": "https://..." } ], "time_ms": 1240 } }
AI responses depend on the server's API key configuration. Without a key, the answer field returns an index-based summary.
Try it live

Error Responses

// 400 — Missing q parameter { "error": "q parameter required", "usage": { "search": "api.php?q=query", "images": "api.php?q=query&type=images", "ai": "api.php?q=query&ai=1", "page": "api.php?q=query&page=2" } }

Code Examples

JavaScript (fetch)
const res = await fetch('api.php?q=technology&lang=en'); const data = await res.json(); console.log(data.data.results);
Python (requests)
import requests r = requests.get('api.php', params={'q': 'technology', 'lang': 'en'}) results = r.json()['data']['results']
cURL
curl "api.php?q=technology&format=pretty"

Notes

• Free to use, no rate limit for reasonable usage.
• All responses are UTF-8 encoded JSON.
• CORS headers included — use directly from browser.
• Results come from Aerys's own index.