Coming Soon

API Documentation

Programmatic access to all published PIIR datasets. Free for non-commercial use, with premium tiers for enterprise integration.

Planned API Endpoints

The PIIR API will provide RESTful access to all published research data. These endpoints represent our planned initial release.

GET/api/v1/indicators

List all available indicators with metadata, descriptions, and available time periods.

GET/api/v1/indicators/{id}/data

Retrieve time-series data for a specific indicator. Supports filters for region, wave, and demographic breakdowns.

GET/api/v1/waves

List all published survey waves with field dates, sample sizes, and available modules.

GET/api/v1/waves/{id}/results

Retrieve complete results for a specific wave, including all core module and deep-dive module data.

GET/api/v1/regions

List all 17 Philippine regions with demographic profiles and available data coverage.

GET/api/v1/regions/{id}/indicators

Retrieve all indicator values for a specific region, with time-series data across waves.

GET/api/v1/downloads/{wave_id}

Download complete datasets for a wave in CSV, JSON, Stata, or R format.

Response Format

{
  "indicator": {
    "id": "trust_president",
    "name": "Trust in the President",
    "pillar": "trust_governance",
    "module": "core",
    "scale": "percentage",
    "description": "Percentage of respondents expressing trust..."
  },
  "data": [
    {
      "wave": "2026-Q1",
      "field_dates": "2026-01-15 to 2026-02-15",
      "national": 0.00,
      "regions": {
        "NCR": 0.00,
        "CAR": 0.00,
        "Region_I": 0.00
      },
      "demographics": {
        "age_18_24": 0.00,
        "age_25_34": 0.00,
        "male": 0.00,
        "female": 0.00
      },
      "margin_of_error": 0.03,
      "confidence_level": 0.95,
      "sample_size": 1200
    }
  ],
  "metadata": {
    "last_updated": "2026-04-01T00:00:00Z",
    "methodology_url": "https://piir.ph/methodology",
    "license": "CC BY 4.0"
  }
}

Access Tiers

Open Access

Free

-All published indicator data
-Dataset downloads (CSV, JSON)
-1,000 API requests/day
-CC BY 4.0 license

Researcher

Free (verified academics)

-Everything in Open Access
-Full microdata access (Stata, R)
-10,000 API requests/day
-Priority support

Enterprise

Custom pricing

-Everything in Researcher
-Custom data cuts and analysis
-Unlimited API requests
-Early access to data (pre-publication)