Source: https://eventregistry.org/documentation?tab=suggAuthors

# Suggest authors

Retrieve the author URI for a given author name.

Use this API endpoint to map the author name to the author URI that can be used when specifying the `authorUri` filter in various API calls. Since it's possible that there are multiple authors with the same name you can also specify the source domain name in the query (e.g. 'amy more nytimes.com') to make sure that the returned author will come from the news source of interest. The returned value will contain an array of author candidates that match the input name. The returned list is sorted based on the number of articles that we have collected from the author.

**Endpoint:** GET | POST `https://eventregistry.org/api/v1/suggestAuthorsFast`

**Headers:** Content-Type: application/json

#### `Parameters`

#### `apiKey`

string (required)

Your API key

#### `prefix`

string

Partial or full name of the author.

## Request examples

### Example 1

Find the list of authors whose name contain word "Koenig".

Request body:

```json
{
  "prefix": "Koenig",
  "apiKey": "YOUR_API_KEY"
}
```

```python
from eventregistry import *
er = EventRegistry(apiKey = YOUR_API_KEY)

conceptUrisMatchingObama = er.suggestAuthors("Koenig")
```

```javascript
var er = new erBase.EventRegistry();
                    er.suggestAuthors("Koenig").then((response) => {
                        console.info(response);
                    });
```

```typescript
const er = new EventRegistry();
                    er.suggestAuthors("Koenig").then((response) => {
                        console.info(response);
                    });
```

## Example output

```json
[
  {
    "uri": "associated_press@marketwatch.com",
    "name": "Associated Press",
    "type": "author",
    "isAgency": true
  },
  {
    "uri": "jovana_markovic@kurir.rs",
    "name": "Jovana Marković",
    "type": "author",
    "isAgency": false
  },
  {
    "#META ITEM": "other authors..."
  }
]
```

## Output schema

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "uri": {
        "type": "string"
      },
      "dataType": {
        "type": "string"
      },
      "title": {
        "type": "string"
      }
    }
  }
}
```