Credibility API

Access explainable, behavior-based credibility scores programmatically. Free tier available for non-commercial use.

API Overview
REST
JSON responses
Free
Public endpoints
v1.23
Stable & versioned

Base URL: https://athena-backend-api-872259245712.us-central1.run.app/api/v1

Authentication: Include your API key as a request header:

X-API-Key: YOUR_API_KEY

Unauthenticated requests are limited to 5 results per endpoint. Authenticated requests unlock full result sets. Rate limit: 600 requests/minute.

Quickstart

No API key required for public access. Add X-API-Key for full result sets.

1. List tracked entities
curl 'https://athena-backend-api-872259245712.us-central1.run.app/api/v1/entities/?limit=10' \
  -H 'Accept: application/json' \
  -H 'X-API-Key: YOUR_API_KEY'
2. Get a credibility score (use id from step 1)
curl 'https://athena-backend-api-872259245712.us-central1.run.app/api/v1/credibility/f4fb2208-d473-40aa-8853-4c572810ddaa' \
  -H 'Accept: application/json' \
  -H 'X-API-Key: YOUR_API_KEY'
← Real Vision Finance (live example UUID)
List InfluencersGET
GET /influencers/?limit=50&offset=0

Returns all tracked influencers with their current scores. Use the id field as influencer_id in other endpoints.

Response (truncated)

[
  {
    "id": "f4fb2208-d473-40aa-8853-4c572810ddaa",
    "display_name": "Real Vision",
    "slug": "RealVisionFinance",
    "credibility_score": 82.0,
    "influence_score": 74.1,
    "composite_score": 86.0,
    "total_predictions": 342,
    "evaluated_predictions": 283,
    "follower_count": 92200
  },
  ...
]
Get Credibility ScoreGET
GET /credibility/{influencer_id}

curl example

curl 'https://athena-backend-api-872259245712.us-central1.run.app/api/v1/credibility/f4fb2208-d473-40aa-8853-4c572810ddaa'

Live response — Real Vision Finance

{
  "overall_score": 70.4,
  "confidence": "high",
  "confidence_reason": "Based on 283 evaluated claims and 78 behavioral signals over multiple market cycles",
  "pillars": {
    "outcome_alignment": 0.449,
    "calibration": 0.163,
    "consistency": 0.502,
    "specificity_quality": 0.647,
    "transparency": 0.932,
    "accountability": 0.839
  },
  "top_positive_drivers": [
    "Strong: How often claims are backed by external sources",
    "Strong: Presence of sponsorship and paid promotion disclosures"
  ],
  "top_negative_drivers": [
    "Weak: Overall prediction outcome quality across all metrics",
    "Weak: Percentage of predictions that include quantifiable targets"
  ],
  "badges": ["Discloses Conflicts Consistently", "Admits & Corrects Errors"],
  "sample_size": 283,
  "window": "all_time",
  "score_version": "v1.23.0",
  "computed_at": "2026-05-05T00:00:00Z"
}

Fields

overall_score0–100 scale. Weighted composite of 6 behavioral pillars.
confidencehigh (50+ evaluated claims), medium (20–49), low (5–19), minimal (<5)
pillars6 behavioral pillars, each 0–1. Weights: outcome_alignment 22%, specificity_quality 20%, consistency 15%, transparency 15%, accountability 15%, calibration 13%
badgesEarned through sustained behavior, not self-reported
Get Score HistoryGET
GET /credibility/{influencer_id} /history?limit=30

Query Parameters

limitNumber of historical scores to return (1-100, default: 10)

Response

{
  "influencer_id": "45746897-1534-4106-a204-4d894d4f669e",
  "influencer_name": "99Bitcoins",
  "scores": [
    {
      "overall_score": 0.659,
      "confidence": "HIGH",
      "sample_size": 4569,
      "computed_at": "2026-04-19T12:00:00Z"
    },
    {
      "overall_score": 0.651,
      "confidence": "HIGH",
      "sample_size": 4521,
      "computed_at": "2026-04-12T12:00:00Z"
    }
  ]
}

Use case: Visualize credibility trajectory over time. Shows consistency and makes gaming obvious.

Batch Score RetrievalGET
GET /credibility/batch?influencer_ids=<uuid1>,<uuid2>,<uuid3>

Query Parameters

influencer_idsComma-separated list of IDs (max 50 per request)

Response

{
  "scores": [
    { "influencer_id": "45746897-1534-4106-a204-4d894d4f669e", "overall_score": 0.766, ... },
    { "influencer_id": "8b3a1c92-7e44-4b1d-9c12-aa05f3e7d201", "overall_score": 0.659, ... },
    { "influencer_id": "f12d4a83-2c19-4a8e-bd64-9c1e5f0a7b32", "overall_score": 0.612, ... }
  ]
}

Canonical Claim Ledger API

v1.23+

The /entities/ and /claims/ prefixes are the forward-compatible canonical API surface. The legacy /influencers/ prefix remains available as an alias.

GET /entities/GET

List all tracked entities. Supports limit, offset, search, and sort_by (composite, credibility, name).

curl 'https://athena-backend-api-872259245712.us-central1.run.app/api/v1/entities/?limit=10' \
  -H 'X-API-Key: YOUR_API_KEY'
GET /entities/{slug}/scoreGET

Athena Index score for an entity — all_time window (the canonical score), plus 90d and 30d trajectory windows.

curl 'https://athena-backend-api-872259245712.us-central1.run.app/api/v1/entities/CoinBureau/score' \
  -H 'X-API-Key: YOUR_API_KEY'
{
  "entity_slug": "CoinBureau",
  "entity_name": "Coin Bureau",
  "athena_index": {
    "score": 74.2,
    "confidence": "high",
    "methodology_version": "v1.23.0",
    "last_updated_at": "2026-05-10T00:00:00Z"
  },
  "score_90d": { "score": 71.8, "confidence": "high", ... },
  "score_30d": { "score": 69.4, "confidence": "medium", ... }
}
GET /entities/{slug}/claimsGET

Source-linked claim ledger. Each claim includes asset, exact source URL, transcript snippet, and evaluation outcome. Unauthenticated requests capped at 5.

limit1–200
statuspending | hit | miss | partial
curl 'https://athena-backend-api-872259245712.us-central1.run.app/api/v1/entities/CoinBureau/claims?limit=5&status=hit' \
  -H 'X-API-Key: YOUR_API_KEY'
{
  "entity_slug": "CoinBureau",
  "methodology_version": "v1.23.0",
  "total": 412,
  "claims": [
    {
      "id": "9f3c...",
      "direction": "up",
      "target_price": 80000,
      "raw_text_snippet": "I think Bitcoin will reach 80k by the end of Q1...",
      "asset": { "symbol": "BTC", "name": "Bitcoin" },
      "source": { "url": "https://youtube.com/...", "published_at": "2025-01-14T00:00:00Z" },
      "evaluation": { "outcome": "miss", "outcome_score": 18.0, "evaluated_at": "2025-04-01T00:00:00Z" }
    }
  ]
}
GET /entities/{slug}/claims.csvCSV

Same data as the JSON claims endpoint, returned as a downloadable CSV with Content-Disposition: attachment. Same filters and result cap apply.

curl -O -J 'https://athena-backend-api-872259245712.us-central1.run.app/api/v1/entities/CoinBureau/claims.csv' \
  -H 'X-API-Key: YOUR_API_KEY'
# → saves as: athena-claims-CoinBureau.csv
GET /claims/{claim_id}GET

Single source-linked claim by UUID. Includes entity context, asset, source evidence, and evaluation outcome. Use for building permalinks to individual claims.

curl 'https://athena-backend-api-872259245712.us-central1.run.app/api/v1/claims/9f3c1a2b-...' \
  -H 'X-API-Key: YOUR_API_KEY'
{
  "id": "9f3c1a2b-...",
  "direction": "up",
  "target_price": 80000,
  "raw_text_snippet": "I think Bitcoin will reach 80k by the end of Q1...",
  "entity": { "slug": "CoinBureau", "name": "Coin Bureau" },
  "asset": { "symbol": "BTC", "name": "Bitcoin" },
  "source": { "url": "https://youtube.com/...", "published_at": "2025-01-14T00:00:00Z" },
  "evaluation": { "outcome": "miss", "outcome_score": 18.0, "evaluated_at": "2025-04-01T00:00:00Z" }
}
Use Cases

Research & Analysis

Academic research on influencer credibility, media studies, behavioral analysis

Integration

Embed credibility scores in portfolio trackers, trading platforms, social dashboards

Monitoring

Track credibility changes, set alerts, identify trends across influencer cohorts

Compliance

Due diligence for partnerships, sponsorship verification, risk assessment

Rate Limits & Terms

Public (unauthenticated)

  • 600 requests per minute
  • Results capped at 5 per endpoint
  • Read-only access to public scores

Authenticated (API key)

  • 600 requests per minute
  • Full result sets per tier
  • Header: X-API-Key: YOUR_API_KEY

Terms of Use

  • Attribution required: "Credibility scores powered by AthenaIndex.com"
  • No commercial use without written permission
  • No scraping or automated bulk downloads
  • Data provided "as-is" - see our methodology for limitations

Need higher limits or commercial access? Contact us at contact@athenaindex.com

Need commercial access or higher limits?

Batch endpoints, monitoring feeds, custom scoring windows, and white-label options are available for B2B partners.

Request B2B Access