API: Search Filters
This page forms part of the Rephonic API documentation.
You can optionally pass a comma-separated list of filters to the podcast search or episode search endpoints. For example:
/api/search/podcasts/?filters=listeners:gte:5000,active:is:true
Shows with an estimated listeners (downloads per episode) greater than or equal to 5000: listeners:gte:5000
Shows with estimated listeners less than or equal to 250000: listeners:lte:250000
Shows that have been rated by listeners greater than or equal to 500 times: ratings:gte:500
Shows that have been rated by listeners less than or equal to 10 times: ratings:lte:10
It counts ratings across every app that Rephonic tracks.
Shows with a social media reach (combined followers across all social media accounts) greater than or equal to 10000: social_reach:gte:10000
You can find a list of category codes at /api/common/categories/.
Shows in the Arts / Books category: categories:in:1482
Shows that are in the Arts / Books category and also in the Arts / Visual Arts category: categories:in:1482-1406
Shows that are in any of the Arts / Books category or the Arts / Visual Arts category: categories:any:1482-1406
Refer to /api/common/countries/ to get a list of allowed locations.
Shows where the primary audience is located in the United States: locations:any:us
Shows where the primary audience is located in France or Italy: locations:any:it-fr
Refer to /api/common/languages/ to get a list of allowed languages.
Spanish language shows: languages:any:es
English, Spanish and French language shows: languages:any:en-es-fr
Allowed values:
- verymale
- male
- neutral
- female
- veryfemale
Shows where we estimate the gender skew to be very female: genders:any:veryfemale
Shows where we estimate the gender skew to be neutral or female: genders:any:neutral-female
Shows that have published an episode within the past 60 days: active:is:true
Shows that usually accept sponsors or advertisers: sponsored:is:true
Shows that were sponsored by either IBM, Apple or Microsoft in at least one episode: sponsors:any:IBM-Apple-Microsoft
Refer to /api/common/sponsors/ to get a list of commonly seen sponsors. You can pass in ?query=abc to filter the list.
Values containing reserved characters -,:\ must be correctly escaped with a backslash, e.g. sponsors:any:Harley\-Davidson-Apple-IBM
Shows where the audience is likely made up of doctors or lawyers: professions:any:Doctor-Lawyer
Shows where the audience is likely made up of both doctors and lawyers: professions:in:Doctor-Lawyer
Refer to /api/common/professions/ to get a list of commonly seen professions. You can pass in ?query=abc to filter the list.
Values containing reserved characters -,:\ must be correctly escaped with a backslash, e.g. sponsors:any:Harley\-Davidson-Apple-IBM
Shows where the audience is likely made up of people interested in cars or technology: interests:any:Cars-Technology
Shows where the audience is likely made up of people interested in both cars and technology: interests:in:Cars-Technology
Refer to /api/common/interests/ to get a list of commonly seen interests. You can pass in ?query=abc to filter the list.
Values containing reserved characters -,:\ must be correctly escaped with a backslash, e.g. sponsors:any:Harley\-Davidson-Apple-IBM
Podcasts that we think take guests on some or all episodes: guests:is:true
Shows that have an associated YouTube channel: youtube:is:true
Shows with an engagement score greater than or equal to 75: engagement:gte:75
Shows with an engagement score less than or equal to 45: engagement:lte:45
Allowed values:
- infrequently
- monthly
- twicemonthly
- weekly
- twiceweekly
- daily
Shows that publish episodes daily: frequencies:any:daily
Shows that have published greater than or equal to 500 episodes: episodes:gte:500
Shows that have published less than or equal to 10 episodes: episodes:lte:10
Shows that we think were founded on or after 2018-01-30: founded:gte:1517270400
Shows that we think were founded between 2018-01-30 and 2020-05-20: founded:gte:1517270400,founded:lte:1589932800
Shows with a left-wing or center-left audience: political_leanings:any:left-center_left
Allowed values:
- hard_left
- left
- center_left
- center
- center_right
- right
- hard_right
Shows with an audience likely to be aged 18-24 or 25-34: age_groups:any:18_24-25_34
Shows with an audience likely to contain both 18-24 and 25-34: age_groups:in:18_24-25_34
Allowed values:
- under_18
- 18_24
- 25_34
- 35_44
- 45_54
- 55_64
- 65_plus
Shows with an audience likely to be single: relationship_statuses:any:single
Allowed values:
- single
- relationship
- married
Shows with an audience likely to have a higher education degree: education_levels:any:bachelors_degree-masters_degree-advanced_degree
Shows with an audience likely to have both a bachelor's degree and a master's degree: education_levels:in:bachelors_degree-masters_degree
Allowed values:
- less_than_high_school
- high_school
- bachelors_degree
- masters_degree
- advanced_degree
Shows with an audience likely to have an annual household income greater than or equal to $75,000 USD: household_income:gte:75000
Shows with an audience likely to have an annual household income less than or equal to $150,000 USD: household_income:lte:150000
Shows that we think do cross promotions with other podcasts: cross_promos:is:true
Shows that we think are branded podcasts (created/produced by a company or organization): branded:is:true
Shows where we think the audience is primarily parents: parents:is:true