Use search when you need a lightweight discovery call instead of a full paginated browse request.
Search is best for fast routing, autocomplete, and broad keyword lookups. Use GET /api/v1/recommend when the user is asking for ranked candidates for a task and stack.
Good query shapes
- product names
- tool names such as
Claude,Supabase, orLangChain - use-case phrases such as
agent-native support tools - stack phrases such as
Claude Supabase operations
Response shape
Every result includes an absolute href, which makes the endpoint easy to consume from external agents and automations.
GET
/api/v1/searchUse this for lightweight lookup and discovery flows where a full filtered catalog request is unnecessary.
Auth
No API keys. No account auth. Public JSON endpoints only.
Review model
Read-only endpoint over public search suggestions.
Cache
Dynamic server response.
Example request
curl "https://www.madewithstack.com/api/v1/search?q=parse"
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search query string. |
Responses
200
Success
Returns matching tool and product suggestions with absolute URLs.
{
"results": [
{
"type": "tool",
"slug": "supabase",
"name": "Supabase",
"description": "Postgres backend, auth, and storage platform.",
"href": "https://www.madewithstack.com/built-with/supabase",
"icon_url": "https://cdn.simpleicons.org/supabase",
"favicon_url": null,
"screenshot_url": null
},
{
"type": "product",
"slug": "parsewise",
"name": "Parsewise",
"description": "Research agent for technical document workflows.",
"href": "https://www.madewithstack.com/product/parsewise",
"icon_url": null,
"favicon_url": "https://parsewise.ai/icon.png",
"screenshot_url": "https://parsewise.ai/screenshot.png"
}
],
"query": "parse"
}Error codes
| Code | Status | Meaning |
|---|---|---|
INTERNAL_ERROR | 500 | Unexpected server error. Retry later. |
Operational notes
- Call this when you need keyword-based lookup for tools or products, or when mapping a natural-language query to directory entities.
- Empty q returns an empty result set instead of an error.
- Result URLs are absolute so external agents can resolve them directly.