Ask A Human
Ask real humans anything. Create surveys, launch studies, and get authentic human feedback through Prolific's research platform. Features: - Create surveys with multiple choice questions - Launch studies to targeted participant pools - Filter participants by demographics, device usage, employment status, and 100+ attributes - Get real responses from verified human participants - Track…
18 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Ask A Human endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
getSurvey /surveys/{survey_id} |
|
| GET |
listHeaders /headers |
Reads incoming request headers; returns each header name and the last 3 characters of its value only. |
| POST |
createSurvey /surveys |
|
| GET |
listSurveyResponses /surveys/{survey_id}/responses |
Get survey responses (participant answers). Pagination: offset (default 0), limit (default 100, max 1000). |
| GET |
health /health |
|
| GET |
searchFilters /filters/search |
|
| GET |
exampleFilters /example-filters |
|
| GET |
getSurveyResponsesSummary /surveys/{survey_id}/responses/summary |
Get summary of survey responses. |
| PATCH |
updateStudy /studies/{study_id} |
Update a draft study. Send only the fields you want to change. Use total_reward_cents (budget in cents). Filters: use filter_id with selected_range (lower/upper) or… |
| GET |
listFilters /filters |
|
| POST |
publishStudy /studies/{study_id}/publish |
Transition study status to PUBLISH so participants can see and take the study. Requires a study id from create study linked. Publish is disabled by default; returns 403 unless… |
| POST |
createStudyLinked /studies/linked |
Either pass survey_id (existing survey) OR researcher_id + title + questions (exactly 5). When questions are provided, the survey is created under the hood, then the study is… |
| GET |
getStudyLinks /studies/{study_id}/links |
Returns study_id, web_url (valid link to open study in Prolific app, no placeholders), api_url, and external_study_url (participant survey template). |
| GET |
listStudies /studies |
List all studies. Optional: state (ACTIVE, UNPUBLISHED, COMPLETED, AWAITING REVIEW), page. |
| GET |
listStudySubmissions /studies/{study_id}/submissions |
List study submissions (participant completions). Returns Prolific response with results array. |
| GET |
about /about |
Returns purpose, usage steps, and instructions for AI: use List_filters/Search_filters when choosing participants; ask user for budget before creating a study. |
| GET |
getUser /users/me |
|
| GET |
getStudy /studies/{study_id} |
Return full study object from Prolific (name, description, reward, state, filters, etc.). |
