The API is the product, not an afterthought. Assessment, fact-check, detection, review, and export are all specified as endpoints with stable contracts.
Quick start
from mediameter import Client
client = Client(api_key="mm_test_...")
assessment = client.assessments.create(
url="https://example.org/story",
content_type="news_analysis",
dimensions=["accuracy", "evidence", "context"],
)
print(assessment.score, assessment.confidence)
for finding in assessment.findings:
print(finding.dimension, finding.evidence[0].quote)
import { MediaMeter } from "@mediameter/sdk";
const client = new MediaMeter({ apiKey: process.env.MM_API_KEY });
const assessment = await client.assessments.create({
url: "https://example.org/story",
contentType: "news_analysis",
dimensions: ["accuracy", "evidence", "context"],
});
console.log(assessment.score, assessment.confidence);
client, err := mediameter.NewClient(os.Getenv("MM_API_KEY"))
if err != nil {
log.Fatal(err)
}
assessment, err := client.Assessments.Create(ctx, &mediameter.AssessmentRequest{
URL: "https://example.org/story",
ContentType: "news_analysis",
Dimensions: []string{"accuracy", "evidence", "context"},
})
curl https://api.mediameter.eu/v1/assessments \
-H "Authorization: Bearer $MM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.org/story",
"content_type": "news_analysis",
"dimensions": ["accuracy", "evidence", "context"]
}'
Endpoint groups
34 endpoints across 11 groups are specified: assessments, claims, verdicts, detections, evidence, reviews, appeals, exports, webhooks, usage, and admin.
Authentication and limits
- Bearer API keys, scoped per environment and per capability.
- Idempotency keys on all write endpoints.
- Rate limits returned in standard headers; 429 responses include a retry-after value.
- Errors use a stable code, a human message, and a request ID for support.
SDKs
Python and TypeScript SDKs are specified for launch. Go is in development. All SDKs wrap the same OpenAPI contract, and the contract is versioned separately from model versions.
These examples describe the intended contract. There is no public API endpoint today, and no key will work. The specification is published so integrators can review it before build.