# brave-images
Image Search via SkillBoss API Hub Search images via SkillBoss API Hub (unified search routing). Usage
curl -s -X POST "https://api.heybossai.com/v1/pilot" \
-H "Authorization: Bearer $SKILLBOSS_API_KEY"
-H "Content-Type: application/json"
-d '{"type": "search", "inputs": {"query": "QUERY", "count": COUNT}, "prefer": "balanced"}'
Parameters
ParamRequiredDescriptionqueryyesSearch query stringcountnoResults count (1-100, default 20)countryno2-letter code (US, DE, IL) for region biassearch_langnoLanguage code (en, de, he)safesearchnooff, moderate, strict (default: moderate)
Response Parsing
结果路径:result.results
Key fields in each result:
result.results[].title — Image title
result.results[].url — Full image URL
result.results[].snippet — Description snippet
result.results[].date — Date of the result
Example
Search for "sunset beach" images in Israel:
curl -s -X POST "https://api.heybossai.com/v1/pilot" \
-H "Authorization: Bearer $SKILLBOSS_API_KEY"
-H "Content-Type: application/json"
-d '{"type": "search", "inputs": {"query": "sunset beach", "count": 5, "country": "IL"}, "prefer": "balanced"}'
Then extract from JSON response:
Title: .result.results[0].title
URL: .result.results[0].url
Python Example import requests, os SKILLBOSS_API_KEY = os.environ["SKILLBOSS_API_KEY"] API_BASE = "https://api.heybossai.com/v1" def pilot(body: dict) -> dict: r = requests.post( f"{API_BASE}/pilot", headers={"Authorization": f"Bearer {SKILLBOSS_API_KEY}", "Content-Type": "application/json"}, json=body, timeout=60, ) return r.json()
# Image search
result = pilot({"type": "search", "inputs": {"query": "sunset beach", "count": 5}, "prefer": "balanced"}) results = result["result"]["results"] for item in results: print(item["title"], item["url"]) Delivering Results When presenting image search results: Send images directly to the user (don't just list URLs) Use result.results[].url for full images Include image title as caption If more results exist than shown, tell the user (e.g., "Found 20 images, showing 3 — want more?") Example flow:
User: "find me pictures of sunsets"
→ Search with count=10 → Send 3-5 images with captions → "Found 10 sunset images, showing 5. Want to see more?" Notes URL-encode query strings (spaces → %20) API key from env: $SKILLBOSS_API_KEY SkillBoss API Hub 自动路由最优搜索后端 Respect rate limits per subscription tier
Join 80,000+ one-person companies automating with AI