IPIP Research API
Prototype / roadmap

Research without unnecessary barriers

Better assessment.
Open to the world.

Our goal: make rigorous psychological assessment and experimental psychometric research freely accessible worldwide—while preserving scientific integrity, participant privacy, and reproducibility.

Important: This page describes an in-development research platform. A developer-only researcher workspace is included in this build; it needs authorized server credentials and is not yet an open public service.

Designed for researchers

Six ways to advance research

A free platform for universities, psychologists, independent researchers, educators, and developers to create, administer, score, compare, and share assessments—with a usable web interface as well as an API.

Create tests

Author questions, import questionnaires, select appropriate IPIP items, define response scales, and build clearly named constructs.

Tune scoring

Experiment with item weights, reverse-keyed answers, missing-data rules, subscales, thresholds, and alternative algorithms.

Run studies

Compare scoring methods, test hypotheses, estimate measurement quality, and examine item behavior using authorized research data.

Invite participants

Share an assessment link, use an accessible questionnaire, embed a study, or integrate sessions with the API.

Analyze findings

Calculate appropriate statistics, compare populations responsibly, and export data that researchers are authorized to access.

Publish & collaborate

Share instruments with author credit, publish scoring configurations, and enable independent replication and peer review.

The six capabilities above describe the planned researcher platform. They are not currently implemented by the PHP scoring prototype.

Watch · Listen · Read

Research concepts, explained clearly

Choose a narrated video lecture, audio-only explanation, or the complete written transcript. The completed 98-second lecture below explains reference scoring and researcher scoring; it is an illustrated demo, not footage of a university student.

Two ways to score a questionnaire

Reference scoring follows a documented procedure. Research scoring explores new hypotheses and formulas. Both can serve science when their methods and limitations are accurately described.

This narrated 98-second demonstration uses animated slides and a synthetic voice, not a model-released actor. An optional photo-based presenter version is storyboarded separately and requires licensing and consent before generation.

Methods you can trust and inspect

Reference scoring and research scoring

We will keep published reference procedures separate from experimental variants. Researchers can explore new scoring methods without silently changing established instruments or past results.

Reference scoringExperimental research scoring
Preserves documented source keysPermits investigator-defined weights and formulas
Uses a specified version of an established instrumentSupports newly authored or shortened instruments
Reports published evidence and limitationsLabels changes and validation status prominently
Reproducible reference scoring proceduresVersioned experiment configurations and comparisons
Uses reference norms only where justifiedAllows appropriate study-specific reference groups
Every instrument version and scoring configuration should be immutable. Science must be reproducible—even when the scoring improves.

A new algorithm can be computed precisely without being scientifically validated. Results must say which is which.

Independent evidence matters

Scientific integrity is part of the product

Our long-term goal is to support careful psychometric work, not to convert personality scores into unsupported judgments about a person.

  • Preserve exact source wording, item IDs, scoring direction, provenance and version histories.
  • Separate measurement reliability, construct validity, and demonstrated real-world dependability.
  • Estimate internal consistency and other relevant statistics only when data are sufficient, and report uncertainty and assumptions.
  • Never assume a custom subset, weighting change or translation inherits the original instrument's validation.
  • Use reference percentiles only with suitable samples and a clear explanation of applicability.
  • Support investigator review, replication and correction instead of silently overwriting prior findings.
  • Do not turn a personality score alone into an automatic employment, contributor, or moderator acceptance/rejection decision.

People before datasets

Consent, privacy and responsible access

The core scoring service is designed to score explicitly consented responses without persisting participant identifiers or raw answers. Any future researcher workspace that retains study responses must operate under separate, clearly disclosed data-handling policies.

  • Obtain informed, purpose-specific consent before collecting assessment answers.
  • Keep organizations, studies and investigators isolated by authorization boundaries.
  • Minimize personal information and provide retention, access, export and deletion controls.
  • Publish submitted instruments only when their authors can authorize sharing; keep private instruments private.
  • Use documented security reviews, HTTPS, server-side credentials, safe rate limits, and redacted logs before Internet release.
  • Make participation voluntary. Ordinary RFC-AI community reading and contribution must never require a hidden assessment.

Privacy features and legal compliance must be verified before launch in each jurisdiction; this documentation is not a claim of regulatory certification.

Build with it

API reference & planned expansion

The existing standalone PHP prototype defines the following routes. They are not claimed to be publicly reachable at this time.

Prototype endpointPurpose
GET /healthzPrototype health response
GET /v1/instrumentsList available instruments
GET /v1/instruments/ipip-hh-40Retrieve the preliminary 40-item instrument
POST /v1/scoresConsent-checked scoring via server-side bearer token

The wider research platform is proposed to add study and participant sessions, private instrument submission, scoring-model versions, statistical analyses, and authorized exports. These proposed routes are not part of the current published API contract.

POST /v1/instruments       # proposed: submit a test
POST /v1/studies           # proposed: create a study
POST /v1/sessions          # proposed: start a session
POST /v1/responses         # proposed: submit responses
POST /v1/scoring-models    # proposed: version a model
POST /v1/analyses          # proposed: compare models

For scoring integration, the bearer token belongs on the calling server and must never be embedded in page JavaScript. No personal information should be put into URLs or screenshots.

Open research community

Built to be useful beyond Peostectica

Researchers should be able to publish their instruments, describe the intended population, explain scoring methods, provide evidence, compare versions and invite replication. The goal is a widely accessible tool—not an official endorsement of any particular research finding.

We plan to introduce the service to university researchers, open-science communities, and maintainers of relevant IPIP resources after the reference scoring, privacy safeguards, and real deployment have been independently verified.

Make rigorous psychological assessment and experimental psychometric research freely accessible worldwide, while preserving scientific integrity, participant privacy, and reproducibility.

IPIP stands for International Personality Item Pool. This is an independent Peostectica project, not an official IPIP, university, or professional-association service or endorsement.

Transparent development

What exists and what's next

Verified project documentation: a standalone PHP prototype, a preliminary 40-item IPIP Honesty–Humility-related instrument, a versioned REST contract, and local tests have been documented. The intended domain is ipip-api.peostectica.com.

Not yet verified as deployed: publicly accessible HTTPS service, production authentication and rate limiting, end-to-end privacy and security controls, and the expanded researcher platform described above.

Researcher roadmap: full IPIP-NEO-300 support; researcher-authored tests; independently versioned scoring configurations; consent-based study sessions; accessible and optional read-aloud questionnaires; analysis and reproducible exports; internationalization and translation workflows.

We will not claim that planned features work until they are implemented and tested. Product updates will identify changes by version and release status.