API Documentation - SEARCH.HWMNBN.ME

Overview

The SEARCH.HWMNBN.ME API allows you to programmatically search across multiple search engines and databases. All responses are in JSON format.

Base URL: https://search2.hwmnbn.me

Authentication

The API is currently open and does not require authentication. This may change in the future if abuse is detected.

Rate Limits

To ensure fair usage, the API is rate limited to 100 requests per minute per IP address. If you exceed this limit, you'll receive a 429 Too Many Requests response.

Search

Search across all enabled engines and get aggregated results.

GET /api/search

Parameters

Name	Type	Description
q required	string	The search query
category	string	Filter by category (general, code, science, etc.). Default: all
page	integer	Page number for pagination. Default: 1

Example Request

curl "https://search2.hwmnbn.me/api/search?q=cloudflare+workers&category=code"

Example Response

                  {
  "query": "cloudflare workers",
  "results": [
    {
      "title": "cloudflare/workers-sdk",
      "url": "https://github.com/cloudflare/workers-sdk",
      "content": "The Workers SDK - monorepo for wrangler and more",
      "engine": "github"
    }
  ],
  "count": 42,
  "engines": 5,
  "cached": false
}
                

Engines

Get a list of all available search engines.

GET /api/engines

Example Request

curl "https://search2.hwmnbn.me/api/engines"

Example Response

                  {
  "engines": [
    {
      "id": "duckduckgo",
      "name": "DuckDuckGo",
      "category": "general",
      "enabled": true
    },
    {
      "id": "github",
      "name": "GitHub",
      "category": "code",
      "enabled": true
    }
  ]
}
                

Health Check

Check if the API is operational.

GET /health

Example Response

                  {
  "status": "ok",
  "timestamp": 1699123456789
}
                

Cache Management

Clear the search results cache.

GET /api/clear-cache

Clears all cached search results. Redirects back to the referring page.