OpenAlex Listauthors

1 credits/call
ae_openalex_listauthors

Search for and list researchers, with options to filter by institution, country, or sort by citation metrics.

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`, `summary_stats.h_index`, `summary_stats.i10_index`. Prefix with `-` for descending. See [all Author fields](/api-reference/authors#available-filter-sort-and-group_by-fields).—
filterstringNoFilter authors. Examples: `has_orcid:true`, `last_known_institutions.id:I27837315`, `works_count:>100`, `affiliations.institution.country_code:US` See [all Author fields](/api-reference/authors#available-filter-sort-and-group_by-fields).—
group_bystringNoGroup by: `last_known_institutions.country_code`, `last_known_institutions.type`, `has_orcid` See [all Author fields](/api-reference/authors#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_listauthors' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "search": "Imane Alaoui Ismaili"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "group_by": [],
  "meta": {
    "cost_usd": 0.001,
    "count": 1,
    "db_response_time_ms": 28,
    "groups_count": null,
    "page": 1,
    "per_page": 25
  },
  "results": [
    {
      "affiliations": [
        {
          "institution": {
            "country_code": "MA",
            "display_name": "Abdelmalek Essaâdi University",
            "id": "https://openalex.org/I240042149",
            "lineage": [],
            "ror": "https://ror.org/03c4shz64",
            "type": "education"
          },
          "years": [
            2019
          ]
        }
      ],
      "awards_count": 0,
      "block_key": "i ismaili",
      "cited_by_count": 18,
      "counts_by_year": [
        {
          "cited_by_count": 2,
          "oa_works_count": 1,
          "works_count": 2,
          "year": 2019
        }
      ],
      "id": "https://openalex.org/A5070531513"
    }
  ]
}

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