Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.respondent.io/llms.txt

Use this file to discover all available pages before exploring further.

Respondent’s API gives your development team the tools to deliver seamless, high-quality participant recruitment—right from your own platform. By integrating our API, you can give your researchers access to Respondent’s deeply profiled, highly qualified participant pool without ever leaving your environment.

Create projects

Set up research projects and screeners programmatically with full targeting control.

Manage participants

Retrieve profiles, qualify, invite, and track participant status in real-time.

Send messages

Communicate with participants throughout the study lifecycle via the messaging API.

Monitor via webhooks

Receive real-time notifications for participant status changes and project events.
Your developers can integrate these endpoints to build custom UI for project creation and participant management and embed Respondent workflows directly into your platform. Whether you’re building new tools or enhancing existing ones, the Respondent API enables you to streamline study setup and deliver exceptional participant experiences. To begin, you’ll need a Client ID and Client Secret. Visit our Quickstart Guide to learn the steps to receiving credentials and start integrating.

​
Authentication

All API requests require two headers: x-api-key (your Client ID) and x-api-secret (your Client Secret). 
curl --request GET \
  --url 'https://api-staging.respondent.io/v1/skills?query=comp' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-api-secret: YOUR_API_SECRET'

​
Base URLs

EnvironmentBase URL
Staginghttps://api-staging.respondent.io
Productionhttps://api.respondent.io
Build and test your integration in staging first, then switch to production when ready. See Staging vs Production for important differences.

​
Rate limiting

To ensure stability and fair usage across clients, our API enforces the following rate limits:
EnvironmentRequests per SecondBurst CapacityDaily Quota
Production250 RPS500 requests1,000,000 requests/day
Staging50 RPS100 requests200,000 requests/day