Rephonic

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

Listeners

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

Social Reach

Shows with a social media reach (combined followers across all social media accounts) greater than or equal to 10000: social_reach:gte:10000

Categories

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

Audience Location

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

Languages

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

Genders

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

Active

Shows that have published an episode within the past 45 days: active:is:true

Formats

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

Engagement

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

Publishes

Allowed values:

  • infrequently
  • monthly
  • twiceweekly
  • weekly
  • daily

Shows that publish episodes daily: frequencies:any:daily

Episodes

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

Founded

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