OpenAlex Listcountries

1 credits/call
ae_openalex_listcountries

List countries to help filter academic works and authors by national affiliation.

Academic
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
sortstringNoSort by: `works_count`, `cited_by_count`. Prefix with `-` for descending. See [all Country fields](/api-reference/countries#available-filter-sort-and-group_by-fields).—
filterstringNoFilter countries. Examples: `id:US`, `works_count:>1000000` See [all Country fields](/api-reference/countries#available-filter-sort-and-group_by-fields).—
group_bystringNoGroup results by a field and return counts. Available fields vary by entity type. See [all Country fields](/api-reference/countries#available-filter-sort-and-group_by-fields).—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_openalex_listcountries' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {}
}'
Response exampleresponse.json
JSONPartial content
{
  "results": [
    {
      "alpha_3": "JPN",
      "authors_api_url": "https://api.openalex.org/authors?filter=last_known_institutions.country_code:JP",
      "cited_by_count": 118306034,
      "continent": {
        "display_name": "Asia",
        "id": "https://openalex.org/continents/Q48"
      },
      "country_code": "JP",
      "id": "https://openalex.org/countries/JP"
    }
  ]
}

This example shows part of the response. Copied content is valid JSON.