PerigonInstall

Summary

Search journalists by detailed criteria including name, title, Twitter bio, and various filters such as category, country, source domains, topics, publication frequency, and unique IDs, supporting pagination and result count display.

Inputs

• Query — Search journalists by name, title, or Twitter bio using Boolean operators.
• Category — Filter journalists by one or more categories they cover (comma-separated).
• Country — Filter journalists by one or more countries they commonly cover (comma-separated).
• Journalist ID — Filter results by specific unique journalist IDs (comma-separated).
• Max Monthly Posts — Limit results to journalists who publish no more than this many articles per month.
• Min Monthly Posts — Limit results to journalists who publish at least this many articles per month.
• Name — Search journalists by name with Boolean operator support.
• Page — Specify the zero-based page number for pagination of results.
• Show Num Results — Choose whether to include the total number of matched journalists in the response.
• Size — Number of result items to return (1-1000).
• Source — Filter journalists by publisher domains they are associated with (comma-separated).
• Topic — Filter journalists by topics they cover (comma-separated).

Output shape

a JSON object containing a list of journalist records matching the search criteria, including pagination metadata when applicable.

Results are paginated based on 'Page' and 'Size' inputs. If 'Show Num Results' is enabled, the total count of matched journalists is included. Filtering inputs support comma-separated lists. Search supports Boolean operators in 'Query' and 'Name' fields.

Examples

Example 1: Find tech journalists in the US covering politics who publish at least 5 articles per month.

Query blank, Category='Tech', Country='us', Topic='Politics', Min Monthly Posts=5, Page=0, Size=20.