User Guide

Welcome to Mockgene

Generate realistic mock data for development, testing, and demos. Build schemas visually or with AI, export in multiple formats, and publish live API endpoints.

90+ Field Types
AI Powered
6 Export Formats
Live API Endpoints

Step-by-Step Guide

STEP 1

Create Your Schema

Step 1

Define the structure of your mock data by adding fields with specific types.

  • Click 'Add Field' to add columns to your schema
  • Choose from 90+ field types across 11 categories (Person, Address, Finance, etc.)
  • Configure per-field options like min/max values, date ranges, and custom lists
  • Set a blank percentage to simulate missing data
  • Drag and drop fields to reorder them
  • Set the number of rows to generate (10–10,000)
STEP 2

AI Schema Generator

Step 2

Describe what you need in plain English and let AI build the schema for you.

  • Click the 'AI Generate' button in the Schema Editor
  • Describe your data needs (e.g., 'E-commerce orders with products and shipping')
  • Preview the generated fields before applying
  • Use 'Modify' mode to refine an existing schema with AI
  • Try the suggested prompts for quick inspiration
STEP 3

Browse Industry Templates

Step 3

Start from pre-built schemas organized by industry and use case.

  • Open the Industry Browser panel on the left sidebar
  • Browse 8 industries: Insurance, Fintech, Healthcare, E-Commerce, and more
  • Explore 20+ sub-categories with 30+ ready-made schemas
  • Click any template to instantly load it into the editor
  • Customize the loaded schema to fit your exact needs
STEP 4

Generate & Preview Data

Step 4

Generate realistic mock data and preview it before exporting.

  • Click 'Generate' to create mock data based on your schema
  • Switch between Table view and JSON view in the Data Preview tab
  • Data is generated using faker.js for realistic values
  • Re-generate anytime to get fresh random data
STEP 5

Export Your Data

Step 5

Download your generated data in multiple formats.

  • Export to CSV, JSON, SQL, XML, TSV, or Excel-compatible CSV
  • SQL export includes CREATE TABLE and INSERT statements
  • JSON export supports both array and object formats
  • Configure format-specific options before downloading
STEP 6

Publish as API Endpoint

Step 6

Turn any schema into a live REST API that returns fresh mock data on every call.

  • Click 'Publish API' to create a live endpoint
  • Each endpoint gets a unique URL slug
  • Optionally make endpoints public for others to use
  • Access via GET request with your API key
  • Fresh data is generated on every request
STEP 7

API Playground

Step 7

Test your published endpoints directly in the browser.

  • View all your published endpoints in one place
  • Send test requests and see live responses
  • Copy ready-made code snippets (cURL, Python, Node.js)
  • Browse public endpoints shared by other users
  • Adjust query parameters like row count
STEP 8

Manage API Keys

Step 8

Secure your endpoints with API key authentication.

  • Go to Settings to manage your API keys
  • An API key is auto-generated when you sign up
  • Create up to 10 keys per account
  • Activate or deactivate keys as needed
  • Pass your key via ?key= parameter or X-Api-Key header
  • Track usage with request counts and last-used timestamps

Available Field Types

Over 90 field types organized into 11 categories to cover any data generation need.

👤Person

Full Name, First Name, Email, Phone, Avatar

📍Address

Street, City, State, ZIP, Country, Coordinates

🏢Company

Company Name, Department, Job Title, Catch Phrase

💳Finance

Credit Card, IBAN, Bitcoin Address, Currency, Amount

🌐Internet

URL, IP Address, MAC Address, User Agent, Domain

📅Date & Time

Date, DateTime, Timestamp, Month, Weekday

🔢Number

Integer, Float, Boolean, Hex Color, Binary

📝Text

Sentence, Paragraph, Lorem Ipsum, Word, Slug

🆔ID

UUID, Auto Increment, MongoDB ObjectId, CUID

🛒Commerce

Product Name, Price, Department, ISBN, Barcode

⚙️Custom

Custom List, Regex Pattern, Weighted Values, Formula

Tips & Best Practices

Use AI for complex schemas

Describe your domain in detail — the AI understands context like 'healthcare patient records with HIPAA-compliant fields'.

Drag to reorder fields

Grab the grip handle on any field row to rearrange your schema columns.

Modify mode for refinements

Already have a schema? Use AI Modify mode to add, remove, or tweak fields without starting over.

Keep API keys secure

Never expose your API key in client-side code. Use environment variables or server-side requests.

Use the code snippets

The API Playground provides copy-paste code for cURL, Python, and Node.js to integrate quickly.

SQL export for databases

The SQL export generates CREATE TABLE + INSERT statements ready to run in your database.

API Authentication

All API endpoints require authentication. Pass your API key using one of these methods:

Query Parameter

GET /api/mock/your-endpoint?key=mg_your_api_key

Request Header

X-Api-Key: mg_your_api_key

Optional Parameters

?rows=50 — Number of rows to generate (default: schema setting)?format=json — Response format (json is default)

Built with ❤️ by Solvrays