Random Profile API is a tool for generating realistic dummy data for testing, prototyping, and demo applications. It removes the need to write and maintain manual seeders by providing structured, synthetic user data over simple HTTP endpoints.
The API is designed to be predictable, flexible, and easy to integrate into any workflow.

Loading API stats...

Core Features

Structured Profile Generation

Generate complete, nested user profiles including identity, contact information, address, financial data, and more.

Flexible Field Selection

You can control the response size using:

  • fields → include only specific fields
  • exclude → remove specific fields
  • preset → use predefined field groups

Available presets:

  • minimal
  • identity
  • contact
  • full

Examples:

Bulk Profile Generation

Generate multiple profiles in a single request.

Limits:

  • Minimum: 1
  • Maximum: 15 profiles per request

Multiple Output Formats

Bulk responses support different formats for easier data processing:

  • json (default)
  • ndjson
  • csv

Example:

OpenAPI Specification

A machine-readable schema is available for tooling and automation.

This can be used to:

  • Import into Postman / Swagger
  • Generate client SDKs
  • Validate requests

Health Check

Useful for uptime monitoring and service checks.

Rate Limiting

  • 60 requests per minute per IP address

Requests exceeding this limit will return:

HTTP 429 Too Many Requests

Data Characteristics

  • All data is synthetic
  • No real individuals are represented
  • Suitable for testing, seeding, and demos

Quick Endpoint Reference

Single Profile

Bulk Profiles

Documentation

Full documentation and field reference:

https://profile.halukaksoy.dev/docs

The API is intended to stay simple: one request, structured data, no setup.

Random Profile API

A robust API that generates random Turkish user profiles with customizable fields and gender options.