Fake Profile API Documentation

The Fake Profile API allows you to generate realistic user data for testing, development, and design mockups — without using real personal information. Data is returned in JSON format and supports filters.

Base URL
https://www.codencape.com/api/fake-user
HTTP Method
POST (required)
Request Parameters
ParameterTypeRequiredDescription
countintNoNumber of profiles (1–20). Default: 1
countrystringNoFilter by country
genderstringNoFilter by male or female
Request Examples
cURL
curl -X POST https://www.codencape.com/api/fake-user \
     -H "Content-Type: application/json" \
     -d '{"count":10,"country":"India","gender":"female"}'
JavaScript (Fetch)
fetch("https://www.codencape.com/api/fake-user", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ count: 5, gender: "male", country: "India" })
})
.then(res => res.json())
.then(data => console.log(data));
Example Respons
{
  "status": "success",
  "data": [
    {
      "full_name": "Aarav Sharma",
      "gender": "Male",
      "email": "aarav.sharma@example.com",
      "phone": "+91-9876543210",
      "address": "45 MG Road",
      "city": "Mumbai",
      "state": "Maharashtra",
      "postcode": "400001",
      "country": "India"
    }
  ]
}
Error Responses
405 Method Not Allowed
{
  "status": "error",
  "message": "The GET method is not supported. Use POST instead."
}
429 Too Many Requests
{
  "status": "error",
  "message": "Too many requests. Please try again after some time.",
  "retry_after": 60
}
422 Invalid Parameters
{
  "status": "error",
  "message": "Invalid count value. Maximum allowed is 20."
}
Rate Limiting

5 requests per 3 minutes per IP. If exceeded, you will receive a 429 Too Many Requests response.

Disclaimer
This API is provided free for developers. Generated data is for testing and educational purposes only. Do not use for production signups or real users.

Join the CodEncape Community

We believe in sharing, learning, and building together. Follow us on social media and share your feedback, suggestions, or your own work!

Subscribe to our newsletter

Stay up-to-date about latest tech and new world. Unsubscribe at anytime!