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 -->
按用量计费；默认请求预估费用：$0.0403 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。
<!-- 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
}
}请求规范
- 方法与路径: POST /apis/v1/listennotes/full-text-search
- 可用状态: enabled
- 请求 URL 模板:
https://api.aisa.one/apis/v1/listennotes/full-text-search - Runtime 事实版本: 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"
}
}
}
}
费用与请求规则
按用量计费；默认请求预估费用：$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
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
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?
可用选项:
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.
响应
Tool result data
Show child attributes
Show child attributes