API FAQ
-
How do I test the respondent flow in staging without recruiting real participants?
You create a participant profile in staging via our profile creation endpoint. You can then invite that profile by following these steps:
- Log into the staging participant profile in one browser tab.
- In another tab (recommend opening in incognito), log into the researcher side.
- Open a published project and look for the Share button in the top-right corner.
- Copy the project link and switch back to the staging participant profile tab.
- Paste the link into the search bar of the staging participant profile. The staging participant should then be able to access the screener.
-
What is an externalResearcherId?
An externalResearcherId is a custom identifier that the API partner assigns to researchers when creating projects via our API.
-
What are some tips and tricks to maximise your integration?
autopay
is set totrue
. If set to false, it will require you to manually login onto our DIY platform to process payment.- Use the Retrieve Audience Size Estimate endpoint to test feasibility — it can be called multiple times as you adjust filters and signals.
- Use the Qualify Participant endpoint: For qualifying or disqualifying participants based on their screener responses—any disqualified participant will automatically be backfilled.
- Use the Mark As Rejected endpoint: For when the participant response to the study does not meet researcher’s criteria.
- Use the Report Participant endpoint: For flagging participants for inappropriate behavior. Reported participants won’t appear in future projects.
- Enable messaging with participants through our messaging flow to boost show and task completion rates.
- Enable the past participant database feature to unlock the ability to filter out participants who’ve taken part in previous studies, or to selectively re-invite high-quality (favorite) participants.
- When a project reaches 3x the target number of participants, it is automatically paused. To continue recruitment, simply unpause the project.
Updated 1 day ago