Sources
Search and filter the 200,000+ media sources available via the Perigon API. The result includes a list of individual media sources that were matched to your specific criteria.
Query parameters
String Array. Filter by specific publisher domains or subdomains. Supports wildcards (* and ?) for pattern matching (e.g., *.cnn.com, us?.nytimes.com). Multiple values create an OR filter.
String. Search by source name or alternative names. Supports Boolean operators (AND, OR, NOT), exact phrases with quotes, and wildcards (* and ?) for flexible searching.
String. Filter by predefined publisher bundles (e.g., top100, top50tech). Returns all sources within the specified group. See documentation for available source groups.
String. Determines the source sorting order. Options include relevance (default, best match to query), globalRank (by overall traffic and popularity), monthlyVisits (by total monthly visitor count), and avgMonthlyPosts (by number of articles published monthly).
Integer. The specific page of results to retrieve in the paginated response. Starts at 0.
Integer. The number of sources to return per page in the paginated response.
Integer. Filter for sources with at least this many monthly visitors. Used to target publishers by audience size.
Integer. Filter for sources with no more than this many monthly visitors. Used to target publishers by audience size.
Integer. Filter for sources that publish at least this many articles per month. Used to target publishers by content volume.
Integer. Filter for sources that publish no more than this many articles per month. Used to target publishers by content volume.
String Array. Filter sources by countries they commonly cover in their reporting. Uses ISO 3166-1 alpha-2 two-letter country codes in lowercase (e.g., us, gb, jp). See documentation for supported country codes. Multiple values create an OR filter.
String Array. Filter for local publications based in specific countries. Uses ISO 3166-1 alpha-2 two-letter country codes in lowercase (e.g., us, gb, jp). See documentation for supported country codes. Multiple values create an OR filter.
String Array. Filter for local publications based in specific states or regions. Uses standard two-letter state codes in lowercase (e.g., ca, ny, tx). See documentation for supported state codes. Multiple values create an OR filter.
String Array. Filter for local publications based in specific counties. Multiple values create an OR filter.
String Array. Filter for local publications based in specific cities. Multiple values create an OR filter.
Float. Latitude coordinate for filtering local publications by geographic proximity. Used with sourceLon and sourceMaxDistance for radius search.
Float. Longitude coordinate for filtering local publications by geographic proximity. Used with sourceLat and sourceMaxDistance for radius search.
Float. Maximum distance in kilometers from the coordinates defined by sourceLat and sourceLon. Defines the radius for local publication searches.
String Array. Filter sources by their primary content categories such as Politics, Tech, Sports, Business, or Finance. Returns sources that frequently cover these topics. Multiple values create an OR filter.
String Array. Filter sources by their frequently covered topics (e.g., Markets, Cryptocurrency, Climate Change). Returns sources where the specified topic is among their top 10 covered areas. Multiple values create an OR filter.
String Array. Filter sources by their content label patterns (e.g., Opinion, Paid-news, Non-news). Returns sources where the specified label is common in their published content. See documentation for all available labels. Multiple values create an OR filter.
Boolean. Filter by paywall status. Set to true to find sources with paywalls, or false to find sources without paywalls.
Boolean. Controls whether subdomains are included as separate results. When true (default), subdomains appear as distinct sources. When false, results are consolidated to parent domains only.
Boolean. Controls whether to return the exact result count. When false (default), counts are capped at 10,000 for performance reasons. Set to true for precise counts in smaller result sets.
Response
200 - Success
Example response
{
"status": 200,
"numResults": 10000,
"results": [
{
"id": "372f1eb953ba4c9cbd3830c47db3342a",
"domain": "cnn.com",
"name": "CNN",
"updatedAt": "2025-08-10T00:30:03.716477+00:00",
"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": "CNN is a major U.S.-based media organization that provides coverage of world news, weather, entertainment, politics, and health.",
"avgMonthlyPosts": 3129,
"paywall": false,
"location": {
"country": "us",
"state": "NY",
"city": "New York",
"coordinates": {
"lat": 40.7127281,
"lon": -74.0060152
}
},
"topCategories": [
{
"name": "Politics",
"count": 1218
},
{
"name": "General",
"count": 801
},
{
"name": "Entertainment",
"count": 545
},
{
"name": "Lifestyle",
"count": 239
},
{
"name": "Business",
"count": 237
},
{
"name": "Sports",
"count": 233
},
{
"name": "World",
"count": 209
},
{
"name": "Health",
"count": 147
},
{
"name": "Travel",
"count": 135
},
{
"name": "Tech",
"count": 101
}
],
"topTopics": [
{
"name": "TV",
"count": 331
},
{
"name": "Podcasts",
"count": 328
},
{
"name": "Russia-Ukraine War",
"count": 151
},
{
"name": "US Politics",
"count": 142
},
{
"name": "Crime",
"count": 126
},
{
"name": "Media",
"count": 91
},
{
"name": "Social Issues",
"count": 85
},
{
"name": "Markets",
"count": 69
},
{
"name": "Middle East",
"count": 68
},
{
"name": "Epstein Case",
"count": 61
}
],
"topCountries": [
{
"name": "us",
"count": 3153
}
],
"topLabels": [
{
"name": "Non-news",
"count": 394
},
{
"name": "Roundup",
"count": 327
},
{
"name": "Paid News",
"count": 183
},
{
"name": "Opinion",
"count": 127
},
{
"name": "Feed",
"count": 41
},
{
"name": "Pop Culture",
"count": 32
},
{
"name": "Low Content",
"count": 29
},
{
"name": "Fact Check",
"count": 4
}
],
"avgBiasRating": "leansLeft",
"adFontesBiasRating": "Leans Left",
"allSidesBiasRating": "Leans Left",
"mbfcBiasRating": "Left",
"monthlyVisits": 471591456,
"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"
}
}
]
}