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

# Suggest sources

Retrieve the source URI for a given source name or doman name.

Use this API endpoint to map the source name or partial domain name to the source URI that can be used when specifying the `sourceUri` filter in various API calls. The source name can also be a partial name. The returned value will contain an array of source candidates that match the input label. The returned list is sorted based on the number of articles that we have collected from this source. Source URIs are simply clean domain names of the news sources, such as bbc.com, theguardian.com, nytimes.com, etc.

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

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

#### `Parameters`

#### `apiKey`

string (required)

Your API key

#### `prefix`

string

Partial or full name of the source or the domain name.

## Request examples

### Example 1

Find the list of news sources whose name or domain name match "BBC".

Request body:

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

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

conceptUrisMatchingObama = er.suggestNewsSources("BBC")
```

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

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

## Example output

```json
[
  {
    "score": 1102763,
    "dataType": "news",
    "uri": "aa.com.tr",
    "title": "Anadolu Ajansı"
  },
  {
    "score": 1069650,
    "dataType": "news",
    "uri": "ansa.it",
    "title": "ANSA.it"
  },
  {
    "#META ITEM": "other sources..."
  }
]
```

## Output schema

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