Piloterr

Rate My Professors Search

GET
/v2/ratemyprofessors/search

Search Rate My Professors by name. Cards include school, department, difficulty, and would-take-again when the card shows them.

Credit cost: 2 credits per call

Authentification

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Paramètres de requête

query*string

Required. A professor name, or a Rate My Professors search URL whose path contains /search/professors or whose query contains q=.

Example:

smith

URL example:

https://www.ratemyprofessors.com/search/professors?q=smith
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Corps de la réponse

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/ratemyprofessors/search?query=string'
Example Response
{  "results": [    {      "id": "1064107",      "url": "https://www.ratemyprofessors.com/professor/1064107",      "name": "Kevin Smith",      "rating": 4.6,      "school": "Rio Hondo College",      "department": "Psychology",      "difficulty": 3.1,      "ratings_count": 174,      "would_take_again_percent": 94    }  ],  "pagination": {    "next": null,    "page": 1,    "per_page": 5,    "total_pages": null,    "total_results": 10000  }}