Icon Search API

GET /api/icon/search $0.002 per call USDC on Base · x402

Search Font Awesome Free (2000+ icons) by keyword: matches names, labels, and official search terms, ranked. Returns icon names, available styles (solid/regular/brands), and terms. Use the chosen name in POST /api/icon/generate.

Parameters

Name	In		Description
`q`	query	required	Keyword to search, e.g. rocket, shopping cart, music
`style`	query		Optional filter: solid, regular, or brands

Example request

curl "https://api.webbersites.com/api/icon/search?q=rocket&style=solid"
# first call returns 402 + payment requirements; an x402 client pays and retries automatically

Example response

{
    "query": "rocket",
    "count": 3,
    "results": [
        {
            "name": "rocket",
            "label": "Rocket",
            "styles": [
                "solid"
            ],
            "score": 100
        }
    ]
}

MCP tool: get_icon_search — via npx -y webbersites-x402-mcp (local, key stays on your machine) or the remote endpoint https://api.webbersites.com/mcp.

How payment works

There is no signup and no API key. Call the endpoint; it replies 402 Payment Required with machine-readable payment requirements. Your client signs a USDC transfer authorization (EIP-3009, gasless) and retries with the X-PAYMENT header — @x402/fetch does this automatically. See the overview for a working snippet.