For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Go to app
DocumentationAPI Reference
DocumentationAPI Reference
  • API Reference
    • Introduction
    • Users
    • Taskflow
    • AI Task Builder
    • Studies
      • The study object
      • GETList all studies
      • POSTCreate a draft study
      • GETList all studies in a project
      • GETRetrieve a study
      • DELDelete a study
      • PATCHUpdate a study
      • POSTTransition a study's status
      • POSTCreate a test study
      • GETGet taskflow progress
      • GETShow Study cost
      • GETList study submissions
      • GETCount study submissions by status
      • GETDownload credential usage report
      • GETDownload demographic data
      • POSTExport demographic data
      • GETGet demographic export history
      • POSTDuplicate a study
      • GETShow Study predicted recruitment time
      • POSTShow Study predicted recruitment time
      • POSTCalculate the study cost
    • Representative sample studies
    • study-collections
    • Filter Sets
    • Participant Groups
    • Custom Groups
    • Study Distribution
    • Submissions
    • Bonuses
    • Messages
    • Workspaces
    • Projects
    • Surveys
    • Webhooks
    • Invitations
    • Reward Recommendations
    • Testing
    • Well Known Endpoints
Go to app
LogoLogo
API Reference

Studies

|View as Markdown|Open in Claude|
Was this page helpful?
Previous

Get Collection Export Status

Next

The study object

Important

The Studies API has rate limits in place to prevent researchers from launching too many studies with low numbers of participants. If your study URLs each represent a variant of the same task, with a specified number of participants accessing each variant, please consider using our Taskflow product, which is tailored for this and does not have a publishing limit.


Take me to the taskflow documentation

To recruit participants for your research, you create a draft study with your audience filters and cost and then publish the study to start recruiting. This is a two step process because publishing a study to participants requires many different and complex steps:

  • Checking if your account has sufficient balance to pay participants
  • Locking the amount required
  • Launching our algorithm to find the best suitable participants for you
  • Sending emails and more

By separating it into 2 steps, researchers can be confident that their study is created, no information is lost and it can be updated before publishing.

Quick guide to using Prolific

Study flow