{"uid":"cap_Z8wybU0byRExCF0YlxLj1","slug":"agent402-tools-openapi-search-38a65686","name":"agent402.tools OpenAPI Search","description":"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).","url":"https://agent402.tools/api/openapi-search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"spec":{"description":"OpenAPI/Swagger document (object or JSON string)"},"limit":{"description":"Maximum results to return (default 10, max 100)"},"query":{"description":"Free-text search query (tokenized lowercase)"}}},"responseSchema":{"type":"json","example":{"total":2,"results":[{"path":"/users/{id}/avatar","tags":["users"],"score":18,"method":"PUT","matches":["operationId","path","summary","tags"],"summary":"Upload user avatar","operationId":"uploadUserAvatar"},{"path":"/users/{id}","tags":["users"],"score":10,"method":"GET","matches":["operationId","path","summary","tags"],"summary":"Get a user","operationId":"getUser"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_i0lJ4IDnR_ha_Vw8_sfcj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches operations within an OpenAPI 3.x or Swagger 2.x specification using free-text queries, scoring results by relevance across operationId, path, tags, summary, and description fields","exampleAgentPrompt":"Search this OpenAPI spec for operations related to 'authentication' and return up to 5 results — here's the spec: {spec}.","exampleUseCases":null,"resultDescription":"A ranked list of up to N matching API operations from the provided spec, each scored by how well tokens from the query matched fields like operationId, path, tags, summary, and description, along with relevant metadata about each matched operation.","failureModes":["Invalid or malformed OpenAPI/Swagger document causes parsing failure","Query returns zero results if no operations match the tokenized query","Exceeding the max limit of 100 results returns an error or is capped","Empty or whitespace-only query may return unranked or all results","Very large specs may time out or hit payload size limits","Non-JSON string spec that cannot be parsed returns an error"],"whenToPreferThis":"Use this endpoint when you have an OpenAPI or Swagger specification document and need to quickly locate relevant operations by keyword or topic without manually reading the entire spec. It is ideal for agent-driven API discovery, dynamic routing decisions, or when building tooling that introspects third-party APIs at runtime.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:58:59.720Z","isFirstParty":false}