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 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 45 days: active:is:true

Shows that we think take guests on some or all episodes: formats:any:guests

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
• twiceweekly
• weekly
• 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 (i.e. first episode published) 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