Technical Documentation

Everything you need to know about integrating and using WorldData Generator's fictional records.

Introduction

WorldData Generator provides high-fidelity fictional data for testing purposes only. Our engine is built on top of robust randomization algorithms to ensure that the data generated is structurally correct for any given locale but contains zero real-world sensitivity.

Data Schema

Each generated record follows a strict TypeScript interface:

interface FictionalPersona {
  id: string; // Fictional UUID
  fullName: string;
  firstName: string;
  lastName: string;
  email: string;
  phone: string;
  address: string;
  city: string;
  state: string;
  country: string;
  postalCode: string;
  taxId: string; // Fictional identification number
  company: string;
  jobTitle: string;
  creditCard: {
    number: string; // Sandbox testing format only
    expiry: string;
    cvv: string;
    type: string;
  };
  iban: string; // Sandbox IBAN
  swift: string; // Sandbox BIC/SWIFT
}

Localized Compliance

Our engine intelligently adapts data formats based on the selected country:

  • Brazil

    PT-BR names, CPF formats, and localized phone patterns.

  • United States

    US-style addresses, SSN patterns, and standard phone formats.

  • Germany

    DE names, European address structures, and specialized postal codes.

  • Japan

    Common Japanese name patterns and local address formatting.

Usage & Limits

Free users can generate up to 3 objects per turn. Pro users can generate and download batches of 1,000 records at a time. There is no rate limiting for Pro users within standard professional use profiles.

Exporting your data

Need to seed a database or fill a spreadsheet? Our Pro plan unlocks CSV, JSON, and TXT exports for all generators.