Journalists
GET {{baseUrl}}/v1/journalists?q=
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
apiKey | null | String. Can be found on the API Key page https://www.goperigon.com/account/api-key | |
q | null | String. Searches through name, title, twitterBio fields with priority given to the name, then to the title, then to the twitter bio. Returns results sorted by relevance. | |
name | null | String. Searches through journalist names, scores and ranks them, returns results sorted by relevance. | |
twitter | null | String. Searches for journalists by (exact match) twitter handle. | |
source | null | String. Searches journalists by source domain (based on the topSources data field). | |
country | string | String. Filter journalists by country. Use 2-letter country code in lowercase (ie. 'us' or 'gb'). (Searches the topCountries data field.) | |
topic | null | String. Filter journalists by the top topics they cover. Topics are more specific themes that the article is about. Examples of topics: 'Economy', 'Real Estate', 'Cryptocurrency'. If multiple parameters are passed, they will be applied as OR operations. (Searches inside the topCategories data field.) | |
category | null | String. Filter journalists by the top categories they cover. 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. (Searches inside the topCategories data field.) | |
label | null | String. Filter journalists by the most common label tagged to the articles they publish. This accepts labels like "Opinion" or "Pop Culture". (Searches the topLabels data field.) |
RESPONSES
status: OK
{"status":200,"numResults":1628,"results":[{"id":"dd9518041aa146e8bb46bedd30a5d985","name":"Matt Levine","title":"Columnist","locations":[],"topics":[],"sources":[],"twitterHandle":"matt_levine","twitterBio":"lunch valuation analyst","imageUrl":"","linkedinUrl":"http://www.linkedin.com/in/mattlevine2","facebookUrl":"https://www.facebook.com/mslevine","instagramUrl":"https://www.instagram.com/matt_levine_51/","websiteUrl":"https://t.co/I4EDMpoIgg","blogUrl":null,"tumblrUrl":"http://itsathingandyoucandoit.tumblr.com","youtubeUrl":null},{"id":"2b0faa4ae8524148befae3bbcb318866","name":"Aaron Levine","title":"Sports Director","locations":[],"topics":[],"sources":[],"twitterHandle":"AaronQ13Fox","twitterBio":"Q13 Fox Sports Director at KCPQ Seattle, host of Q It Up Sports, Seahawks Gameday, Seahawks Saturday Night and Talkin’ Huskies, contributor on #JustABitOutside","imageUrl":"","linkedinUrl":"https://www.linkedin.com/in/aaron-levine-15694410","facebookUrl":"https://www.facebook.com/aaron.levine.180","instagramUrl":null,"websiteUrl":"http://www.q13fox.com/sports","blogUrl":null,"tumblrUrl":null,"youtubeUrl":null},{"id":"6b4ff452255c40ef89f9f334b8f01466","name":"Al Levine","title":"Host","locations":[],"topics":[],"sources":[],"twitterHandle":null,"twitterBio":null,"imageUrl":"","linkedinUrl":null,"facebookUrl":"https://www.facebook.com/allevineonthescene/","instagramUrl":null,"websiteUrl":null,"blogUrl":null,"tumblrUrl":null,"youtubeUrl":null},{"id":"03f39467026748cca0f3988210466729","name":"Alexandra Levine","title":"Tech Reporter and Author, Morning Tech","locations":[],"topics":[],"sources":[],"twitterHandle":"Ali_Lev","twitterBio":"Tech + politics @POLITICO; formerly @NYTimes. Author @MorningTech and #FuturePulse newsletter on tech/healthcare.\nInsta: alexandra.levine | alevine@politico.com","imageUrl":"","linkedinUrl":"https://www.linkedin.com/in/alexandraslevine","facebookUrl":"https://www.facebook.com/alexandra.levine.75","instagramUrl":"https://www.instagram.com/alexandra.levine/?hl=en","websiteUrl":"https://t.co/riU5GFoIcT","blogUrl":null,"tumblrUrl":null,"youtubeUrl":null},{"id":"939d9a17ab16427ab96958021f26fb58","name":"Alice Levine","title":"Co-Host, Presenter","locations":[],"topics":[],"sources":[],"twitterHandle":"Alicelevine","twitterBio":"radio | @dadwroteaporno | tv","imageUrl":"","linkedinUrl":null,"facebookUrl":"https://www.facebook.com/alice.levine.315","instagramUrl":"https://www.instagram.com/thisisalicelevine/","websiteUrl":"https://www.bbc.co.uk/programmes/b03hjf53","blogUrl":"http://www.mydadwroteaporno.com/about/","tumblrUrl":null,"youtubeUrl":null},{"id":"357819bb6f9f4db0bed353f982611c88","name":"Barry Levine","title":"Freelance Technology Writer","locations":[],"topics":[],"sources":[],"twitterHandle":"xBarryLevine","twitterBio":"Freelance tech writer. Ex-Snr. MarTech Reporter at Marketing Land, MarTech Today, Search Engine Land, VentureBeat; + writing for Simon \u0026 Schuster, Viacom, PBS.","imageUrl":"","linkedinUrl":"https://www.linkedin.com/in/barrylevine1/","facebookUrl":"https://www.facebook.com/barry.levine.777","instagramUrl":"https://www.instagram.com/xBarryLevine/","websiteUrl":null,"blogUrl":null,"tumblrUrl":null,"youtubeUrl":null},{"id":"9958910224c74a388fc5d3660cd877da","name":"Barry Levine","title":"Homepage Editor","locations":[],"topics":[],"sources":[],"twitterHandle":null,"twitterBio":null,"imageUrl":"","linkedinUrl":null,"facebookUrl":"https://www.facebook.com/barry.levine.777","instagramUrl":null,"websiteUrl":null,"blogUrl":null,"tumblrUrl":null,"youtubeUrl":null},{"id":"ea814da5be7843b3bfc6657b147a4e89","name":"Beth Levine","title":"Freelance Writer and Editor","locations":[],"topics":[],"sources":[],"twitterHandle":null,"twitterBio":null,"imageUrl":"","linkedinUrl":"https://www.linkedin.com/in/betlevine","facebookUrl":null,"instagramUrl":null,"websiteUrl":"https://t.co/Zg827d1C1i","blogUrl":null,"tumblrUrl":null,"youtubeUrl":null},{"id":"5fd401dab36f4d98a58455950dee96dd","name":"Brittany Levine","title":"Assistant Editor","locations":[],"topics":[],"sources":[],"twitterHandle":"brittanylevine","twitterBio":"Story midwife for @Mashable, bringing new life into the media landscape. Tweets=my own. RT#endorsements. E: brittany@mashable.com","imageUrl":"","linkedinUrl":"https://www.linkedin.com/in/brittanylevine/","facebookUrl":"https://www.facebook.com/britt.r.levine","instagramUrl":null,"websiteUrl":"http://www.brittanyrlevine.wordpress.com/","blogUrl":null,"tumblrUrl":null,"youtubeUrl":null},{"id":"b2996a9cd4654c7cb51874fc5709c34e","name":"Carrie Levine","title":"Senior Reporter, Money and Democracy","locations":[],"topics":[],"sources":[],"twitterHandle":"levinecarrie","twitterBio":"Money and democracy reporter @publicintegrity. Reformed itinerant wanderer.","imageUrl":"","linkedinUrl":"https://www.linkedin.com/in/carrie-levine-a0a5123/","facebookUrl":"https://www.facebook.com/carrie.levine","instagramUrl":"https://www.instagram.com/levine.carrie/","websiteUrl":"https://publicintegrity.org/author/carrie-levine","blogUrl":null,"tumblrUrl":null,"youtubeUrl":null}]}