Convoca

Busca convocatorias de premios y concursos literarios con el plazo abierto: por texto, género, lengua, plazo, edad de quien escribe, cuota, dotación y ámbito. Devuelve primero las que cierran antes, con su página en Convoca y sus bases. Un null no consta en la fuente.

{
  "type": "object",
  "properties": {
    "texto": {
      "type": "string",
      "maxLength": 120,
      "description": "Palabras del título o de quien convoca, p. ej. «Sant Jordi» o «Ayuntamiento de Elche»."
    },
    "genero": {
      "type": "string",
      "enum": [
        "poesia",
        "novela",
        "cuento",
        "teatro",
        "comic",
        "infantil_juvenil",
        "traduccion_ensayo",
        "no_ficcion",
        "obra_publicada",
        "otro"
      ],
      "description": "cuento es relato y microrrelato; teatro incluye guion; traduccion_ensayo, ensayo y traducción."
    },
    "lengua": {
      "type": "string",
      "enum": [
        "castellano",
        "catala",
        "galego",
        "euskera",
        "ingles"
      ],
      "description": "Lengua en la que se puede escribir la obra."
    },
    "edad": {
      "type": "integer",
      "minimum": 5,
      "maximum": 120,
      "description": "Edad de quien escribe: quita las que piden otra edad. Las que no dicen edad se quedan."
    },
    "sin_cuota": {
      "type": "boolean",
      "description": "Solo las que dicen que presentarse es gratis. Las que no dicen nada de la cuota se quitan."
    },
    "solo_sin_residencia": {
      "type": "boolean",
      "description": "Solo las que no piden residir en un sitio concreto."
    },
    "premio_minimo": {
      "type": "integer",
      "minimum": 0,
      "description": "Dotación mínima en euros."
    },
    "cierra_antes_de": {
      "type": "string",
      "format": "date",
      "description": "AAAA-MM-DD: solo las que cierran ese día o antes."
    },
    "ambito": {
      "type": "string",
      "enum": [
        "España",
        "Latinoamérica",
        "Internacional"
      ]
    },
    "incluir_por_designacion": {
      "type": "boolean",
      "default": false,
      "description": "Incluir premios a los que no se presenta una misma, porque las candidaturas las proponen terceros."
    },
    "limite": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 15,
      "description": "Cuántas devolver como mucho (15 si no se dice)."
    }
  },
  "additionalProperties": false
}

Todo lo que sabemos de un premio literario: la convocatoria abierta o la última, cuándo vuelve, las ediciones vistas, el palmarés y los libros premiados, con un resumen en una frase. Acepta el identificador del premio (slug, de buscar_premios o de la dirección de su página) o su nombre.

{
  "type": "object",
  "properties": {
    "premio": {
      "type": "string",
      "minLength": 2,
      "maxLength": 160,
      "description": "El slug (p. ej. premi-carles-riba-de-poesia) o el nombre del premio."
    }
  },
  "required": [
    "premio"
  ],
  "additionalProperties": false
}

Encuentra premios literarios por nombre, quien convoca, género o lengua, tengan o no la convocatoria abierta. Devuelve su identificador (slug) para ver_premio.

{
  "type": "object",
  "properties": {
    "texto": {
      "type": "string",
      "maxLength": 120,
      "description": "Palabras del nombre o de quien convoca."
    },
    "genero": {
      "type": "string",
      "enum": [
        "poesia",
        "novela",
        "cuento",
        "teatro",
        "comic",
        "infantil_juvenil",
        "traduccion_ensayo",
        "no_ficcion",
        "obra_publicada",
        "otro"
      ]
    },
    "lengua": {
      "type": "string",
      "enum": [
        "castellano",
        "catala",
        "galego",
        "euskera",
        "ingles"
      ]
    },
    "solo_abiertos": {
      "type": "boolean",
      "description": "Solo los que tienen la convocatoria abierta."
    },
    "limite": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 15,
      "description": "Cuántos devolver como mucho (15 si no se dice)."
    }
  },
  "additionalProperties": false
}

Quién ganó los premios literarios que sigue Convoca: año, obra, autoría y libro publicado, con la fuente donde se anunció el fallo. Solo fallos validados a mano o con dos fuentes. Filtra por premio, autoría, obra o año.

{
  "type": "object",
  "properties": {
    "premio": {
      "type": "string",
      "maxLength": 160,
      "description": "Nombre o slug del premio."
    },
    "autor": {
      "type": "string",
      "maxLength": 120
    },
    "obra": {
      "type": "string",
      "maxLength": 160
    },
    "anyo": {
      "type": "integer",
      "minimum": 1900,
      "maximum": 2100
    },
    "limite": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Cuántos fallos devolver como mucho (20 si no se dice)."
    }
  },
  "additionalProperties": false
}

Libros publicados que han ganado un premio literario, del más reciente al más antiguo, con editorial, ISBN, fecha y su ficha en Convoca. Filtra por texto (título, autoría o premio), lengua del libro y año.

{
  "type": "object",
  "properties": {
    "texto": {
      "type": "string",
      "maxLength": 160
    },
    "lengua": {
      "type": "string",
      "maxLength": 40,
      "description": "Lengua del libro, en palabras: «catalán», «castellano», «gallego»…"
    },
    "desde_anyo": {
      "type": "integer",
      "minimum": 1900,
      "maximum": 2100,
      "description": "Solo premios de ese año en adelante."
    },
    "limite": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Cuántos devolver como mucho (20 si no se dice)."
    }
  },
  "additionalProperties": false
}