curl -X POST https://win.oneshotagent.com/v1/tools/lookup/gene-publications \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"gene_id": "7157",
"limit": 3
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/gene-publications", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"gene_id": "7157",
"limit": 3
}),
});
const result = await agent.tool('lookup/gene-publications', {
gene_id: '7157',
limit: 3
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "gene_publications",
"result": {
"gene_id": "7157",
"total": 20405,
"publications": [
{
"pmid": "42288623",
"title": "TRIM17 downregulation modulates CRPC progression and enzalutamide resistance by derepressing BCL2 expression via the p53-dependent and p53-independent pathways.",
"journal": "Cell Death Differ",
"journal_full": "Cell death and differentiation",
"published": "2026-06-13",
"published_text": "2026 Jun 13",
"authors": [
"Shang Z",
"Lin G",
"Yu L"
],
"author_count": 9,
"doi": "10.1038/s41418-026-01778-7",
"pmcid": null,
"publication_types": [
"Journal Article"
],
"url": "https://pubmed.ncbi.nlm.nih.gov/42288623/"
},
{
"pmid": "42258614",
"title": "ATM-Related Cancer Predisposition.",
"journal": null,
"journal_full": null,
"published": "2026-06-04",
"published_text": "2026 Jun 4",
"authors": [
"Schon KR",
"Pal T",
"Stewart DR"
],
"author_count": 5,
"doi": null,
"pmcid": null,
"publication_types": [
"Review"
],
"url": "https://pubmed.ncbi.nlm.nih.gov/42258614/"
},
{
"pmid": "41932313",
"title": "An interactome-based framework for DDB1- and CUL4-associated factor prioritization in targeted protein degradation.",
"journal": "Mol Cell",
"journal_full": "Molecular cell",
"published": "2026-04-02",
"published_text": "2026 Apr 2",
"authors": [
"Yamanaka S",
"Nagaoka K",
"Shoya Y"
],
"author_count": 11,
"doi": "10.1016/j.molcel.2026.03.004",
"pmcid": null,
"publication_types": [
"Journal Article",
"Research Support, Non-U.S. Gov't"
],
"url": "https://pubmed.ncbi.nlm.nih.gov/41932313/"
}
]
},
"evidence": {
"source": "US National Center for Biotechnology Information",
"source_kind": "public",
"retrieved_at": "2026-10-23T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-23T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-23T12:00:00.000Z"
}
],
"as_of": "2026-06-13"
}
}
}
Life sciences
Gene Publications
List the PubMed papers NCBI links to a gene by its NCBI Gene ID, most recently added first, with citation details and how many are linked in all.
POST
/
v1
/
tools
/
lookup
/
gene-publications
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/gene-publications \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"gene_id": "7157",
"limit": 3
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/gene-publications", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"gene_id": "7157",
"limit": 3
}),
});
const result = await agent.tool('lookup/gene-publications', {
gene_id: '7157',
limit: 3
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "gene_publications",
"result": {
"gene_id": "7157",
"total": 20405,
"publications": [
{
"pmid": "42288623",
"title": "TRIM17 downregulation modulates CRPC progression and enzalutamide resistance by derepressing BCL2 expression via the p53-dependent and p53-independent pathways.",
"journal": "Cell Death Differ",
"journal_full": "Cell death and differentiation",
"published": "2026-06-13",
"published_text": "2026 Jun 13",
"authors": [
"Shang Z",
"Lin G",
"Yu L"
],
"author_count": 9,
"doi": "10.1038/s41418-026-01778-7",
"pmcid": null,
"publication_types": [
"Journal Article"
],
"url": "https://pubmed.ncbi.nlm.nih.gov/42288623/"
},
{
"pmid": "42258614",
"title": "ATM-Related Cancer Predisposition.",
"journal": null,
"journal_full": null,
"published": "2026-06-04",
"published_text": "2026 Jun 4",
"authors": [
"Schon KR",
"Pal T",
"Stewart DR"
],
"author_count": 5,
"doi": null,
"pmcid": null,
"publication_types": [
"Review"
],
"url": "https://pubmed.ncbi.nlm.nih.gov/42258614/"
},
{
"pmid": "41932313",
"title": "An interactome-based framework for DDB1- and CUL4-associated factor prioritization in targeted protein degradation.",
"journal": "Mol Cell",
"journal_full": "Molecular cell",
"published": "2026-04-02",
"published_text": "2026 Apr 2",
"authors": [
"Yamanaka S",
"Nagaoka K",
"Shoya Y"
],
"author_count": 11,
"doi": "10.1016/j.molcel.2026.03.004",
"pmcid": null,
"publication_types": [
"Journal Article",
"Research Support, Non-U.S. Gov't"
],
"url": "https://pubmed.ncbi.nlm.nih.gov/41932313/"
}
]
},
"evidence": {
"source": "US National Center for Biotechnology Information",
"source_kind": "public",
"retrieved_at": "2026-10-23T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-23T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-23T12:00:00.000Z"
}
],
"as_of": "2026-06-13"
}
}
}
Lists the PubMed papers the US National Center for Biotechnology Information links to a gene, by NCBI Gene ID, most recently added first: title, journal, dates, first three authors, DOI, PubMed Central id, publication types and link. Only citation fields are returned, never an abstract or the full text. This is the curated gene-to-paper link list, not a literature search.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
An NCBI Gene ID, digits only, for example 7157 for human TP53;
gene_resolve finds it from a symbol or alias. Digits only, 1 to 12.integer
Papers returned, most recently added to PubMed first. From 1 to 20. Defaults to
10.Response (200 OK)
Top-level envelope:success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status:
completedstring
Always
gene_publicationsobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US National Center for Biotechnology Information.string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string | null
The newest
published date among the papers returned; null when the gene has no linked papers.Result
Nested underdata.result.
string
The NCBI Gene ID asked for.
integer
How many PubMed papers the source links to the gene, all of them, not only those returned.
object[]
The papers returned, highest PubMed id first.
string
The PubMed id.
string | null
The title.
null when the source gives no value.string | null
The journal’s abbreviated name; null for a book chapter.
string | null
The journal’s full name.
null when the source gives no value.string | null
The publication date the source sorts by, as YYYY-MM-DD.
null when the source gives no value.string | null
The publication date as the source prints it, for example “2026 Jun 13” or “2026 Dec”; a book chapter’s own date, not the book’s first year.
null when the source gives no value.string[]
The first three author names, as the source abbreviates them; book editors listed on a chapter are not authors and are left out.
integer
How many authors the paper has.
string | null
The DOI; null when the source lists none.
string | null
The PubMed Central id; null when the paper is not in PubMed Central.
string[]
The publication types, for example “Journal Article” or “Review”.
string
The paper’s page on PubMed.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/gene-publications \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"gene_id": "7157",
"limit": 3
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/gene-publications", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"gene_id": "7157",
"limit": 3
}),
});
const result = await agent.tool('lookup/gene-publications', {
gene_id: '7157',
limit: 3
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "gene_publications",
"result": {
"gene_id": "7157",
"total": 20405,
"publications": [
{
"pmid": "42288623",
"title": "TRIM17 downregulation modulates CRPC progression and enzalutamide resistance by derepressing BCL2 expression via the p53-dependent and p53-independent pathways.",
"journal": "Cell Death Differ",
"journal_full": "Cell death and differentiation",
"published": "2026-06-13",
"published_text": "2026 Jun 13",
"authors": [
"Shang Z",
"Lin G",
"Yu L"
],
"author_count": 9,
"doi": "10.1038/s41418-026-01778-7",
"pmcid": null,
"publication_types": [
"Journal Article"
],
"url": "https://pubmed.ncbi.nlm.nih.gov/42288623/"
},
{
"pmid": "42258614",
"title": "ATM-Related Cancer Predisposition.",
"journal": null,
"journal_full": null,
"published": "2026-06-04",
"published_text": "2026 Jun 4",
"authors": [
"Schon KR",
"Pal T",
"Stewart DR"
],
"author_count": 5,
"doi": null,
"pmcid": null,
"publication_types": [
"Review"
],
"url": "https://pubmed.ncbi.nlm.nih.gov/42258614/"
},
{
"pmid": "41932313",
"title": "An interactome-based framework for DDB1- and CUL4-associated factor prioritization in targeted protein degradation.",
"journal": "Mol Cell",
"journal_full": "Molecular cell",
"published": "2026-04-02",
"published_text": "2026 Apr 2",
"authors": [
"Yamanaka S",
"Nagaoka K",
"Shoya Y"
],
"author_count": 11,
"doi": "10.1016/j.molcel.2026.03.004",
"pmcid": null,
"publication_types": [
"Journal Article",
"Research Support, Non-U.S. Gov't"
],
"url": "https://pubmed.ncbi.nlm.nih.gov/41932313/"
}
]
},
"evidence": {
"source": "US National Center for Biotechnology Information",
"source_kind": "public",
"retrieved_at": "2026-10-23T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-23T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-23T12:00:00.000Z"
}
],
"as_of": "2026-06-13"
}
}
}
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers
200.Notes
totalis how many papers are linked in all. Each paper also gives its author count.- The order is by PubMed id, highest first, which is the order papers were added to PubMed; it is not the order of publication.
- The answer reports what a public database links to the gene: it is for research and is not medical advice.
- Takes a Gene ID only, never a sequence, a genome or a variant file; use
gene_resolveto find the Gene ID for a symbol or alias. - A gene with no linked papers, or an id no gene has, is a completed answer with
total0. - Results return inline. The finished job stays available at
/v1/requests/{request_id}