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

# Post episodes by ids

> <!-- aisa-pricing:start -->
按用量计费；默认请求预估费用：$0.0403 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。
<!-- aisa-pricing:end -->

## 请求规范

* **方法与路径:** POST /apis/v1/listennotes/batch-fetch-basic-meta-data-for-episodes
* **可用状态:** enabled
* **请求 URL 模板:** `https://api.aisa.one/apis/v1/listennotes/batch-fetch-basic-meta-data-for-episodes`
* **Runtime 事实版本:** 3f699076c1baf63c05edde2629715e34586e70ee0982cdee89366394f35facf8

[完整 OpenAPI 定义](https://aisa.one/docs/reference-contracts/zh/listennotes.json)

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

```json theme={null}
{
  "operationId": "listennotes.batch-fetch-basic-meta-data-for-episodes",
  "method": "POST",
  "path": "/apis/v1/listennotes/batch-fetch-basic-meta-data-for-episodes",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "ids"
          ],
          "properties": {
            "ids": {
              "type": "string",
              "description": "Comma-separated list of episode ids."
            }
          }
        }
      }
    }
  },
  "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-episodes
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-episodes:
    post:
      tags:
        - Listen Notes
      summary: Post episodes by ids
      description: >-
        <!-- aisa-pricing:start -->

        按用量计费；默认请求预估费用：$0.0403 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001
        USD。 最终费用以账户适用价格及实际结算为准。

        <!-- aisa-pricing:end -->
      operationId: listennotes.batch-fetch-basic-meta-data-for-episodes
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - ids
              properties:
                ids:
                  type: string
                  description: Comma-separated list of episode ids.
      responses:
        '200':
          description: Tool result data
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODES__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_EPISODES__output__public_data:
      $ref: >-
        #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODES__output__ddaf806508955360
    Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODES__output__ddaf806508955360:
      type: object
      required:
        - data
      properties:
        data:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODES__output__cad6072e01a87fc4
    Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODES__output__cad6072e01a87fc4:
      type: object
      required:
        - episodes
      properties:
        episodes:
          type: array
          items:
            $ref: >-
              #/components/schemas/Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODES__output__3e939f27b22f4a5b
    Response576A0Ea506F3_connect_LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODES__output__3e939f27b22f4a5b:
      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_EPISODES__output__8759638295d1e25d
        thumbnail:
          type: string
          examples:
            - >-
              https://cdn-images-3.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg
        description:
          type: string
          examples:
            - "<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:
          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_EPISODES__output__8759638295d1e25d:
      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.