API Documentation

Welcome to the prototypr.ai API docs. This documentation will provide you with all you need to start using the prototypr.ai API.

Quick Start

To begin using the prototypr.ai API, you first need to obtain an API key.

Here are the steps to generate an API Key:

  1. Login to prototypr.ai

  2. Click on the API icon to visit the /api-keys page

  3. Generate API key

screenshot of a generated prorotypr.ai api key experience

And your api key is created!

Please note that your key will only be shown to you once, so please copy it and store it in a safe place. If you lose your key, you can always re-generate a new one. Please note that any keys you generate are tied to your prototypr.ai account.

Make an API Request

Let's say you recently launched a research study and have collected a number of responses using prototypr.ai's AI Surveys tool. You want to export the raw data so that you can do a more thorough analysis. So the first thing you'll want to do is to pull a list of surveys you have running on prototypr.ai.

Example below using the python requests module:

import requests
import json
import os

url = "https://www.prototypr.ai/api/v1/research/list-surveys"

payload = {
    "user_id": "your_user_id",
    "workspace_id": "your_workspace_id",

headers = {
    "Authorization": "Bearer " + os.getenv("API_KEY"),
    "Content-Type": "application/json",
    "Accept": "application/json"

response = requests.post(url, data=json.dumps(payload), headers=headers)

To see more details related to this request, including the response object, please visit the /docs/api/research


The prototypr.ai API is currently under development and will enable several endpoints to interact with our services. Below are the main categories.

Rate Limits and API Usage Stats

Currently there are rate limits of 25/day across all API endpoints. This will grow over time as prototypr.ai adds more endpoints. If you need more, please feel free to connect with Gareth Cull, who is the creator of prototypr.ai.

As part of this API Service, prototypr.ai provides usage stats so that you can see how often your api key is being used.

API Feedback

Your feedback is critical for prototypr.ai to improve its products and services. Please consider taking this short 2-3 minute developer feedback survey about the prototypr.ai API.


Login to prototypr.ai, which will take you to /home. Click on the API link at the top of the page, which will take you to the /api-keys page. Scroll down to My Usage Stats and you will see your user_id.

Your workspace_id is available from the /home screen. Click on the 3 dot menu for your workspace, and this will bring up a Edit Workspace menu, where you can see your workspace_id.

Yes! Prototypr.ai is working on providing all of this information in-app. For example, let's say you want to update a specific forecast you created in Test Center. You can simply click to edit the forecast card, then click on the update forecast via API button. This will then show you all of the details you need to send a post request and update your card.