Search operation endpoint
curl --request POST \
--url https://api.aisa.one/apis/v1/listennotes/full-text-search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"q": "<string>"
}
'import requests
url = "https://api.aisa.one/apis/v1/listennotes/full-text-search"
payload = { "q": "<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({q: '<string>'})
};
fetch('https://api.aisa.one/apis/v1/listennotes/full-text-search', 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/full-text-search",
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([
'q' => '<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/full-text-search"
payload := strings.NewReader("{\n \"q\": \"<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/full-text-search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"q\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/listennotes/full-text-search")
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 \"q\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"took": 0.093,
"count": 10,
"total": 1989,
"results": [
{
"id": "4d82e50314174754a3b603912448e812",
"rss": "https://sw7x7.libsyn.com/rss",
"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",
"podcast": {
"id": "4d3fe717742d4963a85562e9f84d8c79",
"image": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.1400x1400.jpg",
"genre_ids": [
138,
86,
160,
68,
82,
100,
101
],
"thumbnail": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg",
"listen_score": 81,
"title_original": "Star Wars 7x7 | Star Wars News, Interviews, and More!",
"listennotes_url": "https://www.listennotes.com/c/4d3fe717742d4963a85562e9f84d8c79/",
"title_highlighted": "<span class=\\\"ln-search-highlight\\\">Star</span> <span class=\\\"ln-search-highlight\\\">Wars</span> 7x7 | <span class=\\\"ln-search-highlight\\\">Star</span> <span class=\\\"ln-search-highlight\\\">Wars</span> News, Interviews, and More!",
"publisher_original": "Star Wars Daily, by Allen Voivod",
"publisher_highlighted": "<span class=\\\"ln-search-highlight\\\">Star</span> <span class=\\\"ln-search-highlight\\\">Wars</span> Daily, by Allen Voivod",
"listen_score_global_rank": "0.5%"
},
"itunes_id": 896354638,
"thumbnail": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg",
"pub_date_ms": 1474873200000,
"title_original": "815: Star Wars 2020 Movie and Beyond!",
"listennotes_url": "https://www.listennotes.com/e/4d82e50314174754a3b603912448e812/",
"audio_length_sec": 567,
"explicit_content": false,
"title_highlighted": "815: <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> 2020 Movie and Beyond!",
"description_original": "Yeah, Star Wars Celebration Orlando is 32 days away, but what's the scoop on Celebration 2018? Plus, Rebels Day is Saturday, and much more in our update. Punch it! ***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.*** 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. 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!\n",
"description_highlighted": "...Go to http://Patreon.com/sw7x7 to donate to the <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> 7x7 podcast, and you'll get some fabulous rewards for your pledge.*** Check out SW7x7.com for full <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> 7x7 show notes and links, and to\n",
"transcripts_highlighted": [
"<string>"
]
}
],
"next_offset": 10
}
}Listen Notes
Search operation endpoint
<!-- aisa-pricing:start -->
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.
<!-- aisa-pricing:end -->
POST
https://api.aisa.one
/
apis
/
v1
/
listennotes
/
full-text-search
Search operation endpoint
curl --request POST \
--url https://api.aisa.one/apis/v1/listennotes/full-text-search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"q": "<string>"
}
'import requests
url = "https://api.aisa.one/apis/v1/listennotes/full-text-search"
payload = { "q": "<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({q: '<string>'})
};
fetch('https://api.aisa.one/apis/v1/listennotes/full-text-search', 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/full-text-search",
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([
'q' => '<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/full-text-search"
payload := strings.NewReader("{\n \"q\": \"<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/full-text-search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"q\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/listennotes/full-text-search")
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 \"q\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"took": 0.093,
"count": 10,
"total": 1989,
"results": [
{
"id": "4d82e50314174754a3b603912448e812",
"rss": "https://sw7x7.libsyn.com/rss",
"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",
"podcast": {
"id": "4d3fe717742d4963a85562e9f84d8c79",
"image": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.1400x1400.jpg",
"genre_ids": [
138,
86,
160,
68,
82,
100,
101
],
"thumbnail": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg",
"listen_score": 81,
"title_original": "Star Wars 7x7 | Star Wars News, Interviews, and More!",
"listennotes_url": "https://www.listennotes.com/c/4d3fe717742d4963a85562e9f84d8c79/",
"title_highlighted": "<span class=\\\"ln-search-highlight\\\">Star</span> <span class=\\\"ln-search-highlight\\\">Wars</span> 7x7 | <span class=\\\"ln-search-highlight\\\">Star</span> <span class=\\\"ln-search-highlight\\\">Wars</span> News, Interviews, and More!",
"publisher_original": "Star Wars Daily, by Allen Voivod",
"publisher_highlighted": "<span class=\\\"ln-search-highlight\\\">Star</span> <span class=\\\"ln-search-highlight\\\">Wars</span> Daily, by Allen Voivod",
"listen_score_global_rank": "0.5%"
},
"itunes_id": 896354638,
"thumbnail": "https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg",
"pub_date_ms": 1474873200000,
"title_original": "815: Star Wars 2020 Movie and Beyond!",
"listennotes_url": "https://www.listennotes.com/e/4d82e50314174754a3b603912448e812/",
"audio_length_sec": 567,
"explicit_content": false,
"title_highlighted": "815: <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> 2020 Movie and Beyond!",
"description_original": "Yeah, Star Wars Celebration Orlando is 32 days away, but what's the scoop on Celebration 2018? Plus, Rebels Day is Saturday, and much more in our update. Punch it! ***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.*** 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. 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!\n",
"description_highlighted": "...Go to http://Patreon.com/sw7x7 to donate to the <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> 7x7 podcast, and you'll get some fabulous rewards for your pledge.*** Check out SW7x7.com for full <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> 7x7 show notes and links, and to\n",
"transcripts_highlighted": [
"<string>"
]
}
],
"next_offset": 10
}
}Request contract
- Method and path: POST /apis/v1/listennotes/full-text-search
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/listennotes/full-text-search - Runtime facts: 3f699076c1baf63c05edde2629715e34586e70ee0982cdee89366394f35facf8
{
"operationId": "listennotes.full-text-search",
"method": "POST",
"path": "/apis/v1/listennotes/full-text-search",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Search term, e.g., person, place, topic... You can use double quotes to do verbatim match, e.g., \"game of thrones\". Otherwise, it\"s fuzzy search. "
},
"ncid": {
"type": "string",
"description": "A comma-delimited string of podcast ids (up to 5 podcasts) - you can get a podcast id from the **podcast_id** field in response. This parameter is to exclude search results of a few specific podcasts. It works only when **type** is *episode*. "
},
"ocid": {
"type": "string",
"description": "A comma-delimited string of podcast ids (up to 5 podcasts) - you can get a podcast id from the **podcast_id** field in response. This parameter is to limit search results from only a few specific podcasts. It works only when **type** is *episode*. "
},
"type": {
"enum": [
"curated",
"episode",
"podcast"
],
"type": "string",
"default": "episode",
"description": "What type of contents do you want to search for? "
},
"offset": {
"type": "integer",
"default": 0,
"description": "Offset for search results, for pagination. You\"ll use **next_offset** from response for this parameter. "
},
"region": {
"type": "string",
"description": "Limit search results to a specific region (e.g., us, gb, in...). If not specified, it\"ll be any region. You can get the supported country codes from `GET /regions`. It works only when **type** is *episode* or *podcast*. "
},
"len_max": {
"type": "integer",
"description": "Maximum audio length in minutes. Applicable only when **type** parameter is **episode** or **podcast**. If **type** parameter is **episode**, it\"s for audio length of an episode. If **type** parameter is **podcast**, it\"s for average audio length of all episodes in a podcast. "
},
"len_min": {
"type": "integer",
"default": 0,
"description": "Minimum audio length in minutes. Applicable only when **type** parameter is **episode** or **podcast**. If **type** parameter is **episode**, it\"s for audio length of an episode. If **type** parameter is **podcast**, it\"s for average audio length of all episodes in a podcast. "
},
"only_in": {
"type": "string",
"default": "title,description,author,audio",
"description": "A comma-delimited string to search only in specific fields. Allowed values are title, description, author, and audio. If not specified, then search every fields. "
},
"language": {
"type": "string",
"description": "Limit search results to a specific language. If not specified, it\"ll be any language. You can get a list of supported languages from `GET /languages`. It works only when **type** is *episode* or *podcast*. "
},
"genre_ids": {
"type": "string",
"description": "A comma-delimited string of a list of genre ids. If not specified, then all genres are included. You can find the id and the name of all genres from `GET /genres`. It works only when **type** is *episode* or *podcast*. "
},
"page_size": {
"type": "integer",
"default": 10,
"description": "The maximum number of search results per page. A valid value should be an integer between 1 and 10 (inclusive). "
},
"safe_mode": {
"type": "integer",
"default": 0,
"description": "Whether or not to exclude podcasts/episodes with explicit language. 1 is yes and 0 is no. It works only when **type** is *episode* or *podcast*. "
},
"sort_by_date": {
"type": "integer",
"default": 0,
"description": "Sort by date or not? If 0, then sort by relevance. If 1, then sort by date. "
},
"sponsored_only": {
"type": "integer",
"default": 0,
"description": "Whether or not to keep only podcasts that have sponsors in search results. 1 is yes and 0 is no. It works only when **type** is *podcast*. This parameter is available only in the PRO/ENTERPRISE plan. "
},
"interviews_only": {
"type": "integer",
"default": 0,
"description": "Whether or not to keep only podcasts that have guest interviews in search results. 1 is yes and 0 is no. It works only when **type** is *podcast*. This parameter is available only in the PRO/ENTERPRISE plan. "
},
"published_after": {
"type": "integer",
"default": 0,
"description": "Only show episodes/podcasts/curated lists published after this timestamp (in milliseconds). If **published_before** & **published_after** are used at the same time, **published_before** should be bigger than **published_after**. "
},
"unique_podcasts": {
"type": "integer",
"default": 0,
"description": "Whether or not to keep only one episode per podcast in search results. 1 is yes and 0 is no. It works only when **type** is *episode*. "
},
"update_freq_max": {
"type": "integer",
"description": "Maximum update frequency in hours (how frequently does a podcast release a new episode). For example, if you want to find \"weekly\" podcasts, then you can set **update_freq_min**=144 hours (or 6 days) and **update_freq_max**=192 hours (or 8 days). Applicable only when type parameter is **podcast**. "
},
"update_freq_min": {
"type": "integer",
"description": "Minimum update frequency in hours (how frequently does a podcast release a new episode). For example, if you want to find \"weekly\" podcasts, then you can set **update_freq_min**=144 hours (or 6 days) and **update_freq_max**=192 hours (or 8 days). Applicable only when type parameter is **podcast**. "
},
"published_before": {
"type": "integer",
"description": "Only show episodes/podcasts/curated lists published before this timestamp (in milliseconds). If **published_before** & **published_after** are used at the same time, **published_before** should be bigger than **published_after**. "
},
"episode_count_max": {
"type": "integer",
"description": "Maximum number of episodes. Applicable only when type parameter is **podcast**. "
},
"episode_count_min": {
"type": "integer",
"description": "Minimum number of episodes. Applicable only when type parameter is **podcast**. "
}
}
}
}
}
},
"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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Search term, e.g., person, place, topic... You can use double quotes to do verbatim match, e.g., "game of thrones". Otherwise, it"s fuzzy search.
A comma-delimited string of podcast ids (up to 5 podcasts) - you can get a podcast id from the podcast_id field in response. This parameter is to exclude search results of a few specific podcasts. It works only when type is episode.
A comma-delimited string of podcast ids (up to 5 podcasts) - you can get a podcast id from the podcast_id field in response. This parameter is to limit search results from only a few specific podcasts. It works only when type is episode.
What type of contents do you want to search for?
Available options:
curated, episode, podcast Offset for search results, for pagination. You"ll use next_offset from response for this parameter.
Limit search results to a specific region (e.g., us, gb, in...). If not specified, it"ll be any region. You can get the supported country codes from GET /regions. It works only when type is episode or podcast.
Maximum audio length in minutes. Applicable only when type parameter is episode or podcast. If type parameter is episode, it"s for audio length of an episode. If type parameter is podcast, it"s for average audio length of all episodes in a podcast.
Minimum audio length in minutes. Applicable only when type parameter is episode or podcast. If type parameter is episode, it"s for audio length of an episode. If type parameter is podcast, it"s for average audio length of all episodes in a podcast.
A comma-delimited string to search only in specific fields. Allowed values are title, description, author, and audio. If not specified, then search every fields.
Limit search results to a specific language. If not specified, it"ll be any language. You can get a list of supported languages from GET /languages. It works only when type is episode or podcast.
A comma-delimited string of a list of genre ids. If not specified, then all genres are included. You can find the id and the name of all genres from GET /genres. It works only when type is episode or podcast.
The maximum number of search results per page. A valid value should be an integer between 1 and 10 (inclusive).
Whether or not to exclude podcasts/episodes with explicit language. 1 is yes and 0 is no. It works only when type is episode or podcast.
Sort by date or not? If 0, then sort by relevance. If 1, then sort by date.
Whether or not to keep only podcasts that have sponsors in search results. 1 is yes and 0 is no. It works only when type is podcast. This parameter is available only in the PRO/ENTERPRISE plan.
Whether or not to keep only podcasts that have guest interviews in search results. 1 is yes and 0 is no. It works only when type is podcast. This parameter is available only in the PRO/ENTERPRISE plan.
Only show episodes/podcasts/curated lists published after this timestamp (in milliseconds). If published_before & published_after are used at the same time, published_before should be bigger than published_after.
Whether or not to keep only one episode per podcast in search results. 1 is yes and 0 is no. It works only when type is episode.
Maximum update frequency in hours (how frequently does a podcast release a new episode). For example, if you want to find "weekly" podcasts, then you can set update_freq_min=144 hours (or 6 days) and update_freq_max=192 hours (or 8 days). Applicable only when type parameter is podcast.
Minimum update frequency in hours (how frequently does a podcast release a new episode). For example, if you want to find "weekly" podcasts, then you can set update_freq_min=144 hours (or 6 days) and update_freq_max=192 hours (or 8 days). Applicable only when type parameter is podcast.
Only show episodes/podcasts/curated lists published before this timestamp (in milliseconds). If published_before & published_after are used at the same time, published_before should be bigger than published_after.
Maximum number of episodes. Applicable only when type parameter is podcast.
Minimum number of episodes. Applicable only when type parameter is podcast.
Response
Tool result data
Show child attributes
Show child attributes