PerigonInstall

Summary

Search media sources by name and optional filters such as category, country, domain, monthly visits, paywall status, and others to retrieve a list of matched sources.

Inputs

• Name — Search by media source name with support for Boolean operators (AND, OR, NOT) and wildcards.
• Category — Filter results by primary content categories, specified as a comma-separated list.
• Country — Filter results by country codes, specified as a comma-separated list.
• Domain — Filter sources by domain names supporting wildcards, comma-separated.
• Max Monthly Visits — Include only sources with no more than this many monthly visitors.
• Min Monthly Visits — Include only sources with at least this many monthly visitors.
• Page — Specify the zero-based page number for paginating results.
• Paywall — Filter sources by whether they have a paywall.
• Show Num Results — Return the total count of matched sources along with the results.
• Size — Number of results to return, between 1 and 100.
• Sort By — Sort results by relevance, global rank, monthly visits, or average monthly posts.
• Source Group — Filter by predefined publisher bundles.

Output shape

a list of media source records matching the search criteria

Results support pagination via 'page' and 'size'. If 'showNumResults' is true, the total number of matched sources is included. Returned data structure depends on the Perigon API response schema for sources.

Examples

Example 1: Search for sources named 'CNN OR BBC' in the 'Tech' category from US or GB domains with a minimum of 10000 monthly visits, sorted by monthly visits, returning up to 20 results on page 0.

Name='CNN OR BBC', Category='Tech', Country='us,gb', Min Monthly Visits=10000, Sort By='monthlyVisits', Size=20, Page=0