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
  }
}

请求规范

方法与路径: POST /apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre
可用状态: enabled
请求 URL 模板: https://api.aisa.one/apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre
Runtime 事实版本: 3f699076c1baf63c05edde2629715e34586e70ee0982cdee89366394f35facf8

完整 OpenAPI 定义有效请求与价格声明（包括认证和引用的 schema）：

{
  "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"
      }
    }
  }
}

费用与请求规则

按用量计费；默认请求预估费用：$0.0403 USD（不是固定价格）。声明的单位费率：每 provider_credit $0.000001 USD。最终费用以账户适用价格及实际结算为准。公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。

默认请求参考估价（USD）: 0.0403
声明的单位费率（USD）: 1e-06
计费单位: provider_credit
计费依据: response_units
公开参考倍率: 1.0
声明的最大计数或单位数: 10000000
结算证据来源: response_body

授权

Authorization

string

header

必填

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

请求体

application/json

page

integer

Page number of those podcasts in this genre.

sort

enum<string>

默认值:recent_added_first

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

可用选项:

listen_score,

oldest_added_first,

oldest_published_first,

recent_added_first,

recent_published_first

region

string

默认值: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

默认值: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.

响应

Tool result data

data

object

必填

Show child attributes