Sources
GET {{baseUrl}}/v1/sources
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
domain | null | String. Domain name for the media source to lookup. This parameter supports wildcard queries, ie. "*.cnn.com" will match all subdomains for cnn.com. | |
name | null | String. Search by name of source. This parameter supports complex boolean search operators, and also searches the altNames field for alternative names of the source. | |
country | null | String. Country code to filter sources by the countries in which they most commonly cover. If multiple parameters are passed, they will be applied as OR operations. | |
minMonthlyVisits | null | Integer. Filter by popularity. Enter a minimum number of monthly visits that the source must have in order to match your query. | |
maxMonthlyVisits | null | Integer. Enter a maximum number of monthly visits that the source must have in order to match your query. | |
sourceCity | null | String. Find all local publications that are located within a given city. | |
sourceCounty | null | String. Find all local publications that are located within a given county. | |
sourceState | null | String. Find all local publications that are located within a given state. | |
sourceCountry | null | String. Find all local publications that are located within a given country. | |
sourceLat | null | Float. Latitude of the center point to search local publications. | |
sourceLon | null | Float. Longitude of the center point to search local publications. | |
sourceMaxDistance | null | Integer. Maximum distance from starting point to search local publications. | |
category | null | String. Filter by categories. Categories are general themes that the article is about. Examples of categories: Tech, Politics, etc. If multiple parameters are passed, they will be applied as OR operations. | |
sourceGroup | null | String. Find all sources within a sourceGroup. Find Source Groups in the guided part of our documentation | |
sortBy | null | String. Use 'relevance' to sort by relevance to the query; globalRank for top ranked sources based on popularity; monthlyVisits for sources with the largest audience; avgMonthlyPosts for sources with the highest publishing frequency. | |
size | null | Integer. Number of sources returned, from 1 to 100. The default is 10. Pagination is not currently supported for the sources endpoint. | |
paywall | null | Boolean. Use 'true' to find only sources known to have a paywall, or use 'false' to filter for only sources that do not have a paywall. | |
topic | null | String. Find sources by topic. For example, searching 'Markets' will return the sources where 'Markets' is one of the top 10 topics that they cover. | |
label | null | String. Filter sources by label. For example, searching 'Opinion' will return the sources where 'Opinion'-type articles is one of the top labels for the articles they publish. | |
minMonthlyPosts | null | Integer. Returns the sources that have at least this number of average monthly posts. | |
maxMonthlyPosts | null | Integer. Returns the sources that have at most this number of average monthly posts. | |
showNumResults | null | Boolean. If 'true', shows accurate number of results matched by the query. By default, the counter is accurate only up to 10,000 results due performance reasons. | |
apiKey | null | String. Can be found on the API Key page https://www.goperigon.com/account/api-key |
RESPONSES
status: OK
{"status":200,"numResults":1,"results":[{"id":"372f1eb953ba4c9cbd3830c47db3342a","domain":"cnn.com","name":"CNN","altNames":["CNN.com","CNN News","anderson","anderson cooper","CNN .com","wolf blitzer","erin burnett","don lemon","chris cuomo","jake tapper","brooke baldwin","dana bash","democrat","democratic","liberal"],"description":"Major US-based media organization covering world, weather, entertainment, politics and health news.","avgMonthlyPosts":3800,"paywall":false,"topCategories":[{"name":"Politics","count":1105},{"name":"General","count":576},{"name":"Entertainment","count":461},{"name":"World","count":421},{"name":"Business","count":319},{"name":"Sports","count":307},{"name":"Lifestyle","count":296},{"name":"Tech","count":217},{"name":"Travel","count":209},{"name":"Finance","count":204}],"topTopics":[{"name":"Russia-Ukraine War","count":326},{"name":"Crime","count":226},{"name":"Donald Trump","count":190},{"name":"Social Issues","count":179},{"name":"Markets","count":158},{"name":"Russia","count":151},{"name":"Joe Biden","count":145},{"name":"Ukraine","count":132},{"name":"Media","count":120},{"name":"China","count":117}],"topCountries":[{"name":"us","count":4060}],"topLabels":[{"name":"Non-news","count":428},{"name":"Paid News","count":195},{"name":"Opinion","count":194},{"name":"Pop Culture","count":76},{"name":"Roundup","count":29},{"name":"Fact Check","count":8},{"name":"Gallery","count":6}],"avgBiasRating":"leansLeft","adFontesBiasRating":"Leans Left","allSidesBiasRating":"Leans Left","mbfcBiasRating":"Left","monthlyVisits":642356699,"globalRank":86,"logoLarge":{"url":"https://storage.googleapis.com/dev-dispatch-276213.appspot.com/CNN_Reg_1d0c9bc5eb/CNN-Reg_CNN_Reg_1d0c9bc5eb.png"},"logoFavIcon":{"url":"https://storage.googleapis.com/dev-dispatch-276213.appspot.com/CNN_Fav_Icon_5d54dfad8c/CNN-FavIcon_CNN_Fav_Icon_5d54dfad8c.png"},"logoSquare":{"url":"https://storage.googleapis.com/dev-dispatch-276213.appspot.com/CNN_Square_e9ef9ce7a8/CNN-Square_CNN_Square_e9ef9ce7a8.png"}}]}