Get started

INSPIRE-HEP in Duaer

In Duaer: High-energy physics literature from INSPIRE: papers, preprints, and theses with authors or collaboration, arXiv id, journal, DOI, and citation count. One successful search uses 1 credit.

What you get

Duaer INSPIRE-HEP searches the INSPIRE literature database used across particle physics, astrophysics, and related fields. It accepts plain words and INSPIRE syntax such as a Witten or t dark matter.

Pick Duaer Data → INSPIRE-HEP in the node creator, or open the data market. Related: arxiv, papers, OpenCitations.

When to use it

Find the most cited papers on a physics topic with `sort=mostcited`.
Track new preprints from a collaboration or an author.

When not to use it

General science outside physics. Use papers.
Machine learning conference papers. Use OpenReview.

Search on the canvas

Open the node creator and pick Duaer Data → INSPIRE-HEP.
Fill Words (such as higgs boson). Optional: Sort.
Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

GET https://api.duaer.com/v1/data/inspire-hep?words=higgs%20boson&sort=mostcited&limit=5
Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-inspire-hep
description: >-
  Duaer INSPIRE-HEP. High-energy physics literature from INSPIRE: papers, preprints, and theses with authors or collaboration, arXiv id, journal, DOI, and citation count.
  One successful search uses 1 Duaer credit.
---

# Duaer INSPIRE-HEP

Duaer INSPIRE-HEP searches the INSPIRE literature database used across particle physics, astrophysics, and related fields. It accepts plain words and INSPIRE syntax such as `a Witten` or `t dark matter`.

## When to use

- Find the most cited papers on a physics topic with `sort=mostcited`.
- Track new preprints from a collaboration or an author.

## When not to use

- General science outside physics. Use https://skills.duaer.com/papers.md.
- Machine learning conference papers. Use https://skills.duaer.com/openreview.md.

## Call

`GET https://api.duaer.com/v1/data/inspire-hep?words=higgs%20boson&sort=mostcited&limit=5`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `words`.

- `words` — Words or INSPIRE search syntax, such as higgs boson or a Witten.
- `sort` — Optional. mostrecent or mostcited. Default mostrecent.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/inspire-hep?words=higgs%20boson&sort=mostcited&limit=5` — the most cited Higgs papers.
- `GET https://api.duaer.com/v1/data/inspire-hep?words=a%20Witten&sort=mostrecent` — recent papers by Witten.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `recordId` — INSPIRE record id.
- `authors`, `collaboration` — first authors, or the collaboration.
- `date`, `journal` — earliest date and journal reference.
- `arxiv`, `doi` — identifiers.
- `citations` — citation count in INSPIRE.
- `abstract` — start of the abstract.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/arxiv.md
- https://skills.duaer.com/papers.md
- https://skills.duaer.com/opencitations.md — Duaer OpenCitations

Questions

How many credits does a INSPIRE-HEP search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

Does Duaer INSPIRE-HEP support INSPIRE search syntax?

Yes. Duaer passes your words to INSPIRE, so syntax such as `a Witten` or `t neutrino` works.

In this section