Search

Submit a search query and get back ranked results with cleaned snippets. Optionally fetch the top N results and return full markdown alongside the list — one call instead of search + fan-out scrape.

Endpoint

POST https://api.ilmenite.dev/v1/search

Request body

• query (string, required) — search terms.
• limit (number, optional) — result count. Default 10, max 50.
• region (string, optional) — 2-letter country code. Default us.
• lang (string, optional) — result language. Default en.
• fetch_content (boolean, optional) — scrape each result page. Default false.
• freshness (string, optional) — day, week, month, or year.

Example

curl -X POST https://api.ilmenite.dev/v1/search \
  -H "Authorization: Bearer $ILMENITE_API_KEY" \
  -d '{
    "query": "rust async runtime comparison",
    "limit": 5,
    "fetch_content": true,
    "freshness": "year"
  }'

Response

{
  "query": "rust async runtime comparison",
  "count": 5,
  "results": [
    {
      "title": "Tokio vs async-std vs smol",
      "url": "https://example.com/rust-async",
      "snippet": "A comparison of the three most popular...",
      "published_at": "2026-02-14",
      "markdown": "# Tokio vs async-std..."
    }
  ],
  "latency_ms": 890
}

Billing

One search call = one API call. If fetch_content: true, each scraped result counts as an additional call. A search with limit=10 and fetching enabled = 11 calls total.