R4I API Documentation

Research4Insights (R4I) is a global market research and survey management platform enabling clients and partners to connect through intelligent data exchange APIs.

Our platform simplifies survey execution, respondent delivery, and real-time project tracking through seamless API-based integrations.

About R4I

R4I specializes in delivering reliable insights through data-driven survey solutions. We empower market research companies, consultancies, and data providers by enabling seamless API-based integrations for managing and sharing research respondents and studies worldwide.

This documentation provides details for two main API categories:

Demand API

CLIENT

For organizations running research projects or surveys on R4I's infrastructure.

Supply API

PARTNER

For vendors or panel providers delivering respondents and reporting survey statuses.

Authentication

Secure your API requests with Bearer token authentication

Every API request must include a secret API key in the Authorization header. Keys are provided after successful onboarding and verification.

Header Format

Authorization: Bearer R4I_TEST_xxxxxxxxxxxxxxxx
Demand API Key Format
R4I_TEST_JH934JUURBH9845FE33
Supply API Key Format
R4I_LIVE_42MSJY7855TYVSKG67Y66AS

Base URLs

Use the appropriate base URL for your environment

Demand API

SANDBOX https://api.research4insights.com/demand/sandbox/v1/
PRODUCTION https://api.research4insights.com/demand/production/v1/

Supply API

SANDBOX https://api.research4insights.com/sandbox/v1/
PRODUCTION https://api.research4insights.com/production/v1/

Demand API

For organizations running research projects or surveys on R4I's infrastructure

Overview

The Demand API enables research teams to create, manage, and monitor survey projects. It provides endpoints to create studies, manage quotas, and track response statuses in real time.

Key Features

  • Create and manage survey projects
  • Set and monitor survey quotas
  • Track response status in real-time
  • Access comprehensive reporting
  • Manage respondent data securely

Onboarding Process

Get started with the Demand API

Quick Start

Follow these steps to begin using the Demand API for your research projects.

  1. Submit Interest - Contact us via the form below or email
  2. Verification - R4I shares a pre-access form for verification
  3. Provide Details - Submit required business and study information
  4. Sandbox Access - Receive sandbox credentials for testing
  5. Production Access - Get production credentials after validation

Required Information

  • Company Name
  • Contact Name
  • Email Address
  • Phone Number
  • Study Type / Category
  • Company Size
  • Country
  • Reporting Contact
View Full Demand API Documentation

Supply API

For vendors or panel providers delivering respondents to R4I surveys

Overview

The Supply API is designed for panel partners or vendors delivering respondents to R4I surveys. It supports redirect tracking for completes, terminations, and quota full outcomes.

Key Features

  • Access allocated survey inventory
  • Generate survey links for respondents
  • Track completion and termination status
  • Real-time reporting and statistics
  • Secure redirect URL management

Onboarding Process

Become an R4I partner and integrate with our Supply API

Partner Integration

Follow these steps to integrate your panel with R4I's Supply API.

  1. Partnership Request - Submit partnership request to R4I
  2. Verification - Complete pre-access and redirect verification form
  3. Provide Details - Submit company and redirect information
  4. Sandbox Testing - Receive sandbox credentials for integration testing
  5. Validation - Complete integration and validation phase
  6. Production Access - Get production access after approval

Required Information

  • Company Name
  • Contact Person
  • Email
  • Phone Number
  • Redirect URLs:
    • Complete URL
    • Terminate URL
    • Quota Full URL

Redirect URL Format

https://vendor.com/redirects?status={status}&pid={pid}&uid={uid}&hmac=xxxx

Status values: complete, terminate, quotafull, security

View Full Supply API Documentation

Contact & Support

Get help with API integration and troubleshooting

For API access, partnership inquiries, or technical support, our team is here to help:

General Inquiries

Email: api@research4insights.com

Website: research4insights.com

Technical Support

For technical issues or API integration questions, please include:

  • Your API key (first 8 characters)
  • Endpoint you're trying to access
  • Error message or response