pub.chive.actor.discoverAuthorIds

chive.pub

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
{
  "type": "query",
  "errors": [
    {
      "name": "AuthenticationRequired"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "searchedName",
        "matches"
      ],
      "properties": {
        "matches": {
          "type": "array",
          "items": {
            "ref": "#authorMatch",
            "type": "ref"
          }
        },
        "searchedName": {
          "type": "string",
          "description": "The name that was searched"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "name": {
        "type": "string",
        "minLength": 1,
        "description": "Author name to search for"
      },
      "limit": {
        "type": "integer",
        "default": 5,
        "maximum": 20,
        "minimum": 1,
        "description": "Maximum number of matches to return"
      }
    }
  },
  "description": "Discover external author IDs (OpenAlex, Semantic Scholar, etc.) by searching for a name across academic databases"
}
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
{
  "type": "object",
  "required": [
    "displayName",
    "worksCount",
    "citedByCount",
    "ids"
  ],
  "properties": {
    "ids": {
      "ref": "#externalIds",
      "type": "ref"
    },
    "worksCount": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of works attributed to this author"
    },
    "displayName": {
      "type": "string",
      "description": "Display name from the database"
    },
    "institution": {
      "type": "string",
      "description": "Current institutional affiliation"
    },
    "citedByCount": {
      "type": "integer",
      "minimum": 0,
      "description": "Total citation count"
    }
  },
  "description": "A potential author match from academic databases"
}
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
{
  "type": "object",
  "properties": {
    "dblp": {
      "type": "string",
      "description": "DBLP author identifier"
    },
    "orcid": {
      "type": "string",
      "description": "ORCID identifier"
    },
    "openalex": {
      "type": "string",
      "description": "OpenAlex author ID (e.g., A5023888391)"
    },
    "semanticScholar": {
      "type": "string",
      "description": "Semantic Scholar author ID"
    }
  },
  "description": "External author identifiers from various databases"
}

Lexicon Garden

@