Skip to main content
POST
Search Episode Titles

Request contract

  • Method and path: POST /apis/v1/listennotes/find-episodes-by-title
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/listennotes/find-episodes-by-title
  • Runtime facts: 3f699076c1baf63c05edde2629715e34586e70ee0982cdee89366394f35facf8
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.0403 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.0403
  • Declared unit rate (USD): 1e-06
  • Billing unit: provider_credit
  • Cost contract: response_units
  • Published reference multiplier: 1.0
  • Declared maximum count/units: 10000000
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
q
string
required

An episode"s title, e.g., Jerusalem Demsas on The Dispossessed. You can use double quotes to do verbatim match, e.g., "Jerusalem Demsas on The Dispossessed". Otherwise, it"s fuzzy search.

podcast_id
string

Refine search results by specifying a podcast through its unique ID. The format of the podcast ID is governed by the podcast_id_type parameter. For listennotes_id, the podcast ID will look like "cda18f20f1be4ac7b3cce7d0eb168fff". For itunes_id, it will be a numerical value like "983795625". For spotify_id, expect a format like "0Z1234tGXD2hVhjFrrhJ7g". For rss, the podcast ID will be the RSS URL, e.g., "https://cowenconvos.libsyn.com/rss".

podcast_id_type
enum<string>
default:listennotes_id

The type of podcast id. Valid values are listennotes_id, itunes_id, spotify_id, and rss. Note: itunes_id is for Apple Podcasts.

Available options:
itunes_id,
listennotes_id,
rss,
spotify_id

Response

Tool result data

data
object
required