pub.chive.actor.discoverAuthorIds

chive.pub View official

Documentation

Discover external author IDs (OpenAlex, Semantic Scholar, etc.) by searching for a name across academic databases

main query

Discover external author IDs (OpenAlex, Semantic Scholar, etc.) by searching for a name across academic databases

Parameters

limit integer Optional

Maximum number of matches to return

name string Optional

Author name to search for

Output

Encodingapplication/json
matches array Required

No description available.

searchedName string Required

The name that was searched

Errors

AuthenticationRequired
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Maximum number of matches to return
Author name to search for
View raw schema
{
  "description": "Discover external author IDs (OpenAlex, Semantic Scholar, etc.) by searching for a name across academic databases",
  "errors": [
    {
      "name": "AuthenticationRequired"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "matches": {
          "items": {
            "ref": "#authorMatch",
            "type": "ref"
          },
          "type": "array"
        },
        "searchedName": {
          "description": "The name that was searched",
          "type": "string"
        }
      },
      "required": [
        "searchedName",
        "matches"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "limit": {
        "default": 5,
        "description": "Maximum number of matches to return",
        "maximum": 20,
        "minimum": 1,
        "type": "integer"
      },
      "name": {
        "description": "Author name to search for",
        "minLength": 1,
        "type": "string"
      }
    },
    "type": "params"
  },
  "type": "query"
}
authorMatch object

A potential author match from academic databases

Properties

citedByCount integer Required

Total citation count

minimum: 0
displayName string Required

Display name from the database

institution string Optional

Current institutional affiliation

worksCount integer Required

Number of works attributed to this author

minimum: 0
View raw schema
{
  "description": "A potential author match from academic databases",
  "properties": {
    "citedByCount": {
      "description": "Total citation count",
      "minimum": 0,
      "type": "integer"
    },
    "displayName": {
      "description": "Display name from the database",
      "type": "string"
    },
    "ids": {
      "ref": "#externalIds",
      "type": "ref"
    },
    "institution": {
      "description": "Current institutional affiliation",
      "type": "string"
    },
    "worksCount": {
      "description": "Number of works attributed to this author",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "displayName",
    "worksCount",
    "citedByCount",
    "ids"
  ],
  "type": "object"
}
externalIds object

External author identifiers from various databases

Properties

dblp string Optional

DBLP author identifier

openalex string Optional

OpenAlex author ID (e.g., A5023888391)

orcid string Optional

ORCID identifier

semanticScholar string Optional

Semantic Scholar author ID

View raw schema
{
  "description": "External author identifiers from various databases",
  "properties": {
    "dblp": {
      "description": "DBLP author identifier",
      "type": "string"
    },
    "openalex": {
      "description": "OpenAlex author ID (e.g., A5023888391)",
      "type": "string"
    },
    "orcid": {
      "description": "ORCID identifier",
      "type": "string"
    },
    "semanticScholar": {
      "description": "Semantic Scholar author ID",
      "type": "string"
    }
  },
  "type": "object"
}

Lexicon Garden

@