> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Create podcast via form data > 按用量计费；默认请求预估费用：$0.0403 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 ## 请求规范 * **方法与路径:** POST /apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts * **可用状态:** enabled * **请求 URL 模板:** `https://api.aisa.one/apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts` * **Runtime 事实版本:** 3f699076c1baf63c05edde2629715e34586e70ee0982cdee89366394f35facf8 [完整 OpenAPI 定义](https://aisa.one/docs/reference-contracts/zh/listennotes.json) 有效请求与价格声明（包括认证和引用的 schema）： ```json theme={null} { "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" } } } } ``` ## 费用与请求规则 按用量计费；默认请求预估费用：\$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 ## OpenAPI ````yaml reference-contracts/zh/listennotes.json POST /apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts openapi: 3.1.0 info: description: '' title: Listen Notes version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/listennotes/batch-fetch-basic-meta-data-for-episodes - /apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts - /apis/v1/listennotes/fetch-a-curated-list-of-podcasts-by-id - /apis/v1/listennotes/fetch-a-list-of-best-podcasts-by-genre - /apis/v1/listennotes/fetch-a-list-of-podcast-genres - /apis/v1/listennotes/fetch-a-random-podcast-episode - /apis/v1/listennotes/fetch-audience-demographics-for-a-podcast - /apis/v1/listennotes/fetch-curated-lists-of-podcasts - /apis/v1/listennotes/fetch-detailed-meta-data-for-an-episode-by-id - /apis/v1/listennotes/fetch-podcast-episodes-by-id - /apis/v1/listennotes/fetch-podcast-languages - /apis/v1/listennotes/fetch-podcasts-by-a-publisher-s-domain-name - /apis/v1/listennotes/fetch-recommendations-for-a-podcast - /apis/v1/listennotes/fetch-recommendations-for-an-episode - /apis/v1/listennotes/fetch-related-search-terms - /apis/v1/listennotes/fetch-supported-regions - /apis/v1/listennotes/fetch-trending-search-terms - /apis/v1/listennotes/find-episodes-by-title - /apis/v1/listennotes/full-text-search - /apis/v1/listennotes/typeahead-search x-aisa-document: facts_hash: 3f699076c1baf63c05edde2629715e34586e70ee0982cdee89366394f35facf8 generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '28' response_pending: [] document_hash: sha256:bd77c0884b58e4fbb6600c9c74a804ea4c4a004f668af8485e1b70fec19e76d1 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: listennotes x-aisa-catalogs: listennotes: title: Listen Notes description: '' x-aisa-document: facts_hash: 3f699076c1baf63c05edde2629715e34586e70ee0982cdee89366394f35facf8 generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/listennotes/batch-fetch-basic-meta-data-for-podcasts: post: tags: - Listen Notes summary: Create podcast via form data description: >- 按用量计费；默认请求预估费用：$0.0403 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 operationId: listennotes.batch-fetch-basic-meta-data-for-podcasts 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. responses: '200': description: Tool result data content: application/json: schema: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__public_data default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__public_data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__9d09b2e48ad78b30 Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__9d09b2e48ad78b30: type: object required: - data properties: data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__cad6072e01a87fc4 Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__cad6072e01a87fc4: type: object required: - podcasts properties: podcasts: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__8759638295d1e25d latest_episodes: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__03ddb22a48674bad Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__8759638295d1e25d: type: object properties: id: type: string examples: - 4d3fe717742d4963a85562e9f84d8c79 rss: type: string examples: - https://sw7x7.libsyn.com/rss type: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__9a819c5ce16785dc examples: - episodic email: type: string examples: - hello@example.com extra: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__d930abe0d81bf0f6 image: type: string examples: - >- https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.1400x1400.jpg title: type: string examples: - Star Wars 7x7 | Star Wars News, Interviews, and More! country: type: string examples: - United States website: type: string examples: - http://sw7x7.com/ language: type: string examples: - English genre_ids: type: array items: type: integer examples: - - 138 - 86 - 160 - 68 - 82 - 100 - 101 itunes_id: type: integer examples: - 896354638 publisher: type: string examples: - Planet Broadcasting thumbnail: type: string examples: - >- https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg is_claimed: type: boolean examples: - true description: type: string examples: - >-

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!

looking_for: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__5072254562346fda has_sponsors: type: boolean examples: - false listen_score: type: integer examples: - 81 total_episodes: type: integer examples: - 324 listennotes_url: type: string examples: - https://www.listennotes.com/c/4d3fe717742d4963a85562e9f84d8c79/ audio_length_sec: type: integer examples: - 1291 explicit_content: type: boolean examples: - false latest_episode_id: type: string examples: - d057092e57cc4ced80e0efaa196593d9 latest_pub_date_ms: type: integer examples: - 1557499770000 earliest_pub_date_ms: type: integer examples: - 1470667902000 has_guest_interviews: type: boolean examples: - false update_frequency_hours: type: integer examples: - 168 listen_score_global_rank: type: string examples: - 0.5% Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__03ddb22a48674bad: type: object properties: id: type: string examples: - 4d82e50314174754a3b603912448e812 link: type: string examples: - https://www.npr.org/2020/01/22/798532179/soleimanis-iran audio: type: string examples: - https://www.listennotes.com/e/p/11b34041e804491b9704d11f283c74de/ image: type: string examples: - >- https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.1400x1400.jpg title: type: string examples: - >- Celebration Recap, Jason Fry and Christian Blauvelt Interviews – SWBW #101 podcast: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__c1395a04f0e9c179 thumbnail: type: string examples: - >- https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg description: type: string examples: - "

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!

***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" pub_date_ms: type: integer examples: - 1474873200000 listennotes_url: type: string examples: - https://www.listennotes.com/e/4d82e50314174754a3b603912448e812/ audio_length_sec: type: integer examples: - 567 explicit_content: type: boolean examples: - false maybe_audio_invalid: type: boolean examples: - false listennotes_edit_url: type: string examples: - >- https://www.listennotes.com/e/11b34041e804491b9704d11f283c74de/#edit Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__9a819c5ce16785dc: enum: - episodic - serial type: string Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__d930abe0d81bf0f6: type: object properties: url1: type: string url2: type: string url3: type: string spotify_url: type: string examples: - https://open.spotify.com/show/2rQJUP9Y3HxemiW3JHt9WV youtube_url: type: string examples: - https://www.youtube.com/sw7x7 linkedin_url: type: string wechat_handle: type: string patreon_handle: type: string examples: - sw7x7 twitter_handle: type: string examples: - SW7x7podcast facebook_handle: type: string examples: - sw7x7 amazon_music_url: type: string examples: - >- https://music.amazon.com/podcasts/6fc6d683-9ef3-4850-9c35-8e8b1a42a147/the-lock-sportscast instagram_handle: type: string examples: - sw7x7 Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__5072254562346fda: type: object properties: guests: type: boolean examples: - true cohosts: type: boolean examples: - true sponsors: type: boolean examples: - true cross_promotion: type: boolean examples: - true Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS__output__c1395a04f0e9c179: type: object properties: id: type: string examples: - 4d3fe717742d4963a85562e9f84d8c79 image: type: string examples: - >- https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.1400x1400.jpg title: type: string examples: - Star Wars 7x7 | Star Wars News, Interviews, and More! publisher: type: string examples: - Planet Broadcasting thumbnail: type: string examples: - >- https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg listen_score: type: integer examples: - 81 listennotes_url: type: string examples: - https://www.listennotes.com/c/4d3fe717742d4963a85562e9f84d8c79/ listen_score_global_rank: type: string examples: - 0.5% securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.