{
  "openapi": "3.0.1",
  "info": {
    "title": "OER search",
    "description": "Searches OERSI, an open index of open educational resources from dozens of repositories (edusources, twillo, Zenodo, OpenLearnWare and others). Returns per result the title, web address, licence and language. No key needed.",
    "version": "1.0.0"
  },
  "servers": [
    { "url": "https://oersi.org" }
  ],
  "paths": {
    "/resources/api/search/oer_data/_search": {
      "get": {
        "operationId": "searchOpenResources",
        "summary": "Search open educational resources by keyword",
        "description": "Full-text search in OERSI. Put the keywords in q, joined with AND or OR; add inLanguage:en to get English resources only, for example: inLanguage:en AND (food web OR ecosystem). The answer is JSON: hits.hits[]._source with name (title), id (web address), license.id, inLanguage and description. Only list resources that really appear in the answer.",
        "parameters": [
          { "name": "q", "in": "query", "required": true, "description": "Search query, for example: inLanguage:en AND (food web OR ecosystem)", "schema": { "type": "string" } },
          { "name": "size", "in": "query", "required": false, "description": "Number of results, default 10, at most 20", "schema": { "type": "integer", "default": 10 } }
        ],
        "responses": {
          "200": { "description": "Search results as JSON" }
        }
      }
    }
  }
}