Search operations in an OpenAPI 3.x or Swagger 2.x spec against a free-text quer
Search operations in an OpenAPI 3.x or Swagger 2.x spec against a free-text query. Tokenizes the query (lowercase, alphanumeric runs), scores each operation by which fields the tokens match - operationId +3, path +3, tags +2, summary +2, description +1 per matched token - and returns ranked results with a `matches` array naming the contributing fields. Sort: score descending, then path ascending for stability. Limit defaults to 10 (max 100).
Answeringour last check, 2026-09-24
1 of 1checks answered this week
952 msmedian answer time
$0.001listed price per call
$0.001price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://agent402.tools/api/openapi-search
| Category | Market data |
|---|---|
| Provider host | agent402.tools |
| Networks | algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=, eip155:10, eip155:1329, eip155:137, eip155:143, eip155:42161, eip155:42220, eip155:43114, eip155:4663, eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, stellar:pubnet |
| Payment schemes | exact, upto |
| Self-reported calls, 30 days | 5 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.001 | 952 ms |
Example input (from the provider)
{
"body": {
"query": "user avatar",
"spec": {
"paths": {
"/posts": {
"get": {
"operationId": "listPosts",
"responses": {
"200": {}
},
"summary": "List posts",
"tags": [
"posts"
]
}
},
"/users/{id}": {
"get": {
"operationId": "getUser",
"responses": {
"200": {}
},
"summary": "Get a user",
"tags": [
"users"
]
}
},
"/users/{id}/avatar": {
"put": {
"operationId": "uploadUserAvatar",
"responses": {
"200": {}
},
"summary": "Upload user avatar",
"tags": [
"users"
]
}
}
}
}
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"limit": {
"description": "Maximum results to return (default 10, max 100)"
},
"query": {
"description": "Free-text search query (tokenized lowercase)"
},
"spec": {
"description": "OpenAPI/Swagger document (object or JSON string)"
}
},
"required": [
"spec",
"query"
]
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"results": {
"items": {
"properties": {
"matches": {
"items": {
"type": "string"
},
"type": "array"
},
"method": {
"type": "string"
},
"operationId": {
"type": "string"
},
"path": {
"type": "string"
},
"score": {
"type": "integer"
},
"summary": {
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"type": "array"
},
"total": {
"type": "integer"
}
},
"required": [
"total",
"results"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}