Only API key authentication is supported.

Quick Start

Using the Script

./scripts/search.sh '<json>'

Examples:

# Basic search
./scripts/search.sh '{"query": "python async patterns"}'

# With options
./scripts/search.sh '{"query": "React hooks tutorial", "max_results": 10}'

# Advanced search with filters
./scripts/search.sh '{"query": "AI news", "time_range": "week", "max_results": 10}'

# Domain-filtered search
./scripts/search.sh '{"query": "machine learning", "include_domains": ["arxiv.org", "github.com"], "search_depth": "advanced"}'

Basic Search

curl --request POST \
  --url https://api.inspiro.top/search \
  --header "Authorization: Bearer $INSPIRO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "latest developments in quantum computing",
    "max_results": 5
  }'

Advanced Search

curl --request POST \
  --url https://api.inspiro.top/search \
  --header "Authorization: Bearer $INSPIRO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "machine learning best practices",
    "max_results": 10,
    "search_depth": "advanced",
    "include_domains": ["arxiv.org", "github.com"]
  }'

API Reference

Endpoint

POST https://api.inspiro.top/search

Headers

Header	Value
`Authorization`	`Bearer <INSPIRO_API_KEY>`
`Content-Type`	`application/json`

Request Body

Field	Type	Default	Description
`query`	string	Required	Search query (keep under 400 chars)
`max_results`	integer	10	Maximum results (0-20)
`search_depth`	string	`"basic"`	`ultra-fast`, `fast`, `basic`, `advanced`
`topic`	string	`"general"`	Search topic (general only)
`time_range`	string	null	`day`, `week`, `month`, `year`
`start_date`	string	null	Return results after this date (`YYYY-MM-DD`)
`end_date`	string	null	Return results before this date (`YYYY-MM-DD`)
`include_domains`	array	[]	Domains to include (max 300)
`exclude_domains`	array	[]	Domains to exclude (max 150)
`country`	string	null	Boost results from a specific country (general topic only)
`include_raw_content`	boolean	false	Include full page content
`include_images`	boolean	false	Include image results
`include_image_descriptions`	boolean	false	Include descriptions for images
`include_favicon`	boolean	false	Include favicon URL for each result

Response Format

{
  "query": "latest developments in quantum computing",
  "results": [
    {
      "title": "Page Title",
      "url": "https://example.com/page",
      "content": "Extracted text snippet...",
      "score": 0.85
    }
  ],
  "response_time": 1.2
}

Search Depth

Depth	Latency	Relevance	Content Type
`ultra-fast`	Lowest	Lower	NLP summary
`fast`	Low	Good	Chunks
`basic`	Medium	High	NLP summary
`advanced`	Higher	Highest	Chunks

When to use each:

ultra-fast: Real-time chat, autocomplete
fast: Need chunks but latency matters
basic: General-purpose, balanced
advanced: Precision matters (default recommendation)

Examples

Domain-Filtered Search

curl --request POST \
  --url https://api.inspiro.top/search \
  --header "Authorization: Bearer $INSPIRO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "Python async best practices",
    "include_domains": ["docs.python.org", "realpython.com", "github.com"],
    "search_depth": "advanced"
  }'

Search with Full Content

curl --request POST \
  --url https://api.inspiro.top/search \
  --header "Authorization: Bearer $INSPIRO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "React hooks tutorial",
    "max_results": 3,
    "include_raw_content": true
  }'

Tips

Keep queries under 400 characters - Think search query, not prompt
Break complex queries into sub-queries - Better results than one massive query
Use include_domains to focus on trusted sources
Use time_range for recent information
Filter by score (0-1) to get highest relevance results

search

Search Skill

Authentication

More from ryneivy/skills

research

extract

inspiro-best-practices

crawl