Generate Random User Profiles
curl --request POST \
--url https://api.aisa.one/apis/v1/api-ninjas/generate-random-user \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"seed": "my-test-seed-123",
"count": 1,
"fields": [
"first_name",
"last_name",
"email"
],
"gender": "male",
"locale": "en_US",
"exclude": [
"ssn",
"credit_card",
"iban"
],
"max_age": 50,
"min_age": 18
}
'import requests
url = "https://api.aisa.one/apis/v1/api-ninjas/generate-random-user"
payload = {
"seed": "my-test-seed-123",
"count": 1,
"fields": ["first_name", "last_name", "email"],
"gender": "male",
"locale": "en_US",
"exclude": ["ssn", "credit_card", "iban"],
"max_age": 50,
"min_age": 18
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
seed: 'my-test-seed-123',
count: 1,
fields: ['first_name', 'last_name', 'email'],
gender: 'male',
locale: 'en_US',
exclude: ['ssn', 'credit_card', 'iban'],
max_age: 50,
min_age: 18
})
};
fetch('https://api.aisa.one/apis/v1/api-ninjas/generate-random-user', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/api-ninjas/generate-random-user",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'seed' => 'my-test-seed-123',
'count' => 1,
'fields' => [
'first_name',
'last_name',
'email'
],
'gender' => 'male',
'locale' => 'en_US',
'exclude' => [
'ssn',
'credit_card',
'iban'
],
'max_age' => 50,
'min_age' => 18
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/api-ninjas/generate-random-user"
payload := strings.NewReader("{\n \"seed\": \"my-test-seed-123\",\n \"count\": 1,\n \"fields\": [\n \"first_name\",\n \"last_name\",\n \"email\"\n ],\n \"gender\": \"male\",\n \"locale\": \"en_US\",\n \"exclude\": [\n \"ssn\",\n \"credit_card\",\n \"iban\"\n ],\n \"max_age\": 50,\n \"min_age\": 18\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/api-ninjas/generate-random-user")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"seed\": \"my-test-seed-123\",\n \"count\": 1,\n \"fields\": [\n \"first_name\",\n \"last_name\",\n \"email\"\n ],\n \"gender\": \"male\",\n \"locale\": \"en_US\",\n \"exclude\": [\n \"ssn\",\n \"credit_card\",\n \"iban\"\n ],\n \"max_age\": 50,\n \"min_age\": 18\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/api-ninjas/generate-random-user")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"seed\": \"my-test-seed-123\",\n \"count\": 1,\n \"fields\": [\n \"first_name\",\n \"last_name\",\n \"email\"\n ],\n \"gender\": \"male\",\n \"locale\": \"en_US\",\n \"exclude\": [\n \"ssn\",\n \"credit_card\",\n \"iban\"\n ],\n \"max_age\": 50,\n \"min_age\": 18\n}"
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"age": 123,
"dob": "<string>",
"job": "<string>",
"md5": "<string>",
"ssn": "<string>",
"url": "<string>",
"cell": "<string>",
"city": "<string>",
"iban": "<string>",
"ipv4": "<string>",
"ipv6": "<string>",
"name": "<string>",
"sha1": "<string>",
"uuid": "<string>",
"email": "<string>",
"phone": "<string>",
"state": "<string>",
"avatar": "<string>",
"domain": "<string>",
"gender": "<string>",
"locale": "<string>",
"prefix": "<string>",
"sha256": "<string>",
"suffix": "<string>",
"address": "<string>",
"company": "<string>",
"country": "<string>",
"picture": "<string>",
"latitude": 123,
"password": "<string>",
"timezone": "<string>",
"username": "<string>",
"full_name": "<string>",
"last_name": "<string>",
"longitude": 123,
"first_name": "<string>",
"user_agent": "<string>",
"credit_card": "<string>",
"mac_address": "<string>",
"postal_code": "<string>",
"company_email": "<string>",
"street_address": "<string>",
"credit_card_provider": "<string>"
}
]API Ninjas
Generate Random User Profiles
<!-- aisa-pricing:start -->
Usage-based billing; Default request estimate: $0.00089 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->
POST
https://api.aisa.one
/
apis
/
v1
/
api-ninjas
/
generate-random-user
Generate Random User Profiles
curl --request POST \
--url https://api.aisa.one/apis/v1/api-ninjas/generate-random-user \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"seed": "my-test-seed-123",
"count": 1,
"fields": [
"first_name",
"last_name",
"email"
],
"gender": "male",
"locale": "en_US",
"exclude": [
"ssn",
"credit_card",
"iban"
],
"max_age": 50,
"min_age": 18
}
'import requests
url = "https://api.aisa.one/apis/v1/api-ninjas/generate-random-user"
payload = {
"seed": "my-test-seed-123",
"count": 1,
"fields": ["first_name", "last_name", "email"],
"gender": "male",
"locale": "en_US",
"exclude": ["ssn", "credit_card", "iban"],
"max_age": 50,
"min_age": 18
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
seed: 'my-test-seed-123',
count: 1,
fields: ['first_name', 'last_name', 'email'],
gender: 'male',
locale: 'en_US',
exclude: ['ssn', 'credit_card', 'iban'],
max_age: 50,
min_age: 18
})
};
fetch('https://api.aisa.one/apis/v1/api-ninjas/generate-random-user', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/api-ninjas/generate-random-user",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'seed' => 'my-test-seed-123',
'count' => 1,
'fields' => [
'first_name',
'last_name',
'email'
],
'gender' => 'male',
'locale' => 'en_US',
'exclude' => [
'ssn',
'credit_card',
'iban'
],
'max_age' => 50,
'min_age' => 18
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/api-ninjas/generate-random-user"
payload := strings.NewReader("{\n \"seed\": \"my-test-seed-123\",\n \"count\": 1,\n \"fields\": [\n \"first_name\",\n \"last_name\",\n \"email\"\n ],\n \"gender\": \"male\",\n \"locale\": \"en_US\",\n \"exclude\": [\n \"ssn\",\n \"credit_card\",\n \"iban\"\n ],\n \"max_age\": 50,\n \"min_age\": 18\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/api-ninjas/generate-random-user")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"seed\": \"my-test-seed-123\",\n \"count\": 1,\n \"fields\": [\n \"first_name\",\n \"last_name\",\n \"email\"\n ],\n \"gender\": \"male\",\n \"locale\": \"en_US\",\n \"exclude\": [\n \"ssn\",\n \"credit_card\",\n \"iban\"\n ],\n \"max_age\": 50,\n \"min_age\": 18\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/api-ninjas/generate-random-user")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"seed\": \"my-test-seed-123\",\n \"count\": 1,\n \"fields\": [\n \"first_name\",\n \"last_name\",\n \"email\"\n ],\n \"gender\": \"male\",\n \"locale\": \"en_US\",\n \"exclude\": [\n \"ssn\",\n \"credit_card\",\n \"iban\"\n ],\n \"max_age\": 50,\n \"min_age\": 18\n}"
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"age": 123,
"dob": "<string>",
"job": "<string>",
"md5": "<string>",
"ssn": "<string>",
"url": "<string>",
"cell": "<string>",
"city": "<string>",
"iban": "<string>",
"ipv4": "<string>",
"ipv6": "<string>",
"name": "<string>",
"sha1": "<string>",
"uuid": "<string>",
"email": "<string>",
"phone": "<string>",
"state": "<string>",
"avatar": "<string>",
"domain": "<string>",
"gender": "<string>",
"locale": "<string>",
"prefix": "<string>",
"sha256": "<string>",
"suffix": "<string>",
"address": "<string>",
"company": "<string>",
"country": "<string>",
"picture": "<string>",
"latitude": 123,
"password": "<string>",
"timezone": "<string>",
"username": "<string>",
"full_name": "<string>",
"last_name": "<string>",
"longitude": 123,
"first_name": "<string>",
"user_agent": "<string>",
"credit_card": "<string>",
"mac_address": "<string>",
"postal_code": "<string>",
"company_email": "<string>",
"street_address": "<string>",
"credit_card_provider": "<string>"
}
]Request contract
- Method and path: POST /apis/v1/api-ninjas/generate-random-user
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/api-ninjas/generate-random-user - Runtime facts: 80f6d0ab09ca1b2bfaa51bc30934eca7d1f0ea7e38c9d075b9100f098998c5d9
{
"operationId": "api-ninjas.generate-random-user",
"method": "POST",
"path": "/apis/v1/api-ninjas/generate-random-user",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"required": false,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"seed": {
"type": "string",
"examples": [
"my-test-seed-123",
"demo-data-v1"
],
"description": "Seed value for reproducible random data generation. Using the same seed value will always produce the same set of random users, which is useful for testing or creating consistent demo data."
},
"count": {
"type": "integer",
"default": 10,
"maximum": 30,
"minimum": 1,
"examples": [
1,
5,
10
],
"description": "Number of random user profiles to generate. Must be between 1 and 30. Default: 10"
},
"fields": {
"type": "array",
"items": {
"enum": [
"id",
"username",
"password",
"email",
"uuid",
"locale",
"name",
"first_name",
"last_name",
"full_name",
"prefix",
"suffix",
"phone",
"cell",
"company_email",
"street_address",
"city",
"state",
"postal_code",
"country",
"address",
"latitude",
"longitude",
"timezone",
"dob",
"age",
"gender",
"job",
"company",
"ssn",
"credit_card",
"credit_card_provider",
"iban",
"ipv4",
"ipv6",
"mac_address",
"user_agent",
"url",
"domain",
"md5",
"sha1",
"sha256",
"picture",
"avatar"
],
"type": "string"
},
"examples": [
[
"first_name",
"last_name",
"email"
],
[
"username",
"phone"
]
],
"description": "Profile fields to include in the response. Only these fields are returned."
},
"gender": {
"enum": [
"male",
"female",
"nonbinary",
"any"
],
"type": "string",
"examples": [
"male",
"female",
"nonbinary",
"any"
],
"description": "Gender filter for random user generation"
},
"locale": {
"type": "string",
"examples": [
"en_US",
"de_DE",
"fr_FR",
"es_ES"
],
"description": "Locale for generating localized data such as names, addresses, and phone numbers. Use standard locale codes like 'en_US' (English - United States), 'de_DE' (German - Germany), 'fr_FR' (French - France), 'es_ES' (Spanish - Spain), etc. Default: 'en_US'"
},
"exclude": {
"type": "array",
"items": {
"enum": [
"id",
"username",
"password",
"email",
"uuid",
"locale",
"name",
"first_name",
"last_name",
"full_name",
"prefix",
"suffix",
"phone",
"cell",
"company_email",
"street_address",
"city",
"state",
"postal_code",
"country",
"address",
"latitude",
"longitude",
"timezone",
"dob",
"age",
"gender",
"job",
"company",
"ssn",
"credit_card",
"credit_card_provider",
"iban",
"ipv4",
"ipv6",
"mac_address",
"user_agent",
"url",
"domain",
"md5",
"sha1",
"sha256",
"picture",
"avatar"
],
"type": "string"
},
"examples": [
[
"ssn",
"credit_card",
"iban"
],
[
"password",
"ipv4",
"ipv6"
]
],
"description": "Profile fields to exclude from the response. All other fields are returned."
},
"max_age": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"examples": [
50,
65,
100
],
"description": "Maximum age for generated users. Must be between 0 and 1000. Default: 100"
},
"min_age": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"examples": [
18,
25,
30
],
"description": "Minimum age for generated users. Must be between 0 and 1000. Default: 0"
}
}
}
}
}
},
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "response_units",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.00089,
"estimate_source": "profile_seed",
"evidence_source": "response_body",
"maximum_units": 10000000,
"unit": "provider_credit",
"unit_rate_usd": 1e-06
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
Usage-based billing; Default request estimate: $0.00089 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.- Default request reference estimate (USD): 0.00089
- Declared unit rate (USD): 1e-06
- Billing unit: provider_credit
- Cost contract: response_units
- Published reference multiplier: 1.0
- Declared maximum count/units: 10000000
- Settlement evidence source: response_body
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Seed value for reproducible random data generation. Using the same seed value will always produce the same set of random users, which is useful for testing or creating consistent demo data.
Examples:
"my-test-seed-123"
"demo-data-v1"
Number of random user profiles to generate. Must be between 1 and 30. Default: 10
Required range:
1 <= x <= 30Examples:
1
5
10
Profile fields to include in the response. Only these fields are returned.
Available options:
id, username, password, email, uuid, locale, name, first_name, last_name, full_name, prefix, suffix, phone, cell, company_email, street_address, city, state, postal_code, country, address, latitude, longitude, timezone, dob, age, gender, job, company, ssn, credit_card, credit_card_provider, iban, ipv4, ipv6, mac_address, user_agent, url, domain, md5, sha1, sha256, picture, avatar Examples:
["first_name", "last_name", "email"]
["username", "phone"]
Gender filter for random user generation
Available options:
male, female, nonbinary, any Examples:
"male"
"female"
"nonbinary"
"any"
Locale for generating localized data such as names, addresses, and phone numbers. Use standard locale codes like 'en_US' (English - United States), 'de_DE' (German - Germany), 'fr_FR' (French - France), 'es_ES' (Spanish - Spain), etc. Default: 'en_US'
Examples:
"en_US"
"de_DE"
"fr_FR"
"es_ES"
Profile fields to exclude from the response. All other fields are returned.
Available options:
id, username, password, email, uuid, locale, name, first_name, last_name, full_name, prefix, suffix, phone, cell, company_email, street_address, city, state, postal_code, country, address, latitude, longitude, timezone, dob, age, gender, job, company, ssn, credit_card, credit_card_provider, iban, ipv4, ipv6, mac_address, user_agent, url, domain, md5, sha1, sha256, picture, avatar Examples:
["ssn", "credit_card", "iban"]
["password", "ipv4", "ipv6"]
Maximum age for generated users. Must be between 0 and 1000. Default: 100
Required range:
0 <= x <= 1000Examples:
50
65
100
Minimum age for generated users. Must be between 0 and 1000. Default: 0
Required range:
0 <= x <= 1000Examples:
18
25
30
Response
Tool result data