Create podcast via form data

curl --request POST \
  --url https://api.aisa.one/apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": "<string>",
  "rsses": "<string>",
  "itunes_ids": "<string>",
  "spotify_ids": "<string>",
  "show_latest_episodes": 0,
  "next_episode_pub_date": 123
}
'

import requests

url = "https://api.aisa.one/apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts"

payload = {
    "ids": "<string>",
    "rsses": "<string>",
    "itunes_ids": "<string>",
    "spotify_ids": "<string>",
    "show_latest_episodes": 0,
    "next_episode_pub_date": 123
}
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({
    ids: '<string>',
    rsses: '<string>',
    itunes_ids: '<string>',
    spotify_ids: '<string>',
    show_latest_episodes: 0,
    next_episode_pub_date: 123
  })
};

fetch('https://api.aisa.one/apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts', 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/batch-fetch-basic-meta-data-for-podcasts",
  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([
    'ids' => '<string>',
    'rsses' => '<string>',
    'itunes_ids' => '<string>',
    'spotify_ids' => '<string>',
    'show_latest_episodes' => 0,
    'next_episode_pub_date' => 123
  ]),
  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/batch-fetch-basic-meta-data-for-podcasts"

	payload := strings.NewReader("{\n  \"ids\": \"<string>\",\n  \"rsses\": \"<string>\",\n  \"itunes_ids\": \"<string>\",\n  \"spotify_ids\": \"<string>\",\n  \"show_latest_episodes\": 0,\n  \"next_episode_pub_date\": 123\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/batch-fetch-basic-meta-data-for-podcasts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ids\": \"<string>\",\n  \"rsses\": \"<string>\",\n  \"itunes_ids\": \"<string>\",\n  \"spotify_ids\": \"<string>\",\n  \"show_latest_episodes\": 0,\n  \"next_episode_pub_date\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts")

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  \"ids\": \"<string>\",\n  \"rsses\": \"<string>\",\n  \"itunes_ids\": \"<string>\",\n  \"spotify_ids\": \"<string>\",\n  \"show_latest_episodes\": 0,\n  \"next_episode_pub_date\": 123\n}"

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

{
  "data": {
    "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%"
      }
    ],
    "latest_episodes": [
      {
        "id": "4d82e50314174754a3b603912448e812",
        "link": "https://www.npr.org/2020/01/22/798532179/soleimanis-iran",
        "audio": "https://www.listennotes.com/e/p/11b34041e804491b9704d11f283c74de/",
        "image": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.1400x1400.jpg",
        "title": "Celebration Recap, Jason Fry and Christian Blauvelt Interviews – SWBW #101",
        "podcast": {
          "id": "4d3fe717742d4963a85562e9f84d8c79",
          "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!",
          "publisher": "Planet Broadcasting",
          "thumbnail": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg",
          "listen_score": 81,
          "listennotes_url": "https://www.listennotes.com/c/4d3fe717742d4963a85562e9f84d8c79/",
          "listen_score_global_rank": "0.5%"
        },
        "thumbnail": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg",
        "description": "<p>Disney chief Bob Iger shared news about Star Wars movies in 2020 and beyond, but some media outlets gave conflicting reports about it. Here's the real scoop. Punch it!</p> <p>***We’re listener supported! Go to http://Patreon.com/sw7x7 to donate to the Star Wars 7x7 podcast, and you’ll get some fabulous rewards for your pledge.*** </p> <p>Check out SW7x7.com for full Star Wars 7x7 show notes and links, and to comment on any of the content of this episode! If you like what you've heard, please leave us a rating or review on iTunes or Stitcher, which will also help more people discover this Star Wars podcast.</p> <p>Don't forget to join the Star Wars 7x7 fun on Facebook at Facebook.com/SW7x7, and follow the breaking news Twitter feed at Twitter.com/SW7x7Podcast. We're also on Pinterest and Instagram as \"SW7x7\" too, and we'd love to connect with you there!</p>\n",
        "pub_date_ms": 1474873200000,
        "listennotes_url": "https://www.listennotes.com/e/4d82e50314174754a3b603912448e812/",
        "audio_length_sec": 567,
        "explicit_content": false,
        "maybe_audio_invalid": false,
        "listennotes_edit_url": "https://www.listennotes.com/e/11b34041e804491b9704d11f283c74de/#edit"
      }
    ]
  }
}

POST

https://api.aisa.one

apis

listennotes

batch-fetch-basic-meta-data-for-podcasts

Create podcast via form data

curl --request POST \
  --url https://api.aisa.one/apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": "<string>",
  "rsses": "<string>",
  "itunes_ids": "<string>",
  "spotify_ids": "<string>",
  "show_latest_episodes": 0,
  "next_episode_pub_date": 123
}
'

import requests

url = "https://api.aisa.one/apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts"

payload = {
    "ids": "<string>",
    "rsses": "<string>",
    "itunes_ids": "<string>",
    "spotify_ids": "<string>",
    "show_latest_episodes": 0,
    "next_episode_pub_date": 123
}
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({
    ids: '<string>',
    rsses: '<string>',
    itunes_ids: '<string>',
    spotify_ids: '<string>',
    show_latest_episodes: 0,
    next_episode_pub_date: 123
  })
};

fetch('https://api.aisa.one/apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts', 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/batch-fetch-basic-meta-data-for-podcasts",
  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([
    'ids' => '<string>',
    'rsses' => '<string>',
    'itunes_ids' => '<string>',
    'spotify_ids' => '<string>',
    'show_latest_episodes' => 0,
    'next_episode_pub_date' => 123
  ]),
  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/batch-fetch-basic-meta-data-for-podcasts"

	payload := strings.NewReader("{\n  \"ids\": \"<string>\",\n  \"rsses\": \"<string>\",\n  \"itunes_ids\": \"<string>\",\n  \"spotify_ids\": \"<string>\",\n  \"show_latest_episodes\": 0,\n  \"next_episode_pub_date\": 123\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/batch-fetch-basic-meta-data-for-podcasts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ids\": \"<string>\",\n  \"rsses\": \"<string>\",\n  \"itunes_ids\": \"<string>\",\n  \"spotify_ids\": \"<string>\",\n  \"show_latest_episodes\": 0,\n  \"next_episode_pub_date\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts")

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  \"ids\": \"<string>\",\n  \"rsses\": \"<string>\",\n  \"itunes_ids\": \"<string>\",\n  \"spotify_ids\": \"<string>\",\n  \"show_latest_episodes\": 0,\n  \"next_episode_pub_date\": 123\n}"

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

{
  "data": {
    "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%"
      }
    ],
    "latest_episodes": [
      {
        "id": "4d82e50314174754a3b603912448e812",
        "link": "https://www.npr.org/2020/01/22/798532179/soleimanis-iran",
        "audio": "https://www.listennotes.com/e/p/11b34041e804491b9704d11f283c74de/",
        "image": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.1400x1400.jpg",
        "title": "Celebration Recap, Jason Fry and Christian Blauvelt Interviews – SWBW #101",
        "podcast": {
          "id": "4d3fe717742d4963a85562e9f84d8c79",
          "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!",
          "publisher": "Planet Broadcasting",
          "thumbnail": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg",
          "listen_score": 81,
          "listennotes_url": "https://www.listennotes.com/c/4d3fe717742d4963a85562e9f84d8c79/",
          "listen_score_global_rank": "0.5%"
        },
        "thumbnail": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg",
        "description": "<p>Disney chief Bob Iger shared news about Star Wars movies in 2020 and beyond, but some media outlets gave conflicting reports about it. Here's the real scoop. Punch it!</p> <p>***We’re listener supported! Go to http://Patreon.com/sw7x7 to donate to the Star Wars 7x7 podcast, and you’ll get some fabulous rewards for your pledge.*** </p> <p>Check out SW7x7.com for full Star Wars 7x7 show notes and links, and to comment on any of the content of this episode! If you like what you've heard, please leave us a rating or review on iTunes or Stitcher, which will also help more people discover this Star Wars podcast.</p> <p>Don't forget to join the Star Wars 7x7 fun on Facebook at Facebook.com/SW7x7, and follow the breaking news Twitter feed at Twitter.com/SW7x7Podcast. We're also on Pinterest and Instagram as \"SW7x7\" too, and we'd love to connect with you there!</p>\n",
        "pub_date_ms": 1474873200000,
        "listennotes_url": "https://www.listennotes.com/e/4d82e50314174754a3b603912448e812/",
        "audio_length_sec": 567,
        "explicit_content": false,
        "maybe_audio_invalid": false,
        "listennotes_edit_url": "https://www.listennotes.com/e/11b34041e804491b9704d11f283c74de/#edit"
      }
    ]
  }
}

Request contract

Method and path: POST /apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts
Runtime facts: 3f699076c1baf63c05edde2629715e34586e70ee0982cdee89366394f35facf8

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

{
  "operationId": "listennotes.batch-fetch-basic-meta-data-for-podcasts",
  "method": "POST",
  "path": "/apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "required": false,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "ids": {
              "type": "string",
              "description": "Comma-separated list of podcast ids."
            },
            "rsses": {
              "type": "string",
              "description": "Comma-separated rss urls."
            },
            "itunes_ids": {
              "type": "string",
              "description": "Comma-separated Apple Podcasts (iTunes) ids, e.g., 659155419"
            },
            "spotify_ids": {
              "type": "string",
              "description": "Comma-separated Spotify ids, e.g., 3DDfEsKDIDrTlnPOiG4ZF4"
            },
            "show_latest_episodes": {
              "type": "integer",
              "default": 0,
              "description": "Whether or not to fetch up to 15 latest episodes from these podcasts, sorted by pub_date. 1 is yes, and 0 is no.  "
            },
            "next_episode_pub_date": {
              "type": "integer",
              "description": "For latest episodes pagination. It\"s the value of **next_episode_pub_date** from the response of last request. If not specified, just return latest 15 episodes.  "
            }
          }
        }
      }
    }
  },
  "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

ids

string

Comma-separated list of podcast ids.

rsses

string

Comma-separated rss urls.

itunes_ids

string

Comma-separated Apple Podcasts (iTunes) ids, e.g., 659155419

spotify_ids

string

Comma-separated Spotify ids, e.g., 3DDfEsKDIDrTlnPOiG4ZF4

show_latest_episodes

integer

default:0

Whether or not to fetch up to 15 latest episodes from these podcasts, sorted by pub_date. 1 is yes, and 0 is no.

next_episode_pub_date

integer

For latest episodes pagination. It"s the value of next_episode_pub_date from the response of last request. If not specified, just return latest 15 episodes.

Response

Tool result data

data

object

required

Show child attributes