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.