instructors

people

Educational instructor or teacher profile with expertise areas, course count, student enrollment, ratings, experience, and certifications. Used for online learning platforms, educational institutions, and training programs.

Request Builder

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

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

Endpoints

GET/instructors

Get a collection of instructors

Alternative: /people/instructors
GET/instructors/:id

Get a single instructor by ID

Alternative: /people/instructors/:id
GET/instructors/meta

Get resource metadata and schema

Alternative: /people/instructors/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/instructors?q=laptop

2. Search Specific Fields

Field-Specific Search
GET https://api.mockly.codes/instructors?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 instructors
fetch('https://api.mockly.codes/instructors?count=10')
  .then(res => res.json())
  .then(data => console.log(data));

Python

Fetch with Requests
import requests

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

cURL

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

Bypass Cache

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

Schema Properties

idinteger

Unique identifier for the instructor

Gen:random_int
namestring

Full name of the instructor

Gen:name
emailstring

Instructor's email address

Gen:emailemail
biostring

Instructor biography and background

Gen:paragraph
photostring

URL to the instructor's photo

Gen:avataruri
expertisearray

Array of subjects or topics the instructor teaches (e.g., Programming, Design, Business)

Gen:tags
courses_countinteger

Total number of courses taught by this instructor

Gen:random_int
students_countinteger

Total number of students enrolled in this instructor's courses

Gen:random_int
ratingnumber

Average student rating, typically on a scale of 1-5

Gen:float
years_experienceinteger

Number of years of teaching or professional experience

Gen:random_int
certificationsarray

Array of professional certifications or qualifications

Gen:tags

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