OpenAlex Listdomains
1 credits/call
ae_openalex_listdomains
List the four top-level research domains, such as Life Sciences and Social Sciences.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
sort | string | No | Sort by: `works_count`, `cited_by_count`. Prefix with `-` for descending. See [all Domain fields](/api-reference/domains#available-filter-sort-and-group_by-fields). | — |
filter | string | No | Filter domains. Examples: `id:1`, `works_count:>10000000` See [all Domain fields](/api-reference/domains#available-filter-sort-and-group_by-fields). | — |
group_by | string | No | Group results by a field and return counts. Available fields vary by entity type. See [all Domain fields](/api-reference/domains#available-filter-sort-and-group_by-fields). | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_openalex_listdomains' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {}
}'Response exampleresponse.json
{
"group_by": [],
"meta": {
"cost_usd": 0.0001,
"count": 4,
"db_response_time_ms": 1,
"groups_count": null,
"page": 1,
"per_page": 25
},
"results": [
{
"cited_by_count": 1152863472,
"created_date": "2024-01-23T15:21:58",
"description": "branch of natural science that studies non-living systems",
"display_name": "Physical Sciences",
"display_name_alternatives": [],
"id": "https://openalex.org/domains/3"
}
]
}This example shows part of the response. Copied content is valid JSON.

