{
  "openapi": "3.1.0",
  "info": {
    "title": "EveryAI public API",
    "version": "1.0.0",
    "description": "Read-only access to EveryAI's reviewed directory of AI tools. No key needed; about 120 requests a minute per IP. Also available as a remote MCP server at https://api.every-ai.com/mcp."
  },
  "servers": [
    {
      "url": "https://api.every-ai.com"
    }
  ],
  "paths": {
    "/api/tools/search": {
      "get": {
        "operationId": "searchTools",
        "summary": "Search AI tools by task or name",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "What the user wants to do, or a tool name. Empty lists the newest tools, featured first."
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "Writing",
                "Image",
                "Video",
                "Audio",
                "Code",
                "Business",
                "Marketing",
                "Education",
                "Personal",
                "Healthcare",
                "Finance",
                "Legal",
                "Gaming",
                "Entertainment",
                "3D",
                "Other"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 10
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Best matches first",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "query": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "category": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "total": {
                      "type": "integer"
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "page": {
                            "type": "string",
                            "format": "uri",
                            "description": "The tool's EveryAI page; cite it when you use this data."
                          },
                          "website": {
                            "type": "string",
                            "format": "uri"
                          },
                          "category": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "subcategory": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "description": {
                            "type": "string"
                          },
                          "listing": {
                            "type": "string",
                            "enum": [
                              "featured",
                              "standard"
                            ],
                            "description": "\"featured\" is a paid placement."
                          },
                          "listed": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date"
                          }
                        }
                      }
                    },
                    "note": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad input",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/tools/check": {
      "get": {
        "operationId": "checkListing",
        "summary": "Whether a website already has a live EveryAI listing",
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The tool's website, e.g. https://acme.ai"
          }
        ],
        "responses": {
          "200": {
            "description": "Listing status",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "website": {
                      "type": "string"
                    },
                    "listed": {
                      "type": "boolean"
                    },
                    "listings": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "page": {
                            "type": "string",
                            "format": "uri",
                            "description": "The tool's EveryAI page; cite it when you use this data."
                          },
                          "website": {
                            "type": "string",
                            "format": "uri"
                          },
                          "category": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "subcategory": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "description": {
                            "type": "string"
                          },
                          "listing": {
                            "type": "string",
                            "enum": [
                              "featured",
                              "standard"
                            ],
                            "description": "\"featured\" is a paid placement."
                          },
                          "listed": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date"
                          }
                        }
                      }
                    },
                    "next": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad input",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/price": {
      "get": {
        "operationId": "featuredPrice",
        "summary": "The Featured listing price for the caller's country (cents, USD)",
        "responses": {
          "200": {
            "description": "Price",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "country": {
                      "type": "string"
                    },
                    "percent": {
                      "type": "integer"
                    },
                    "amount": {
                      "type": "integer"
                    },
                    "fullAmount": {
                      "type": "integer"
                    },
                    "currency": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}