🚀 Quick Start
Base URL
https://search.osaystudio.com
Authentication
Contact @famousvolume on Telegram to get your API key, then use it in the X-API-Key header:
curl -H "X-API-Key: your_api_key_here" ...
Rate Limits
- With API Key: Based on your plan (default: 100/day)
- Without API Key: 3 requests per day per IP address
Contact: @famousvolume on Telegram for API key access
Search Types
- Web Search: Get web search results with caching
- Image Search: Find high-quality images with metadata
- AI Assistant: Get AI-powered responses and analysis
API Key Benefits
- Higher Limits: 100+ requests/day vs 3/day
- Result Caching: 24-hour cache per user per query
- Usage Tracking: Detailed statistics and monitoring
- Priority Support: Faster response times
📚 API Reference
Search Endpoint
POST
/api/search
Headers
Content-Type: application/json
X-API-Key: your_api_key_here (optional but recommended)
Request Body
{
"query": "python tutorial",
"search_type": "web",
"honeypot": ""
}
Parameters
- query (required): Search query string
- search_type (optional): "web", "image", or "ai"
- honeypot (required): Must be empty string
Response (Web Search)
{
"items": [
{
"title": "Python Tutorial",
"link": "https://example.com",
"snippet": "Learn Python programming..."
}
]
}
Response (Image Search)
{
"items": [
{
"title": "Python Logo",
"link": "https://example.com/page",
"image": "https://example.com/image.jpg",
"thumbnail": "https://example.com/thumb.jpg",
"width": 1920,
"height": 1080
}
]
}
Get Usage Stats
GET
/api/usage/stats
Headers
X-API-Key: your_api_key_here
Response
{
"email": "user@example.com",
"calls_today": 2,
"calls_total": 150,
"last_call": "2024-01-15T10:30:00",
"daily_limit": 100,
"remaining_today": 98
}
💡 Examples
Web Search (with API key)
curl -X POST https://search.osaystudio.com/api/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{"query":"python tutorial","search_type":"web","honeypot":""}'
Image Search (without API key)
curl -X POST https://search.osaystudio.com/api/search \
-H "Content-Type: application/json" \
-d '{"query":"cats","search_type":"image","honeypot":""}'
Usage Statistics
curl -H "X-API-Key: your_api_key_here" \
"https://search.osaystudio.com/api/usage/stats"
Python Example
import requests
# Contact @famousvolume on Telegram to get your API key
api_key = "your_api_key_here"
# Search with API key
response = requests.post('https://search.osaystudio.com/api/search',
headers={'X-API-Key': api_key},
json={
'query': 'python tutorial',
'search_type': 'web',
'honeypot': ''
})
results = response.json()
for item in results['items']:
print(f"Title: {item['title']}")
print(f"URL: {item['link']}")
print("---")