profiles

people

User profile with biography, avatar, website, location, occupation, interests, social links, verification status, and follower statistics. Used for social media platforms, professional networks, and user profile systems.

Request Builder

https://api.mockly.codes/profiles?page=1&limit=10&count=10

Configure your request and click Send Request to see the response here.

Endpoints

GET/profiles

Get a collection of profiles

Alternative: /people/profiles
GET/profiles/:id

Get a single profile by ID

Alternative: /people/profiles/:id
GET/profiles/meta

Get resource metadata and schema

Alternative: /people/profiles/meta

How to Use Search

The search feature allows you to filter results by searching for text across all or specific fields. Choose between ?q= or ?search= parameter names.

1. Basic Search

Search across all text fields:

Basic Search
GET https://api.mockly.codes/profiles?q=laptop

2. Search Specific Fields

Field-Specific Search
GET https://api.mockly.codes/profiles?q=laptop&search_fields=name,description

Pro Tips

  • •Search is case-insensitive and performs partial matching
  • •Without search_fields, all text fields are searched
  • •Combine with pagination to handle large result sets efficiently

Code Examples

JavaScript

Fetch Collection
// Get 10 profiles
fetch('https://api.mockly.codes/profiles?count=10')
  .then(res => res.json())
  .then(data => console.log(data));

Python

Fetch with Requests
import requests

response = requests.get(
    'https://api.mockly.codes/profiles?count=10'
)
data = response.json()

cURL

Command Line
curl "https://api.mockly.codes/profiles?count=10"

Bypass Cache

Get Fresh Data
fetch('https://api.mockly.codes/profiles?nocache=true')

Schema Properties

idinteger

Unique identifier for the profile

Gen:random_int
user_idinteger

Foreign key reference to the user this profile belongs to

Gen:random_int
biostring

User biography or about section

Gen:paragraph
avatarstring

URL to the user's profile picture or avatar

Gen:avataruri
websitestring

User's personal website URL

Gen:urluri
locationstring

User's location (city or region)

Gen:city
occupationstring

User's job title or profession

Gen:job
interestsarray

Array of user interests or hobbies

Gen:tags
social_linksobject

Object containing links to social media profiles (e.g., twitter, linkedin, github)

Gen:object
is_verifiedboolean

Whether the profile is verified as authentic

Gen:boolean
followers_countinteger

Total number of users following this profile

Gen:random_int
following_countinteger

Total number of users this profile is following

Gen:random_int

Query Parameters

countinteger

Number of items to return (default: 10, max: 100)

seedinteger

Seed for reproducible data generation

nocacheboolean

Bypass cache and generate fresh data on every request