Primary Article
primaryArticle
Optional
On the summary record: the single best substantial/comprehensive result { title, articleUrl, score }, or null.
Wikipedia Research Intelligence — Topic Maps & Research Briefs
Pricing
from $1.00 / 1,000 article fetcheds
Turn a Wikipedia query into structured topic understanding: the primary concept, what matters, what to read first, the people and organizations around it, and the gaps. Returns a deterministic research brief, topic map, and scored, classified results across 15 languages.
Pricing
from $1.00 / 1,000 article fetcheds
Rating
0.0
(0)
Developer
Ryan Clinton
Maintained by CommunityActor stats
0
Bookmarked
8
Total users
2
Monthly active users
11 days ago
Last modified
Categories
Share
Record Type
recordType
Optional
Discriminator. One of: article, summary, topic-map, research-brief, warning, error. Stable enum — values are additive within a major version.
Schema Version
schemaVersion
Optional
Output shape version (semver). Consumers branch on shape changes.
Title
title
Optional
Article title
Page ID
pageId
Optional
Wikipedia page ID
Recommendation
recommendation
Optional
Routing decision for this result. One of: recommended (a substantial/comprehensive high-quality match), reference (navigation aid, supporting result, or disambiguation/list page), skip (low priority). Stable enum.
Quality Score
score
Optional
Composite quality + relevance score, 0-100. Blends search relevance rank, article depth, page structure, edit recency, and metadata completeness.
Score Tier
scoreTier
Optional
Banded score. One of: excellent (>=75), good (>=55), fair (>=35), poor (<35). Stable enum.
Topic Role
topicRole
Optional
Human-facing role of this result relative to the query. One of: core (the concept itself), supporting (strongly related), adjacent (context), peripheral (tangential). Stable enum.
Importance
importance
Optional
Topic-centrality score, 0-100 — how central this result is to the queried topic (relevance, primacy, connectivity). Distinct from score (article quality): a core stub is high importance, low score.
Importance Factors
importanceFactors
Optional
Breakdown of the importance score into its contributing points: { searchRelevance, primacy, connectivity, recommendationFit }.
Why
why
Optional
Plain-English reasons this result landed at its role/rank, assembled from the computed signals (relevance, depth, primacy, quality, freshness, entity type).
Article Type
articleType
Optional
Classified article kind. One of: disambiguation, list, stub (<500 words), substantial, comprehensive (>=8000 words). Stable enum.
Entity Type
entityType
Optional
Semantic type from Wikidata 'instance of' (P31), e.g. 'business', 'film', 'human', 'academic discipline'. Null when no Wikidata link.
Entity Type ID
entityTypeId
Optional
Wikidata QID of the entity type (P31 target).
Is Primary Concept
isPrimaryConcept
Optional
True when this is the top-ranked substantive page for the query (not a disambiguation or list page) — i.e. the canonical article for what was searched.
Categories
categories
Optional
Visible Wikipedia categories for the article (maintenance/hidden categories excluded).
Category Count
categoryCount
Optional
Number of visible categories.
Description
description
Optional
Short article description from Wikidata (requires summaries)
Summary Extract
extract
Optional
Article summary text (requires summaries)
Snippet
snippet
Optional
Search result snippet, HTML stripped
One-line Summary
summary
Optional
Plain-English, LLM-quotable summary of the article and its recommendation (<=280 chars).
Word Count
wordCount
Optional
Article word count
Size (bytes)
sizeBytes
Optional
Article wiki-markup size in bytes
Relevance Rank
relevanceRank
Optional
0-based position in Wikipedia's relevance-ranked search results.
Days Since Edit
recencyDays
Optional
Days since the article's last edit.
Freshness
freshness
Optional
Editorial freshness. One of: fresh (<=30d), recent (<=180d), aging (<=730d), stale, unknown. Stable enum.
Last Updated
timestamp
Optional
ISO 8601 timestamp of the article's last edit
Confidence
confidence
Optional
Score confidence: { score 0-1, level (high/medium/low/very-low), components[] }. Confidence drops when summaries are disabled (metadata signal unavailable). Present in the 'full' output profile.
Wikidata ID
wikidataId
Optional
Wikidata item ID for cross-language linking (requires summaries)
Article URL
articleUrl
Optional
Canonical URL to the article
Thumbnail
thumbnailUrl
Optional
Lead thumbnail image URL (requires summaries)
Primary Article
primaryArticle
Optional
On the summary record: the single best substantial/comprehensive result { title, articleUrl, score }, or null.
Coverage
coverage
Optional
On the summary record: { requested, returned, totalAvailable }.
Search Intent
intent
Optional
On the summary record: the scoring lens used (general/research/recent/overview).
Canonical Topic
topic
Optional
On the summary and research-brief records: the resolved entity the query refers to { canonicalName, entityType } — entity-first, not query-first.
Suggested Queries
suggestedQueries
Optional
On the research-brief record: nearby concepts to search next, derived from the topic neighborhood and categories (no LLM).
Reading Order
readingOrder
Optional
On the summary record: ranked 'read these in this order' list (recommended above reference, then by score), each { rank, title, articleUrl, score, recommendation }.
Language Coverage
languageCoverage
Optional
On the summary record: per-language total-hit counts when compareLanguages is set (each { language, totalHits }); null otherwise.
Coverage Score
coverageScore
Optional
On the summary record: 0-100 share of compared languages that returned any results; null when no comparison requested.
Content Gap
contentGap
Optional
On the summary record: SEO topic-depth view { avgWordCount, deepestSubtopics[], underdevelopedSubtopics[] } — which subtopics Wikipedia covers deeply vs thinly.
Core Concepts
coreConcepts
Optional
On the topic-map record: the central concepts for the query.
People
people
Optional
On the topic-map record: people connected to the topic (Wikidata instance-of human).
Organizations
organizations
Optional
On the topic-map record: organizations connected to the topic.
Events
events
Optional
On the topic-map record: events connected to the topic (wars, elections, conferences, etc.).
Topic Composition
composition
Optional
On the topic-map record: the structural make-up of the topic { concepts, people, organizations, relatedFields, events } as counts.
Learning Path
learningPath
Optional
On the research-brief record: an ordered way into the topic { startHere, nextRead, deeperDives, experts, organizations }.
Primary Concept
primaryConcept
Optional
On the research-brief record: the single best starting article { title, articleUrl, score, entityType }.
Executive Summary
executiveSummary
Optional
On the research-brief record: a plain-English 5-minute-understanding paragraph, assembled deterministically (no LLM).
What Matters
whatMatters
Optional
On the research-brief record: the top results by importance — the articles that matter most for the topic.
Key People
keyPeople
Optional
On the research-brief record: people connected to the topic.
Key Organizations
keyOrganizations
Optional
On the research-brief record: organizations connected to the topic.
Gaps
gaps
Optional
On the research-brief record: thinly-covered subtopics worth deeper exploration.
Extracted At
extractedAt
Optional
ISO 8601 timestamp of extraction