Skip to main content
The /fields endpoints expose Hexagraph’s registry of research fields. Each field belongs to a broader research domain and contains aggregated scholarly output metrics, citation counts, and relationships to subfields and peer fields. Fields are identified using the OA: prefix system.

​
List fields

Retrieve a paginated list of research fields.

​
Query Parameters

​
page (number)

Page number for paginated results. Starts at 1.

​
per_page (number)

Number of results returned per page. Maximum value is 200.

​
sort (number)

Sort results by scholarly output count. Available values:
ValueDescription
1Sort by outputs ascending
-1Sort by outputs descending

​
filter (string)

Filter results using one or more key-value expressions. Multiple filters may be combined using commas.

​
group_by (string)

Group results by a specified field for aggregation and analysis.

​
Example Request

curl "https://hexagraph-core.onrender.com/fields"

​
Example Response

[
  {
    "id": "OA:22",
    "name": "Engineering",
    "description": "practice of using natural science, mathematics, and the engineering design process to solve technical problems",
    "outputs": 63216950,
    "citations": 305274102,
    "urls": {
      "wikidata": "https://www.wikidata.org/wiki/Q11023",
      "wikipedia": "https://en.wikipedia.org/wiki/Engineering"
    },
    "domain": {
      "name": "Physical Sciences"
    },
    "subfields": [
      "General Engineering",
      "Aerospace Engineering",
      "Automotive Engineering"
    ],
    "siblings": [
      "Chemical Engineering",
      "Computer Science",
      "Mathematics"
    ]
  },
 {
      "id": "OA:33",
      "name": "Social Sciences",
      "description": "academic disciplines concerned with society and the relationships between individuals in society",
      "outputs": 53537437,
      "citations": 191282403,
      "urls": {
        "wikidata": "https://www.wikidata.org/wiki/Q34749",
        "wikipedia": "https://en.wikipedia.org/wiki/Social_science"
      },
      "domain": {
        "name": "Social Sciences"
      },
      "subfields": [
        "General Social Sciences",
        "Archeology"
      ],
      "siblings": [
        "Agricultural and Biological Sciences",
        "Arts and Humanities"
      ]
    }
]

​
Get a single field

Fetch a specific field by its OA: identifier.

​
Example Request

curl "https://hexagraph-core.onrender.com/fields/OA:22"

​
Example Response

{
  "id": "OA:22",
  "name": "Engineering",
  "description": "practice of using natural science, mathematics, and the engineering design process to solve technical problems",
  "outputs": 63216950,
  "citations": 305274102,
  "urls": {
    "wikidata": "https://www.wikidata.org/wiki/Q11023",
    "wikipedia": "https://en.wikipedia.org/wiki/Engineering"
  },
  "domain": {
    "id": "OA:3",
    "name": "Physical Sciences"
  },
  "subfields": [
    {
      "id": "OA:2200",
      "name": "General Engineering"
    }
  ],
  "siblings": [
    {
      "id": "OA:15",
      "name": "Chemical Engineering"
    }
  ]
}

​
Response Fields

​
id

Unique identifier for the field. Uses the OA: prefix system (e.g. OA:22).

​
name

Display name of the research field (e.g. "Engineering").

​
description

Short description defining the scope of the field.

​
outputs

Total number of scholarly outputs associated with the field.

​
citations

Aggregate citation count across all works associated with the field.

​
urls

External reference links related to the field.

​
urls.wikidata

Link to the field’s Wikidata entry.

​
urls.wikipedia

Link to the corresponding Wikipedia article.

​
domain

The parent research domain to which the field belongs. In the list endpoint, the domain contains only the domain name.

​
domain.name

Display name of the parent domain. In the single-field endpoint, the domain includes both an identifier and name.

​
domain.id

Unique identifier of the parent domain.

​
domain.name

Display name of the parent domain.

​
subfields

Research subfields that belong to the field. In the list endpoint, subfields are returned as an array of names. In the single-field endpoint, subfields are returned as objects containing:

​
subfields[].id

Unique identifier of the subfield.

​
subfields[].name

Display name of the subfield.

​
siblings

Other fields that belong to the same level of the Hexagraph taxonomy. In the list endpoint, siblings are returned as an array of names. In the single-field endpoint, siblings are returned as objects containing:

​
siblings[].id

Unique identifier of the sibling field.

​
siblings[].name

Display name of the sibling field.