Superconductivity research

Discovery

Candidate hypotheses, their evidence, and access to research data.

Candidates

Source-computed hypotheses and research assessments. These are not probabilities of superconductivity or confirmed discoveries.

Source-computed candidate materials

Source Eliashberg Tc, μ* = 0.1. Experimental and room-temperature superconductivity are unknown.

Filters and ordering

103 / 103 materials · Showing 1 to 24 · Provisional groups

Download catalogue JSON
Scope, evidence and how to read this catalogue

These materials are research hypotheses based on published source calculations and source-selected comparisons. Tc belongs to the listed source state and model, not to every phase of a chemical composition. Method and sampling differences remain attached to each comparison.

The displayed value uses the source Eliashberg result at μ* = 0.1. It is not assigned to an individual Gaussian-smearing row. A source-computed transition does not establish an experimental transition or approximately 300 K superconductivity at ambient pressure.

All 103 materials currently remain C (exploratory) and E1 (published source theory). Evidence does not support a calibrated potential ranking within this group. For the source-response target, explicit alternative-control limitations form a review group after other exploratory cases. This is a research grouping, not a success probability. Formula resolves ties; Source Tc never sets priority. For the approximately 300 K target, all cases have no direct support and retain formula order.

The six-axis P support rubric has fixed weights for stability (20%), electronic response (20%), pairing (25%), coherence (15%), geometry (10%) and competition (10%). Source pairing has an uncalibrated ordinal anchor of 25 to 50 for its own research target. Other axes remain unknown (0 to 100); weights are not redistributed. Weighted quantified coverage is 25% for the source-response target and 0% for the 300 K target. These support ranges are not measured probabilities or confidence intervals. Provisional A/B policy cutoffs of 75/55 also require independent evidence and relevant coverage; legacy support 3/4 is not converted to P.

Formal RPS assessments require their own published research action, campaign and budget. They remain separate in Research & tools.

Concern tags highlight selected limitations; an absent tag does not establish absence of risk. Expand each material for its controls, competing explanations, source scope and a testable next action.

Inclusion does not claim a first discovery. Published computational proposals, previously studied compositions and distinct proposed phases retain their source context. Unrelaxed COD coordinate proposals are a separate research catalogue and are not counted here.

Source: Sampling the materials space for conventional superconducting compounds, Tiago F. T. Cerqueira, Antonio Sanna, Miguel A. L. Marques · Materials Cloud 2023.163 v1. CC BY 4.0. Source data: Tiago F. T. Cerqueira, Antonio Sanna and Miguel A. L. Marques, Sampling the materials space for conventional superconducting compounds, Materials Cloud 2023.163 v1, DOI 10.24435/materialscloud:qv-bq, CC BY 4.0. This catalogue is a derived projection with additional source-state screening commentary.

Common source and publication scope
{
  "dataset_source": {
    "title": "Sampling the materials space for conventional superconducting compounds",
    "version": "Materials Cloud 2023.163 v1",
    "authors": [
      "Tiago F. T. Cerqueira",
      "Antonio Sanna",
      "Miguel A. L. Marques"
    ],
    "url": "https://archive.materialscloud.org/records/3kbt5-r3n56",
    "doi": "10.24435/materialscloud:qv-bq",
    "license": "CC BY 4.0",
    "license_basis": "metadata.rights from primary record API",
    "license_url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "Source data: Tiago F. T. Cerqueira, Antonio Sanna and Miguel A. L. Marques, Sampling the materials space for conventional superconducting compounds, Materials Cloud 2023.163 v1, DOI 10.24435/materialscloud:qv-bq, CC BY 4.0. This catalogue is a derived projection with additional source-state screening commentary."
  },
  "scope": "Previously private source-model screening is now published as unscored source-computed material-design hypotheses. Historical private-screening wording is retained as context. These predictions are new to this reviewed catalogue only; experimental confirmation, worldwide first discovery, formal RPS and human scientific review are not claimed.",
  "counts": {
    "composition_groups": 103,
    "formal_RPS_scored": 0,
    "human_reviewed": 0,
    "experimental_confirmed": 0,
    "room_temperature_supported": 0
  }
}
Source-computed hypotheses in provisional research groups. Open details to inspect support, prior work and limitations.
MaterialResearch routeSource Tc (K)Support / evidenceKey concernsDetails
Be4AlReGeometry construction12.18C · E1ExploratoryFeasibility unresolved
Residual force / stress sensitivitySampling / method sensitivity
Be4ZrRhGeometry construction21.779C · E1ExploratoryFeasibility unresolved
Residual force / stress sensitivitySampling / method sensitivity
Cr2ReGeometry construction22.142C · E1ExploratoryFeasibility unresolved
Spin-model sensitivityPhase / ordering competition
Cr4NbReGeometry construction27.745C · E1ExploratoryFeasibility unresolved
Spin-model sensitivity
CrMoReGeometry construction18.902C · E1ExploratoryFeasibility unresolved
Spin-model sensitivityPhase / ordering competition
CrTcGeometry construction17.431C · E1ExploratoryFeasibility unresolved
Spin-model sensitivitySampling / method sensitivity+1 in details
Hf2TiZrGeometry construction17.029C · E1ExploratoryFeasibility unresolved
Phase / ordering competitionResidual force / stress sensitivity+1 in details
HfNbTaGeometry construction14.176C · E1ExploratoryFeasibility unresolved
Phase / ordering competitionResidual force / stress sensitivity+1 in details
HfTi3HGeometry construction22.108C · E1ExploratoryFeasibility unresolved
Hydrogen zero-point / anharmonic responsePhase / ordering competition+1 in details
HfTiZr2Geometry construction17.936C · E1ExploratoryFeasibility unresolved
Phase / ordering competitionResidual force / stress sensitivity+1 in details
LuTaN2Geometry construction15.539C · E1ExploratoryFeasibility unresolved
Phase / ordering competitionResidual force / stress sensitivity
MgIrH3Geometry construction11.862C · E1ExploratoryFeasibility unresolved
Hydrogen zero-point / anharmonic responsePhase / ordering competition+1 in details
Mn4NbMoGeometry construction19.063C · E1ExploratoryFeasibility unresolved
Spin-model sensitivityPhase / ordering competition
Mo2TcGeometry construction17.515C · E1ExploratoryFeasibility unresolved
Phase / ordering competitionResidual force / stress sensitivity+1 in details
MoTc2RuHGeometry construction15.603C · E1ExploratoryFeasibility unresolved
Hydrogen zero-point / anharmonic responsePhase / ordering competition+2 in details
MoTcRu2Geometry construction13.125C · E1ExploratoryFeasibility unresolved
Phase / ordering competitionSampling / method sensitivity+1 in details
MoTcWGeometry construction18.404C · E1ExploratoryFeasibility unresolved
Phase / ordering competitionResidual force / stress sensitivity+2 in details
NaAuH3Geometry construction23.838C · E1ExploratoryFeasibility unresolved
Hydrogen zero-point / anharmonic responsePhase / ordering competition
Nb2HfTaGeometry construction20.749C · E1ExploratoryFeasibility unresolved
Phase / ordering competition
NbMoTc2Geometry construction13.542C · E1ExploratoryFeasibility unresolved
Residual force / stress sensitivityTechnetium follow-up practicality
NbTa3Geometry construction12.871C · E1ExploratoryFeasibility unresolved
ScMoC2Geometry construction15.678C · E1ExploratoryFeasibility unresolved
Phase / ordering competitionResidual force / stress sensitivity+1 in details
ScZr3Geometry construction13.57C · E1ExploratoryFeasibility unresolved
Phase / ordering competitionResidual force / stress sensitivity+1 in details
Tc2RuRhGeometry construction14.632C · E1ExploratoryFeasibility unresolved
Residual force / stress sensitivitySampling / method sensitivity+1 in details

Data & methodology

Coverage, source attribution, display policies and scientific limitations.

Read data and methodology

Coverage and updates

SCLib indexes superconductivity literature and links material records to supporting publications. Source coverage, paper counts and data versions are reported in Library statistics. Coverage is not a claim to include every relevant publication.

Catalogued material counts describe stored library records. Public browsing applies visibility and source policies, so its total can differ. A statistics refresh is separate from the date of the latest indexed paper or ingestion run.

Read a property in context

Before comparing values, check the material identity, source, units, pressure and other reported conditions. Distinguish measurements from calculations or proposals. A missing condition is unknown, not automatically ambient pressure or experimental evidence.

Follow field-level provenance and linked publications where available. Multiple reports about the same material can describe different phases, conditions or methods.

AI-assisted retrieval and extraction

AI assists literature retrieval, question answering and extraction of structured data. It may miss context, confuse material identities or extract an incorrect value. Generated answers and extracted fields should be checked against the cited literature.

Public Tc display and discovery

Public Materials and timeline views display reported Tc up to and including 300 K. Assertions with a scalar or range endpoint above 300 K, or a strict lower bound of >300 K, receive the tc_above_300k display flag and are hidden from these views. Original assertions, evidence and archived downloads are retained. This display limit is not an independently certified ranking. Discovery separates scientific material information, published research-priority assessments and historical candidate leads. Historical heuristic scores are not new assessments or superconductivity probabilities.

Rights and corrections

Source publications retain their own rights and access conditions. Library visibility does not itself grant rights to redistribute full text or use it for model training. See the Terms and repository licensing for the applicable scope.

If you find an error, include the affected URL, field and supporting source in Feedback. See Join & contribute for other contribution options.

API reference

Authentication, endpoints, request formats and response examples.

Read API reference

Quick start

1. Get your API Key — go to Dashboard → API Keys and click + New key. Copy the scl_… value.

2. Pass it in the header — every request that needs authentication should include:

# cURL
curl https://api.jzis.org/sclib/v1/materials \
  -H "X-API-Key: scl_YOUR_KEY"
# Python
import requests

API = "https://api.jzis.org/sclib/v1"
headers = {"X-API-Key": "scl_YOUR_KEY"}

resp = requests.get(f"{API}/materials", headers=headers)
print(resp.json())

Authentication & quotas

IdentityAuth methodDaily quota
Guest (no key)None — rate-limited by IP3
Registered userX-API-Key: scl_…999
Browser sessionSecure HttpOnly session cookie999

API Key and JWT share the same daily quota per user. Quotas reset at 00:00 UTC. When the quota is exceeded the API returns 429 Too Many Requests.

Password resets and “revoke all sessions” invalidate browser and bearer JWT sessions. API keys remain separately revocable from the Keys dashboard.

Endpoints

Base URL: https://api.jzis.org/sclib/v1

POST/searchConsumes quota

Ordinary topic queries use hybrid search over retained corpus inputs, combining Vertex semantic retrieval with PostgreSQL full-text search and deterministic reranking. Scientific property or evidence conditions use the separate structured lookup described below.

POST /v1/search
Content-Type: application/json

{
  "query": "iron-based superconductor pairing symmetry",
  "top_k": 20,
  "filters": {
    "year_min": 2020,
    "material_family": ["iron_based"],
    "exclude_retracted": true
  }
}

Topic-route response: total, results[] (paper_id, title, authors, year, matched_chunk, relevance_score, material_family), query_time_ms.

Search and Ask also return scientific_query, scientific_lookup, and scientific_results[]. The bounded interpretation preserves the original query, formula notation and condition spans; unresolved scientific clauses require clarification rather than silently dropping a condition. Lookup status is not_requested, completed, unavailable, or clarification_required.

Scientific filters, including material_family in the example above, select the structured route: paper results=[] and total=0 are intentional. Read scientific_lookup.returned_count and scientific_results[] instead. Up to 20 extraction rows retain exact parent, evidence, content and generation bindings, with has_more for additional eligible rows. All requested conditions must match the same extracted record. Missing pressure is not ambient; a non-detection is not Tc equal to zero. These machine extractions are not original quotations, scientific acceptance or ML labels.

retrieval_generation declares generation_snapshot with a generation ID, activation-event ID and manifest hash, or legacy_lexical_only. Ordinary topic retrieval can use legacy lexical search without an active generation. Structured lookup requires bound derived parents in an active generation; unavailable or changed selected inputs withhold the entire structured result set, without legacy numerical fallback. An empty set is not evidence of absent superconductivity, full-corpus coverage or currentness beyond the checked snapshot.

POST/askConsumes quota

Route-specific scientific retrieval and RAG question answering: structured-only lookup, separate numerical and original-source candidates, or a bounded cited answer when generation is requested. Not every question triggers model generation.

POST /v1/ask
Content-Type: application/json

{
  "question": "What is the highest Tc in nickelate superconductors?",
  "max_sources": 8,
  "language": "auto"
}

Response: answer (route-specific static notice or Markdown with [1][2] citations), sources[] (paper_id, title, year), citation_valid, citation_warnings, tokens_used, and query_time_ms.

The numerical example above is not a promise of an AI-generated maximum or a scientifically accepted record. Non-comparison structured-only Ask uses the same qualified extraction fields as Search, without embedding or generation calls. Unsupported conditions can require clarification. Read the interpretation and lookup status before consuming any numerical rows.

Mixed questions and comparisons with typed property or evidence requests return the closed scientific_mixed envelope under scientific-mixed-evidence/1.1.0. It separates scientific_results[] from original-passage sources[]. Every exact numerical-parent/original-citation pair appears once in the complete association matrix, retaining the parent revision, declared catalogue-snapshot hash, original source index, vector ID, evidence revision, evidence-record hash and full-content hash. Original citation indices are not extraction-row indices.

scientific_mixed.status=completed means bounded candidate retrieval and its joint check completed, not that a numerical explanation was established. An association is established only when the server resolves a current reviewer-owned exact result/claim/sample/passage link in the same snapshot as the selected evidence check. Otherwise it is not_established with reviewed_result_passage_bridge_missing. A reviewed link is relation metadata, not a causal conclusion or scientific acceptance.same_snapshot and not_same_snapshot describe declared Paper/catalogue metadata, not an authenticated document, the same experiment, causal support or scientific independence.scientific_acceptance=false and independent_support_count=null never provide a confidence score or an ML approval label.

Mixed max_sources is a combined limit of at most 20 numerical parents and original passages, not 20 of each. The numerical allocation is max(1, floor(max_sources / 2)); unused capacity is available to originals. With a single slot, a matching numerical row takes priority and absence of original context is explicit. The UI states “Numerical explanation not established” and displays the two inventories separately; numerical comparisons do not imply comparable experiments or that the user requested an explanation.

scientific_mixed.status=unavailable withdraws numerical rows, original citations and associations together after a failed or changed combined check. No previous eligible subset is retained. Existing routes default to not_requested; missing metadata in older responses retains legacy behavior. A malformed present envelope withholds the mixed inventories and answer prose rather than falling back to an unchecked explanation.

evidence_packing and per-source packing_info describe selected context, catalogue-source/Work diversity, heuristic roles, bounded exclusions and canonical full-payload UTF-8 bytes. Selection counts are not independent papers or experiments. The packer budgets complete retained chunks; original source cards show whitespace-normalized previews of at most 280 characters. A snippet is not the full chunk or paper; the content hash binds the retained full chunk, not only the preview.

input_budget separately reports provider token-preflight status, model, request hash, byte and input-token limits, and generation_started (null when unknown or not requested). Actual providercount_tokens observations are not billed-usage receipts or model-version attestations; UTF-8 bytes are a resource bound, not model tokens. Mixed retrieval calls neither Gemini CountTokens nor generation: input_budget.status=not_requested, tokens_used=0, assessment_scope=none and answer_mode=abstention. Its measured packing representation is not a submitted generation request. Semantic retrieval may still call embedding/vector providers, so zero generation tokens does not mean zero retrieval cost, zero API quota use or a billing guarantee.

Scientific support metadata is additive: support_policy_version, citation_indices_valid, lexical_support_checked, scientific_support_status, claim_assessments[], support_warnings, support_coverage, assessment_scope, and answer_mode. The legacy citation_valid flag is deprecated and mechanical only; valid citation indices do not demonstrate that a claim is supported.

scientific_support_status is supported, contradicted, undetermined, or not_checked. “Supported” means narrow excerpt consistency checks passed, not scientific truth, experimental confirmation, or approval as an ML label. Claim assessments include draft text, cited indices, reason codes, and attributable evidence excerpts. Coverage counts and limits describe bounded checks, not exhaustive scientific validation.

assessment_scope=generated_draft refers to an attempted generated draft, not to verification of a delivered fallback. answer_modedistinguishes synthesis, limited_synthesis, extractive_fallback, and abstention. Conflicted or unresolved draft assertions are withheld rather than shown as supported conclusions. A fallback supplies source excerpts, not verified findings. Missing or incompatible metadata is displayed as unchecked; historical saved answers do not contain this current audit envelope.

language accepts "auto", "en", or "zh". Auto selects the question language for generated answers. Static operational notices and website-owned labels remain English; original queries and source wording retain their language.

Search results and Ask sources carry evidence_provenancewith evidence kind, exact revision hashes, producer versions, source coordinates and currentness. Version rag-evidence/1.0.0leaves original roots and text permissions unreviewed; its scientific authority flags are always false. It cannot establish independent confirmation or an ML training label. Derived Facts are labeled as generated extraction text, not original quotations. Known restricted or stale excerpts are withheld.

The generation route rechecks its selected database inputs after generation. A changed or unavailable check withdraws the draft and returns an abstention. Mixed retrieval instead checks both selected inventories together before returning them, without generating a draft. A matching snapshot is not scientific acceptance or a permanent currentness guarantee. Saved provenance is historical and does not revalidate a saved answer.

Structured-only and mixed history entries cannot replay the new response-level bindings or numerical rows; they store a static interaction notice. Mixed history also omits original candidates and associations. Rerun the query for a new qualified read instead of reconstructing unsupported historical evidence.

GET/materialsFree · no quota

Browse and filter the superconductor materials database.

GET /v1/materials?family=cuprate,iron_based&tc_min=50&sort=tc_max&limit=100

Filters: family (comma-separated), tc_min, ambient_sc, pressure_min, pressure_max, experimental_only, knowledge_origin, source_role, is_unconventional, has_competing_order, pairing_symmetry, structure_phase.

Sort: tc_max | tc_ambient | arxiv_year | total_papers. Pagination via limit & offset.

Family, Tc, pressure and evidence filters must match one extracted result;matching_results identifies the matching occurrences and their pressure semantics. Unknown pressure is excluded from pressure limits unlessinclude_unknown_pressure=true is explicitly requested.ambient_sc=true requires an observed positive result with explicit ambient evidence;ambient_sc=false returns 422 because absence is not a negative experiment. These references are legacy occurrence identifiers, not reviewed ML labels.

Classification filters pairing_symmetry, is_unconventional and has_competing_order use the current source-reported material summary under material-semantics/1.0.0, not a same-result Tc/state predicate. The response declares classification_filter_scope=material_reported_summary_not_joint_state. Unknown or missing values never mean false; reported false requires source-linked method and detection conditions. Family priors and stale aggregate classifications do not match these filters.

The additive material_semantics envelope separates reported properties, inferred priors, state variability, extraction conflicts and unadjudicated dispute reports. Its support counts are occurrences and bibliographic identifiers, not independent works or replications.support.count_basis explains why identifier aliases and support.legacy_total_papersmay differ, including parent rollups and other catalogue policies. Legacy responses without this envelope remain unchecked.

structure_evidence contains pending text proposals and unassigned mentions under structure-evidence/1.0.0. Structure, phase and space-group summary aliases remain null until local material/state associations and source revisions can be reviewed. Nonempty structure_phase filters return 422 rather than matching unverified catalogue labels. A source-content hash and assembled-text span are provenance proposals, not a verified publication revision, coordinate artifact or scientific approval. Structure evidence excerpts are withheld pending source access and redistribution review; raw response records do not export the new extraction-only quotation containers.

GET/materials/{id}Free · no quota

Full detail for a single material — Tc values, pressure, crystal structure, pairing symmetry, all source records with paper links.

GET /v1/materials/mat%3AYBa2Cu3O7
GET/materials/resultsFree · no quota

Current source-scoped Tc results for Materials browsing. Public display is limited to Tc ≤ 300 K; assertions outside this limit carry the tc_above_300k display flag and are excluded before filtering, counts and pagination. Original source assertions are retained.

Filter by q, material_id, family, pressure and criterion. Use limit (1–200) and offset for paging.

GET/materials/timelineFree · no quota

The same public Tc scope, with paper-submission dates and explicit day or month precision. max_points accepts 2000, 5000 or 20000; the compact homepage view is sampled for display.

GET/materials/datasetFree · no quota

Sign-in required. Use a signed-in browser session or Authorization: Bearer … to read the current immutable download manifest. These downloads retain original source assertions; browsing filters and the public Tc display limit do not rewrite the archive.

GET/materials/dataset/{version}/{kind}Free · no quota

Sign-in required. Download a verified versioned CSV with kind set to results, evidence or training. Unauthenticated requests return 401. A changed source snapshot returns 409 until its new downloads are prepared.

GET/paper/{id}Free · no quota

Paper metadata — title, authors, abstract, journal, DOI, arXiv ID, extracted materials list, retraction status.

GET /v1/paper/arxiv%3A2301.12345
GET/similar/{paper_id}Free · no quota

Find semantically similar papers via vector search. Returns up to 10 neighbours.

GET/timelineFree · no quota

Reported Tc Timeline results retain result identity, revision, year basis, state, criterion, and source provenance. Deterministic stratified display budgets (max_points) precede stable offset/limit pagination.sampling describes display selection; record_summarydescribes the full filtered, unsampled dataset. Neither is an approved training dataset or a world-record chronology.

GET /v1/timeline?schema_version=1&max_points=10000&offset=0&limit=1000&compact=true

Timeline returns ETag and X-Data-Versionafter current governance checks, with Cache-Control: private, no-store. Compact mode retains result provenance. Legacy results are unreviewed;reviewed_only=true is unavailable and returns 422 until accepted result-level review data exists. The compatibility filterexperimental_only=true means reported Observed origin, not independent experimental confirmation.

GET/discovery/candidatesFree · no quota

Versioned, paginated candidate summaries. Fetch full evidence only when needed from /discovery/candidates/{candidate_id}.

GET /v1/discovery/candidates?schema_version=1&offset=0&limit=24
GET/discovery/rps/releasesFree · no quota

The separate rps-catalog/1.3 publication catalog lists checked release items[], failed release unavailable[], status, approval_sha256 and catalog_revision. Status is published, not_published, degraded or unavailable; failed verification must not be treated as a successfully empty catalog. Snapshot hashes describe the server read point, not permanent approval or scientific validation. The current board requires catalog 1.3; release pages and details retain 1.2.

Each item has public_bundle with status, sha256 and verifier_version. Only available supplies a bundle hash and rps-public-verifier/1.0.0.not_published and unavailable retain null hash/version fields and no download. A bundle failure can degrade the catalog without discarding a separately checked score release.

Download from GET /discovery/rps/releases/{id}/bundle with both manifest_sha256 and bundle_sha256 copied from the selected item. The fixed API route rechecks current publication configuration and returns a canonical attachment; unapproved, mismatched or unavailable requests receive an error, not an unpinned substitute. The browser has not independently verified a file merely because it displays this link. Refreshing the catalog clears old scores and download pins while new checks run.

Public bundle publication needs its own administrator pin as well as the release pin. Hash integrity and deterministic RPS recomputation do not establish reviewer identity, source truth, disclosure rights, scientific acceptance or a probability of superconductivity. Public review-attestation labels remain declarations, not authenticated reviewers or redistribution permission.

GET/statsFree · no quota

Site-wide statistics with separate aggregate-refresh, data-snapshot, and ingestion-pipeline timestamps/status.

GET/health/dependenciesFree · no quota

Bounded PostgreSQL and Redis dependency probes. Returns 503 when a required dependency is unavailable. Process liveness and orchestrator readiness are also exposed upstream at /livez and /readyz.

GET/health/dataFree · no quota

Non-gating data-health metadata for the stats cache, dataset snapshot, ingestion stages, timeline projection, and Discovery feed. Data age is reported without being treated as a readiness failure.

Error codes

CodeMeaning
401Invalid or revoked API key
403Account inactive or insufficient permissions
404Resource not found (material / paper ID)
422Validation error — check request body / query params
429Daily quota exceeded — resets at 00:00 UTC

Every response includes X-Request-ID and X-API-Version. Error JSON preserves detailand adds error_code plus request_id; include the request ID when reporting an API problem.

Full example: Python

These general request examples keep their route-specific response handling. Scientific filters or mixed questions require the structured fields and consistency checks above; empty paper hits or citation lists alone do not describe the numerical lookup outcome.

import requests

API  = "https://api.jzis.org/sclib/v1"
KEY  = "scl_YOUR_KEY"
HEAD = {"X-API-Key": KEY}

# 1. List cuprate materials with Tc > 100 K  (free, no quota)
mats = requests.get(
    f"{API}/materials",
    params={"family": "cuprate", "tc_min": 100, "limit": 50},
    headers=HEAD,
).json()

for m in mats["results"]:
    print(f"{m['formula']}  Tc={m['tc_max']} K  papers={m['total_papers']}")

# 2. Semantic search  (consumes 1 quota)
hits = requests.post(
    f"{API}/search",
    headers={**HEAD, "Content-Type": "application/json"},
    json={"query": "pressure-induced superconductivity in hydrides", "top_k": 10},
).json()

for h in hits["results"]:
    print(f"[{h['relevance_score']:.2f}] {h['title']}")

# 3. Ask a question  (consumes 1 quota)
ans = requests.post(
    f"{API}/ask",
    headers={**HEAD, "Content-Type": "application/json"},
    json={"question": "What is the mechanism of high-Tc in cuprates?", "max_sources": 5},
).json()

print(ans["answer"])
for s in ans["sources"]:
    print(f"  [{s['index']}] {s['title']} ({s['year']})")