TheMealDB Premium API

openapi: 3.0.0
info:
  title: TheMealDB Categories.php Premium API
  description: An open, crowd-sourced database of meals and recipes from around the world
  version: 1.0.0
  contact:
    url: https://www.themealdb.com
servers:
- url: https://www.themealdb.com/api/json/v1/{apiKey}
  variables:
    apiKey:
      default: '1'
      description: API key - use '1' for testing/development. Premium supporters use their personal key.
tags:
- name: Premium
  description: Premium-only endpoints requiring a paid lifetime supporter API key
paths:
  /randomselection.php:
    get:
      summary: Get 10 random meals (Premium only)
      description: Retrieve 10 randomly selected meals in a single call. Requires a premium supporter API key.
      operationId: getRandomSelection
      tags:
      - Premium
      responses:
        '200':
          description: Successful response with 10 random meals
          content:
            application/json:
              schema:
                type: object
                properties:
                  meals:
                    type: array
                    items:
                      $ref: '#/components/schemas/Meal'
  /latest.php:
    get:
      summary: Get latest 10 meals (Premium only)
      description: Retrieve the 10 most recently added meals. Requires a premium supporter API key.
      operationId: getLatestMeals
      tags:
      - Premium
      responses:
        '200':
          description: Successful response with the 10 newest meals
          content:
            application/json:
              schema:
                type: object
                properties:
                  meals:
                    type: array
                    items:
                      $ref: '#/components/schemas/Meal'
components:
  schemas:
    Meal:
      type: object
      description: Full meal record with recipe details, ingredients, and measurements.
      properties:
        idMeal:
          type: string
          description: Unique numeric identifier for the meal
          example: '52771'
        strMeal:
          type: string
          description: Meal name
          example: Spicy Arrabiata Penne
        strDrinkAlternate:
          type: string
          nullable: true
          description: Suggested drink pairing
        strCategory:
          type: string
          description: Meal category (e.g. Vegetarian, Beef, Dessert)
          example: Vegetarian
        strArea:
          type: string
          description: Cuisine area / country of origin
          example: Italian
        strInstructions:
          type: string
          description: Step-by-step cooking instructions
        strMealThumb:
          type: string
          format: uri
          description: URL to the meal thumbnail image. Append /small, /medium, or /large for sized variants.
          example: https://www.themealdb.com/images/media/meals/ustsqw1468250014.jpg
        strTags:
          type: string
          nullable: true
          description: Comma-separated tags
          example: Pasta,Curry
        strYoutube:
          type: string
          nullable: true
          format: uri
          description: YouTube video URL for recipe walkthrough
        strIngredient1:
          type: string
          nullable: true
        strIngredient2:
          type: string
          nullable: true
        strIngredient3:
          type: string
          nullable: true
        strIngredient4:
          type: string
          nullable: true
        strIngredient5:
          type: string
          nullable: true
        strIngredient6:
          type: string
          nullable: true
        strIngredient7:
          type: string
          nullable: true
        strIngredient8:
          type: string
          nullable: true
        strIngredient9:
          type: string
          nullable: true
        strIngredient10:
          type: string
          nullable: true
        strIngredient11:
          type: string
          nullable: true
        strIngredient12:
          type: string
          nullable: true
        strIngredient13:
          type: string
          nullable: true
        strIngredient14:
          type: string
          nullable: true
        strIngredient15:
          type: string
          nullable: true
        strIngredient16:
          type: string
          nullable: true
        strIngredient17:
          type: string
          nullable: true
        strIngredient18:
          type: string
          nullable: true
        strIngredient19:
          type: string
          nullable: true
        strIngredient20:
          type: string
          nullable: true
        strMeasure1:
          type: string
          nullable: true
        strMeasure2:
          type: string
          nullable: true
        strMeasure3:
          type: string
          nullable: true
        strMeasure4:
          type: string
          nullable: true
        strMeasure5:
          type: string
          nullable: true
        strMeasure6:
          type: string
          nullable: true
        strMeasure7:
          type: string
          nullable: true
        strMeasure8:
          type: string
          nullable: true
        strMeasure9:
          type: string
          nullable: true
        strMeasure10:
          type: string
          nullable: true
        strMeasure11:
          type: string
          nullable: true
        strMeasure12:
          type: string
          nullable: true
        strMeasure13:
          type: string
          nullable: true
        strMeasure14:
          type: string
          nullable: true
        strMeasure15:
          type: string
          nullable: true
        strMeasure16:
          type: string
          nullable: true
        strMeasure17:
          type: string
          nullable: true
        strMeasure18:
          type: string
          nullable: true
        strMeasure19:
          type: string
          nullable: true
        strMeasure20:
          type: string
          nullable: true
        strSource:
          type: string
          nullable: true
          format: uri
          description: Original recipe source URL
        strImageSource:
          type: string
          nullable: true
          description: Image attribution source
        strCreativeCommonsConfirmed:
          type: string
          nullable: true
          description: Indicates if the image is confirmed Creative Commons licensed
        dateModified:
          type: string
          format: date-time
          nullable: true
          description: Date the meal record was last modified