Fetch best podcasts list

curl --request POST \
  --url https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "page": 123,
  "sort": "recent_added_first",
  "region": "us",
  "genre_id": "<string>",
  "language": "<string>",
  "safe_mode": 0,
  "publisher_region": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre"

payload = {
    "page": 123,
    "sort": "recent_added_first",
    "region": "us",
    "genre_id": "<string>",
    "language": "<string>",
    "safe_mode": 0,
    "publisher_region": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    page: 123,
    sort: 'recent_added_first',
    region: 'us',
    genre_id: '<string>',
    language: '<string>',
    safe_mode: 0,
    publisher_region: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'page' => 123,
    'sort' => 'recent_added_first',
    'region' => 'us',
    'genre_id' => '<string>',
    'language' => '<string>',
    'safe_mode' => 0,
    'publisher_region' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre"

	payload := strings.NewReader("{\n  \"page\": 123,\n  \"sort\": \"recent_added_first\",\n  \"region\": \"us\",\n  \"genre_id\": \"<string>\",\n  \"language\": \"<string>\",\n  \"safe_mode\": 0,\n  \"publisher_region\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"page\": 123,\n  \"sort\": \"recent_added_first\",\n  \"region\": \"us\",\n  \"genre_id\": \"<string>\",\n  \"language\": \"<string>\",\n  \"safe_mode\": 0,\n  \"publisher_region\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"page\": 123,\n  \"sort\": \"recent_added_first\",\n  \"region\": \"us\",\n  \"genre_id\": \"<string>\",\n  \"language\": \"<string>\",\n  \"safe_mode\": 0,\n  \"publisher_region\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": 95,
    "name": "Business News",
    "total": 325,
    "has_next": true,
    "podcasts": [
      {
        "id": "4d3fe717742d4963a85562e9f84d8c79",
        "rss": "https://sw7x7.libsyn.com/rss",
        "type": "episodic",
        "email": "hello@example.com",
        "extra": {
          "url1": "<string>",
          "url2": "<string>",
          "url3": "<string>",
          "spotify_url": "https://open.spotify.com/show/2rQJUP9Y3HxemiW3JHt9WV",
          "youtube_url": "https://www.youtube.com/sw7x7",
          "linkedin_url": "<string>",
          "wechat_handle": "<string>",
          "patreon_handle": "sw7x7",
          "twitter_handle": "SW7x7podcast",
          "facebook_handle": "sw7x7",
          "amazon_music_url": "https://music.amazon.com/podcasts/6fc6d683-9ef3-4850-9c35-8e8b1a42a147/the-lock-sportscast",
          "instagram_handle": "sw7x7"
        },
        "image": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.1400x1400.jpg",
        "title": "Star Wars 7x7 | Star Wars News, Interviews, and More!",
        "country": "United States",
        "website": "http://sw7x7.com/",
        "language": "English",
        "genre_ids": [
          138,
          86,
          160,
          68,
          82,
          100,
          101
        ],
        "itunes_id": 896354638,
        "publisher": "Planet Broadcasting",
        "thumbnail": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg",
        "is_claimed": true,
        "description": "<p>The Star Wars 7x7 Podcast is Rebel-rousing fun for everyday Jedi, between 7 and 14 minutes a day, 7 days a week. Join host Allen Voivod for Star Wars news, history, interviews, trivia, and deep dives into the Star Wars story as told in movies, books, comics, games, cartoons, and more. Subscribe now for your daily dose of Star Wars joy. It's destiny unleashed!</p>",
        "looking_for": {
          "guests": true,
          "cohosts": true,
          "sponsors": true,
          "cross_promotion": true
        },
        "has_sponsors": false,
        "listen_score": 81,
        "total_episodes": 324,
        "listennotes_url": "https://www.listennotes.com/c/4d3fe717742d4963a85562e9f84d8c79/",
        "audio_length_sec": 1291,
        "explicit_content": false,
        "latest_episode_id": "d057092e57cc4ced80e0efaa196593d9",
        "latest_pub_date_ms": 1557499770000,
        "earliest_pub_date_ms": 1470667902000,
        "has_guest_interviews": false,
        "update_frequency_hours": 168,
        "listen_score_global_rank": "0.5%"
      }
    ],
    "parent_id": 93,
    "page_number": 2,
    "has_previous": true,
    "listennotes_url": "https://www.listennotes.com/best-business-news-podcasts-95/",
    "next_page_number": 3,
    "previous_page_number": 1
  }
}

POST

https://api.aisa.one

apis

listennotes

fetch-a-list-of-best-podcasts-by-genre

Fetch best podcasts list

curl --request POST \
  --url https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "page": 123,
  "sort": "recent_added_first",
  "region": "us",
  "genre_id": "<string>",
  "language": "<string>",
  "safe_mode": 0,
  "publisher_region": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre"

payload = {
    "page": 123,
    "sort": "recent_added_first",
    "region": "us",
    "genre_id": "<string>",
    "language": "<string>",
    "safe_mode": 0,
    "publisher_region": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    page: 123,
    sort: 'recent_added_first',
    region: 'us',
    genre_id: '<string>',
    language: '<string>',
    safe_mode: 0,
    publisher_region: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'page' => 123,
    'sort' => 'recent_added_first',
    'region' => 'us',
    'genre_id' => '<string>',
    'language' => '<string>',
    'safe_mode' => 0,
    'publisher_region' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre"

	payload := strings.NewReader("{\n  \"page\": 123,\n  \"sort\": \"recent_added_first\",\n  \"region\": \"us\",\n  \"genre_id\": \"<string>\",\n  \"language\": \"<string>\",\n  \"safe_mode\": 0,\n  \"publisher_region\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"page\": 123,\n  \"sort\": \"recent_added_first\",\n  \"region\": \"us\",\n  \"genre_id\": \"<string>\",\n  \"language\": \"<string>\",\n  \"safe_mode\": 0,\n  \"publisher_region\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"page\": 123,\n  \"sort\": \"recent_added_first\",\n  \"region\": \"us\",\n  \"genre_id\": \"<string>\",\n  \"language\": \"<string>\",\n  \"safe_mode\": 0,\n  \"publisher_region\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": 95,
    "name": "Business News",
    "total": 325,
    "has_next": true,
    "podcasts": [
      {
        "id": "4d3fe717742d4963a85562e9f84d8c79",
        "rss": "https://sw7x7.libsyn.com/rss",
        "type": "episodic",
        "email": "hello@example.com",
        "extra": {
          "url1": "<string>",
          "url2": "<string>",
          "url3": "<string>",
          "spotify_url": "https://open.spotify.com/show/2rQJUP9Y3HxemiW3JHt9WV",
          "youtube_url": "https://www.youtube.com/sw7x7",
          "linkedin_url": "<string>",
          "wechat_handle": "<string>",
          "patreon_handle": "sw7x7",
          "twitter_handle": "SW7x7podcast",
          "facebook_handle": "sw7x7",
          "amazon_music_url": "https://music.amazon.com/podcasts/6fc6d683-9ef3-4850-9c35-8e8b1a42a147/the-lock-sportscast",
          "instagram_handle": "sw7x7"
        },
        "image": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.1400x1400.jpg",
        "title": "Star Wars 7x7 | Star Wars News, Interviews, and More!",
        "country": "United States",
        "website": "http://sw7x7.com/",
        "language": "English",
        "genre_ids": [
          138,
          86,
          160,
          68,
          82,
          100,
          101
        ],
        "itunes_id": 896354638,
        "publisher": "Planet Broadcasting",
        "thumbnail": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg",
        "is_claimed": true,
        "description": "<p>The Star Wars 7x7 Podcast is Rebel-rousing fun for everyday Jedi, between 7 and 14 minutes a day, 7 days a week. Join host Allen Voivod for Star Wars news, history, interviews, trivia, and deep dives into the Star Wars story as told in movies, books, comics, games, cartoons, and more. Subscribe now for your daily dose of Star Wars joy. It's destiny unleashed!</p>",
        "looking_for": {
          "guests": true,
          "cohosts": true,
          "sponsors": true,
          "cross_promotion": true
        },
        "has_sponsors": false,
        "listen_score": 81,
        "total_episodes": 324,
        "listennotes_url": "https://www.listennotes.com/c/4d3fe717742d4963a85562e9f84d8c79/",
        "audio_length_sec": 1291,
        "explicit_content": false,
        "latest_episode_id": "d057092e57cc4ced80e0efaa196593d9",
        "latest_pub_date_ms": 1557499770000,
        "earliest_pub_date_ms": 1470667902000,
        "has_guest_interviews": false,
        "update_frequency_hours": 168,
        "listen_score_global_rank": "0.5%"
      }
    ],
    "parent_id": 93,
    "page_number": 2,
    "has_previous": true,
    "listennotes_url": "https://www.listennotes.com/best-business-news-podcasts-95/",
    "next_page_number": 3,
    "previous_page_number": 1
  }
}

Request contract

Method and path: POST /apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre
Runtime facts: 3f699076c1baf63c05edde2629715e34586e70ee0982cdee89366394f35facf8

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "listennotes.fetch-a-list-of-best-podcasts-by-genre",
  "method": "POST",
  "path": "/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "required": false,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "page": {
              "type": "integer",
              "description": "Page number of those podcasts in this genre."
            },
            "sort": {
              "enum": [
                "listen_score",
                "oldest_added_first",
                "oldest_published_first",
                "recent_added_first",
                "recent_published_first"
              ],
              "type": "string",
              "default": "recent_added_first",
              "description": "How do you want to sort these podcasts? If you\"d like to sort by popularity, please use **listen_score**.  "
            },
            "region": {
              "type": "string",
              "default": "us",
              "description": "Filter best podcasts by country/region. Please note that podcasts that are \"best\" in a country/region may not be produced in that country/region. For example, a podcast from the US may be very popular in Canada. You can get the supported country codes (e.g., us, jp, gb...) from `GET /regions`. If not specified, you\"ll get \"best podcasts\" in United States.  "
            },
            "genre_id": {
              "type": "string",
              "description": "You can get the id from `GET /genres`. If not specified, it\"ll be the overall best podcasts, which can be considered as a special genre. "
            },
            "language": {
              "type": "string",
              "description": "Filter best podcasts by language. You can get a list of supported languages (e.g., English, Chinese, Japanese...) from `GET /languages`. If not specified, you\"ll get \"best podcasts\" in any language.  "
            },
            "safe_mode": {
              "type": "integer",
              "default": 0,
              "description": "Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no. "
            },
            "publisher_region": {
              "type": "string",
              "description": "Filter best podcasts by the publisher\"s country/region. This is to narrow down the results to include \"best podcasts\" produced in a specific country/region. You can get the supported country codes (e.g., us, jp, gb...) from `GET /regions`. If not specified, you\"ll get \"best podcasts\" produced in any country/region. If you want to get a country/region\"s \"best podcasts\" that are also produced in that country/region, then you need to specify both **region** and **publisher_region**, e.g., `region=jp` and `publisher_region=jp`.  "
            }
          }
        }
      }
    }
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "response_units",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.0403,
    "estimate_source": "profile_seed",
    "evidence_source": "response_body",
    "maximum_units": 10000000,
    "unit": "provider_credit",
    "unit_rate_usd": 1e-06
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

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

page

integer

Page number of those podcasts in this genre.

sort

enum<string>

default:recent_added_first

How do you want to sort these podcasts? If you"d like to sort by popularity, please use listen_score.

Available options:

listen_score,

oldest_added_first,

oldest_published_first,

recent_added_first,

recent_published_first

region

string

default:us

Filter best podcasts by country/region. Please note that podcasts that are "best" in a country/region may not be produced in that country/region. For example, a podcast from the US may be very popular in Canada. You can get the supported country codes (e.g., us, jp, gb...) from GET /regions. If not specified, you"ll get "best podcasts" in United States.

genre_id

string

You can get the id from GET /genres. If not specified, it"ll be the overall best podcasts, which can be considered as a special genre.

language

string

Filter best podcasts by language. You can get a list of supported languages (e.g., English, Chinese, Japanese...) from GET /languages. If not specified, you"ll get "best podcasts" in any language.

safe_mode

integer

default:0

Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.

publisher_region

string

Filter best podcasts by the publisher"s country/region. This is to narrow down the results to include "best podcasts" produced in a specific country/region. You can get the supported country codes (e.g., us, jp, gb...) from GET /regions. If not specified, you"ll get "best podcasts" produced in any country/region. If you want to get a country/region"s "best podcasts" that are also produced in that country/region, then you need to specify both region and publisher_region, e.g., region=jp and publisher_region=jp.

Response

Tool result data

data

object

required

Show child attributes