Read the record. Show it anywhere.

Quick start

Most integrations need only the first step. Reading a page record is open to everyone.

1. 1Read a recordCall the page record endpoint with any page URL, openly.
2. 2Show it on your pageAdd the embed script to a verified site. It reads the same record.
3. 3Automate requestsCreate a key in your dashboard to open requests and receive webhooks.

curl "https://api.citepep.com/v1/pages/record?url=\
 https://publisher.example/overthinking-and-rumination"

Authentication

Public records are open to read. Publisher actions need an API key from your dashboard, sent as a bearer token. Keys are scoped to your verified domains.

curl https://api.citepep.com/v1/requests \
 -H "Authorization: Bearer $CITEPEP_KEY"

Returns the public contribution history for a page: every accepted contribution, its role, contributor and date.

{
 "url": "https://publisher.example/overthinking-and-rumination",
 "status": "verified",
 "contributions": [
 { "role": "author", "name": "Contributor A",
 "accepted": "2024-03-03" },
 { "role": "correction", "name": "Contributor B",
 "accepted": "2026-07-12",
 "change": { "from": "the published rate", "to": "the current rate" } }
 ]
}

Returns the current version of an expert panel statement: the answer, certainty, vote, named panellists, revisit date and what would reopen it early. Open access.

{
 "id": "reef-shading-2026",
 "question": "Should publishers shade nurseries during the October heat alert?",
 "version": 1,
 "status": "issued",
 "answer": "Yes, for nurseries shallower than 3 m",
 "certainty": "low-moderate",
 "vote": { "agree": 6, "dissent": 1 },
 "panel": [{ "name": "Reviewer", "role": "chair", "vote": "agree" }, …],
 "issued_at": "2026-09-26T08:00:00Z",
 "revisit_by": "2026-10-26",
 "reopen_triggers": ["new_study", "source_corrected", "alert_extended"]
}

Returns a contributor’s public profile: scores, topic authority and accepted work. Private fields stay private.

{
 "id": "mc-sariyer",
 "name": "Contributor B",
 "contribution_score": 171,
 "trust_score": 0.96,
 "topics": [{ "topic": "baseline-rise", "authority": 84 }]
}

Opens a review or correction request for a page you have verified.

{
 "id": "req_8f21",
 "status": "open",
 "url": "https://yoursite.com/guide",
 "type": "review"
}

Webhooks

Register an HTTPS endpoint in your dashboard to be told when something changes on your pages. Each delivery is signed so you can check it came from CitePep.

Failed deliveries are retried for 24 hours with increasing delays. Verify the CitePep-Signature header with your endpoint secret.

{
 "event": "contribution.submitted",
 "created": "2026-09-21T10:14:02Z",
 "page": "https://publisher.example/regional-ice",
 "contribution": {
 "id": "ctb_41c9",
 "type": "correction",
 "contributor": "elena-marsh"
 }
}

Attribution block

Add one script tag to show the verified contribution history on any page of a verified site. It updates automatically as new work is accepted.

<script src="https://citepep.com/embed.js"
 data-page="auto" async></script>

The block shows only accepted work and keeps readers private.

Errors and limits

Errors return a JSON body with a machine-readable code and a sentence you can show a person.

Rate limits

{
 "error": {
 "code": "page_not_verified",
 "message": "whennotesfly.com is not a verified site on this account."
 }
}

Versions and changes

The version is in the path. Within /v1 we only add fields, so existing ones stay stable. Breaking changes get a new version and at least 12 months’ notice.