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

Ratings

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.

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

Sponsored

Shows that usually accept sponsors or advertisers: sponsored:is:true

Sponsors

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

Professions

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

Interests

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

Guests

Podcasts that we think take guests on some or all episodes: guests:is:true

YouTube

Shows that have an associated YouTube channel: youtube:is:true

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
  • twicemonthly
  • weekly
  • twiceweekly
  • 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 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

Political Leaning

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
Age Groups

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
Relationship Status

Shows with an audience likely to be single: relationship_statuses:any:single

Allowed values:

  • single
  • relationship
  • married
Education Level

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
Household Income

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

Cross Promos

Shows that we think do cross promotions with other podcasts: cross_promos:is:true

Branded

Shows that we think are branded podcasts (created/produced by a company or organization): branded:is:true

Parents

Shows where we think the audience is primarily parents: parents:is:true