> ## Documentation Index
> Fetch the complete documentation index at: https://spotzee.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate synthetic food data

> Generates synthetic food and menu fixtures for testing recipe, catalog, restaurant, and content workflows. Supported methods: profile, adjective, description, dish, ethnicCategory, fruit, ingredient, meat, spice, and vegetable.



## OpenAPI

````yaml https://apix.spotzee.com/api/ext/openapi.json post /generic/data/generate/food
openapi: 3.1.0
info:
  title: Spotzee API
  version: '2026-04-28'
  description: >-
    Comprehensive API for email services, DNS management, AI tools, and
    marketing features.
servers:
  - url: https://apix.spotzee.com/api/ext
    description: >-
      Extended API surface — sender-side utilities (DNS, AI, deliverability,
      generators).
security:
  - BearerAuth: []
tags:
  - name: AI
    description: >-
      Sender-side AI utilities — generate copy, score subject lines, and draft
      message variants tailored to a contact or campaign brief.
  - name: Data
    description: >-
      Realistic-looking sample data for development and load testing — contacts,
      events, and segments shaped like production records without exposing real
      customer data.
  - name: DNS
    description: >-
      Inspect a domain’s sender posture — SPF, DKIM, DMARC, MX, and reverse-DNS
      records — and surface the gaps that put deliverability at risk.
  - name: Email
    description: >-
      Send-side validation and inspection — verify addresses, fingerprint MTAs,
      decode bounces, and check inbox-placement signals before a campaign goes
      out.
  - name: SMS
    description: Mobile-number validation and carrier lookup for SMS campaigns.
  - name: Text
    description: >-
      Text-quality utilities — spam-score grading, readability metrics, and
      subject-line scoring against deliverability heuristics.
paths:
  /generic/data/generate/food:
    post:
      tags:
        - Data
      summary: Generate synthetic food data
      description: >-
        Generates synthetic food and menu fixtures for testing recipe, catalog,
        restaurant, and content workflows. Supported methods: profile,
        adjective, description, dish, ethnicCategory, fruit, ingredient, meat,
        spice, and vegetable.
      operationId: generateFoodData
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                count:
                  type: string
                  description: >-
                    Number of food records to generate (1-100). Passed as string
                    but must be numeric.
                  example: '10'
                  pattern: ^[1-9]\d?$|^100$
                locale:
                  type: string
                  description: >-
                    Locale for generated data (for example, en, es, fr, de, pt,
                    zh)
                  example: en
                seed:
                  type: string
                  description: >-
                    Seed for deterministic generation. Same seed produces same
                    results.
                  example: '12345'
                method:
                  type: string
                  description: Food generation method. Defaults to profile.
                  example: profile
                  enum:
                    - profile
                    - adjective
                    - description
                    - dish
                    - ethnicCategory
                    - fruit
                    - ingredient
                    - meat
                    - spice
                    - vegetable
      responses:
        '200':
          description: Successfully generated food data
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  data:
                    type: object
                    properties:
                      foods:
                        type: array
                        items:
                          type: object
                          properties:
                            method:
                              type: string
                              enum:
                                - profile
                                - adjective
                                - description
                                - dish
                                - ethnicCategory
                                - fruit
                                - ingredient
                                - meat
                                - spice
                                - vegetable
                              description: Resolved food generation method.
                              example: profile
                            value:
                              type: string
                              description: Primary generated food fixture value.
                              example: Crispy chicken parmesan
                            adjective:
                              type: string
                              description: Generated food adjective.
                              example: Crispy
                            description:
                              type: string
                              description: Generated food description.
                              example: A rich and savory dish with fresh ingredients.
                            dish:
                              type: string
                              description: Generated dish name.
                              example: Chicken parmesan
                            ethnicCategory:
                              type: string
                              description: Generated cuisine or regional category.
                              example: Italian
                            fruit:
                              type: string
                              description: Generated fruit name.
                              example: Mango
                            ingredient:
                              type: string
                              description: Generated ingredient name.
                              example: Olive oil
                            meat:
                              type: string
                              description: Generated meat or protein name.
                              example: Chicken
                            spice:
                              type: string
                              description: Generated spice name.
                              example: Paprika
                            vegetable:
                              type: string
                              description: Generated vegetable name.
                              example: Broccoli
                          required:
                            - method
                            - value
                      generated:
                        type: number
                      locale:
                        type: string
                      seed:
                        type: number
                      method:
                        type: string
                        enum:
                          - profile
                          - adjective
                          - description
                          - dish
                          - ethnicCategory
                          - fruit
                          - ingredient
                          - meat
                          - spice
                          - vegetable
                    required:
                      - foods
                      - generated
                      - locale
                      - method
                  performance:
                    type: object
                    properties:
                      generationTime:
                        type: number
                        description: Generation time in milliseconds.
                        example: 2
                      itemsGenerated:
                        type: number
                        description: Number of items generated.
                        example: 10
                      locale:
                        type: string
                        description: Locale used for generation.
                        example: en
                    required:
                      - generationTime
                      - itemsGenerated
                      - locale
                required:
                  - status
                  - data
                example:
                  status: success
                  data:
                    foods:
                      - method: profile
                        value: Chicken parmesan
                        dish: Chicken parmesan
                        description: A rich and savory dish with fresh ingredients.
                        ethnicCategory: Italian
                        adjective: Crispy
                        ingredient: Olive oil
                        meat: Chicken
                        fruit: Mango
                        vegetable: Broccoli
                        spice: Paprika
                    generated: 1
                    locale: en
                    seed: 12345
                    method: profile
                  performance:
                    generationTime: 2
                    itemsGenerated: 1
                    locale: en
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                    description: Indicates an error occurred
                  error:
                    type: string
                    description: >-
                      Human-readable error message. Mirrors the Main API
                      envelope’s legacy `error` field; the canonical replacement
                      is `message` + machine-readable `code` (see
                      @spotzee/api-schemas/shared `ErrorResponse`).
                    example: Invalid request parameters
                required:
                  - status
                  - error
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                    description: Indicates an error occurred
                  error:
                    type: string
                    description: >-
                      Human-readable error message. Mirrors the Main API
                      envelope’s legacy `error` field; the canonical replacement
                      is `message` + machine-readable `code` (see
                      @spotzee/api-schemas/shared `ErrorResponse`).
                    example: Invalid request parameters
                required:
                  - status
                  - error
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                    description: Indicates an error occurred
                  error:
                    type: string
                    description: >-
                      Human-readable error message. Mirrors the Main API
                      envelope’s legacy `error` field; the canonical replacement
                      is `message` + machine-readable `code` (see
                      @spotzee/api-schemas/shared `ErrorResponse`).
                    example: Invalid request parameters
                required:
                  - status
                  - error
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                    description: Indicates an error occurred
                  error:
                    type: string
                    description: >-
                      Human-readable error message. Mirrors the Main API
                      envelope’s legacy `error` field; the canonical replacement
                      is `message` + machine-readable `code` (see
                      @spotzee/api-schemas/shared `ErrorResponse`).
                    example: Invalid request parameters
                required:
                  - status
                  - error
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                    description: Indicates an error occurred
                  error:
                    type: string
                    description: >-
                      Human-readable error message. Mirrors the Main API
                      envelope’s legacy `error` field; the canonical replacement
                      is `message` + machine-readable `code` (see
                      @spotzee/api-schemas/shared `ErrorResponse`).
                    example: Invalid request parameters
                required:
                  - status
                  - error
        '504':
          description: Gateway timeout
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                    description: Indicates an error occurred
                  error:
                    type: string
                    description: >-
                      Human-readable error message. Mirrors the Main API
                      envelope’s legacy `error` field; the canonical replacement
                      is `message` + machine-readable `code` (see
                      @spotzee/api-schemas/shared `ErrorResponse`).
                    example: Invalid request parameters
                required:
                  - status
                  - error
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'Bearer token authentication. Use format: Bearer YOUR_API_KEY'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.