> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poddata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# A quote's source: what to play and from which second, the episode or the event, who spoke when, and the other quotes



## OpenAPI

````yaml /openapi.json get /quotes/{id}/source
openapi: 3.1.0
info:
  title: PodData API
  version: 1.0.0
  description: >-
    PodData is competitive intelligence from the record: what leaders said on
    podcasts, in interviews and at their own events, as quotes with the speaker,
    the source, the day and the second; and, for a diligence, what public
    sources say about a company and its rivals, read through links a person on
    your team has confirmed.


    ## Quick start


    1. **A key.** Someone on your team makes one in the workspace, Settings ›
    API keys. Send it on every call as `Authorization: Bearer pd_live_…`. Keep
    it in an environment variable, such as `PODDATA_API_KEY`, and never print it
    or write it to a file.

    2. **A target.** `POST /targets` with a company's `name` and `domain`, an id
    from `GET /companies?q=`, or its SEC `ticker`.

    3. **Its links and rivals.** `POST /targets/{company}/find` and `POST
    /targets/{company}/rivals/find` propose them, each with the page that shows
    it. Show each one to a person, and confirm it only on their yes.

    4. **A read.** `POST /targets/{company}/read` with `{"rivals": true}` asks
    PodData to read the target and its confirmed rivals now. `GET
    /targets/{company}/coverage` says what has been read, source by source.

    5. **The files.** `GET /targets/{company}/folder` lists a file for each
    source, for the target and each confirmed rival. `?format=zip` is all of
    them at once.

    6. **A report.** `POST /diligence-reports` makes one with five empty pages.
    Write each with `PUT /diligence-reports/{id}/pages/{page}`, check it with
    `POST /diligence-reports/{id}/check`, and read it with every figure filled
    with `GET /diligence-reports/{id}`. Or have PodData's own agent write it,
    `POST /diligence-reports/{id}/runs`, and follow the run with `GET
    /diligence-runs/{id}`.


    The tags below are in that order. Each operation says what has to be true
    first, what to call next and its limits, with a made-up example of the call
    and its answer.


    **For an assistant,** start from `https://api.poddata.ai/llms.txt`, which
    needs no key: the same steps, the MCP server, and PodData's diligence skill
    with its puller, which saves a target's folder, its rivals' and its reports
    to disk. The MCP server does what the API does:
    `https://api.poddata.ai/mcp`, with the same key or by signing in to PodData,
    and each operation here names its tool in `x-mcp-tool`. To add it to Claude
    Code with the key read from the environment each time it starts, never
    written down, run this as it is, in single quotes: `claude mcp add
    --transport http --scope project poddata https://api.poddata.ai/mcp --header
    'Authorization: Bearer ${PODDATA_API_KEY}'`.


    **Limits.** 120 requests a minute a key, then a `429` with `Retry-After`. A
    team's plan sets how many reads, rival finds and filers it may ask for a
    day, and a call past one is a `403` with the code `plan` that says the
    limit. A list or a file holds at most 80 words in a row of a source's own
    text; a whole document or transcript comes from its own route, one at a
    time, under a daily limit.


    **Errors** are `{"error": {"code": "…", "message": "…"}}`, the message a
    sentence that says what to do.
servers:
  - url: https://api.poddata.ai/v1
security:
  - key: []
tags:
  - name: Targets
    description: >-
      Start here. The companies your team looks at: add one by its name and
      domain, by an id from `GET /companies`, or by its SEC ticker. A target is
      your team's alone, and nothing says another team looks at it.
  - name: Links
    description: >-
      A target's own domain, listings and accounts. PodData proposes them from
      its own site, and reads only through a link a person on your team has
      confirmed.
  - name: Rivals
    description: >-
      The companies a target competes with. PodData finds and tests candidates
      and proposes only the rivals; a person confirms each, and then it is read
      beside the target.
  - name: Reads
    description: >-
      Ask PodData to read a target and its confirmed rivals now, and see what
      has been read for it, source by source, and what is missing and why.
  - name: Records and signals
    description: >-
      What PodData read about a company through its confirmed links: records,
      such as filings, licences, cases and stories, and signals, such as reviews
      and ratings, each with its own day and its page on the source's site. And
      the figures your team's own data licences read.
  - name: Ads and site
    description: >-
      A brand's ads in Meta's US ad library, from PodData's weekly reads, and
      the pages of a company's own site as PodData read them.
  - name: Number tools
    description: >-
      Figures computed on the server, so an assistant never pages through
      thousands of reviews or does the sums itself: ratings, complaints, a
      series, a timeline, ads and a site, for a company beside its confirmed
      rivals. Each answers the figures, the rows behind them, the evidence and
      how they were built.
  - name: Folder
    description: >-
      Everything PodData holds for a target and its confirmed rivals, as files:
      an index, a CSV a source and kind, and one zip.
  - name: Reports
    description: >-
      A diligence report: an overview and five pages, each figure filled by a
      number tool when the report is read, and a check that refuses what the
      evidence doesn't hold. Your own assistant writes it a page at a time, or
      PodData's agent does.
  - name: Report runs
    description: >-
      PodData's own agent writing a report or changing one: each run's status,
      its turns and what it cost.
  - name: Quotes
    description: >-
      What people said, as quotes with the speaker, the show, the day, the
      second and a page to cite.
  - name: People
    description: >-
      The people PodData quotes, their sources and timelines, and lookups of
      someone new.
  - name: Shows and episodes
    description: The shows PodData reads and their episodes, with who spoke when.
  - name: Companies
    description: >-
      What companies said and filed themselves: their documents, events,
      transcripts, slides, posts and figures, and passages of at most 80 words
      from them.
  - name: Trackers
    description: >-
      A tracker follows a topic or a person and sends each new quote it matches
      by email, Slack or webhook.
  - name: Lists
    description: >-
      A team's own lists of people and companies, to narrow a search or a
      tracker to them.
  - name: Saved
    description: >-
      What a person signed in has saved, their saved filters and their calendar
      feed. A key, which has no person, is refused most of these.
  - name: Sources
    description: >-
      The sources PodData reads, what it holds from each, and how much of the
      watch list is covered.
  - name: Webhooks
    description: Webhooks a program registers to be sent what its trackers match.
  - name: Usage
    description: The team's calls and reads, counted by day and kind.
  - name: Help
    description: >-
      PodData's guide to itself: what each part of PodData does and where in the
      workspace it's done, topic by topic.
paths:
  /quotes/{id}/source:
    get:
      tags:
        - Quotes
      summary: >-
        A quote's source: what to play and from which second, the episode or the
        event, who spoke when, and the other quotes
      operationId: getQuoteSource
      parameters:
        - schema:
            type: string
            maxLength: 64
          required: true
          name: id
          in: path
      responses:
        '200':
          description: The quote's source
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Source'
        default:
          description: An error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    Source:
      type: object
      properties:
        kind:
          type: string
          enum:
            - episode
            - event
            - document
        shown:
          type: string
          enum:
            - passages
            - whole
        removed:
          type: boolean
        quote:
          anyOf:
            - type: 'null'
            - $ref: '#/components/schemas/Quote'
        passage:
          anyOf:
            - type: 'null'
            - type: object
              properties:
                id:
                  type: string
                document:
                  type: string
                'n':
                  type: integer
                page:
                  type: integer
                kind:
                  type: string
                  enum:
                    - text
                    - table
                    - heading
                text:
                  type: string
                word_count:
                  type: integer
                place:
                  anyOf:
                    - type: 'null'
                    - type: object
                      properties:
                        boxes:
                          type: array
                          items:
                            type: object
                            properties:
                              x:
                                type: number
                              'y':
                                type: number
                              width:
                                type: number
                              height:
                                type: number
                            required:
                              - x
                              - 'y'
                              - width
                              - height
                        start:
                          type:
                            - integer
                            - 'null'
                        end:
                          type:
                            - integer
                            - 'null'
                      required:
                        - boxes
                        - start
                        - end
                article:
                  anyOf:
                    - type: object
                      properties:
                        outlet:
                          type: string
                        part:
                          type:
                            - string
                            - 'null'
                          enum:
                            - question
                            - answer
                            - null
                        said_by:
                          anyOf:
                            - type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                              required:
                                - id
                                - name
                            - type: 'null'
                        cite:
                          type: string
                      required:
                        - outlet
                        - part
                        - said_by
                        - cite
                    - type: 'null'
              required:
                - id
                - document
                - 'n'
                - page
                - kind
                - text
                - word_count
                - place
        episode:
          anyOf:
            - type: 'null'
            - type: object
              properties:
                id:
                  type: string
                title:
                  type: string
                date:
                  type: string
                  format: date
                duration:
                  type:
                    - number
                    - 'null'
                show:
                  type: object
                  properties:
                    id:
                      type: string
                    name:
                      type: string
                  required:
                    - id
                    - name
                guests:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type:
                          - string
                          - 'null'
                      name:
                        type: string
                      role:
                        type:
                          - string
                          - 'null'
                    required:
                      - id
                      - name
                      - role
              required:
                - id
                - title
                - date
                - duration
                - show
                - guests
        event:
          anyOf:
            - type: 'null'
            - type: object
              properties:
                id:
                  type: string
                title:
                  type: string
                type:
                  type: string
                date:
                  type: string
                company:
                  $ref: '#/components/schemas/CompanyRef'
                duration:
                  type:
                    - number
                    - 'null'
                transcript:
                  type:
                    - string
                    - 'null'
                audio:
                  type:
                    - string
                    - 'null'
                replay:
                  type:
                    - string
                    - 'null'
                  enum:
                    - open
                    - form
                    - none
                    - null
                page_url:
                  type:
                    - string
                    - 'null'
                  format: uri
              required:
                - id
                - title
                - type
                - date
                - company
                - duration
                - transcript
                - audio
                - replay
                - page_url
        document:
          anyOf:
            - type: 'null'
            - $ref: '#/components/schemas/Document'
        page:
          anyOf:
            - type: 'null'
            - $ref: '#/components/schemas/Page'
        labels:
          type: array
          items:
            type: object
            properties:
              text:
                type: string
              x:
                type:
                  - number
                  - 'null'
              'y':
                type:
                  - number
                  - 'null'
            required:
              - text
              - x
              - 'y'
        open:
          type: object
          properties:
            what:
              type: string
              enum:
                - video
                - audio
                - page
                - document
                - none
            url:
              type:
                - string
                - 'null'
              format: uri
            embed:
              type:
                - string
                - 'null'
              enum:
                - youtube
                - audio
                - null
            video:
              type:
                - string
                - 'null'
            starts_at:
              type:
                - number
                - 'null'
            ends_at:
              type:
                - number
                - 'null'
            clock:
              type:
                - string
                - 'null'
              enum:
                - video
                - audio
                - null
            page:
              type:
                - integer
                - 'null'
            copy_url:
              type:
                - string
                - 'null'
              format: uri
            copy_expires:
              type:
                - string
                - 'null'
              format: date-time
          required:
            - what
            - url
            - embed
            - video
            - starts_at
            - ends_at
            - clock
            - page
            - copy_url
            - copy_expires
        outline:
          type: object
          properties:
            speakers:
              type: array
              items:
                type: object
                properties:
                  index:
                    type: integer
                  id:
                    type:
                      - string
                      - 'null'
                  name:
                    type:
                      - string
                      - 'null'
                  role:
                    type:
                      - string
                      - 'null'
                  company:
                    type:
                      - string
                      - 'null'
                  status:
                    type: string
                    enum:
                      - confirmed
                      - unconfirmed
                required:
                  - index
                  - id
                  - name
                  - role
                  - company
                  - status
            turns:
              type: array
              items:
                type: object
                properties:
                  speaker:
                    type: integer
                  starts_at:
                    type: number
                  ends_at:
                    type: number
                  chapter:
                    type:
                      - string
                      - 'null'
                  word_count:
                    type: integer
                  text:
                    type:
                      - string
                      - 'null'
                  words:
                    type: array
                    items:
                      type: object
                      properties:
                        text:
                          type: string
                        starts_at:
                          type: number
                        ends_at:
                          type: number
                        confidence:
                          type: number
                          minimum: 0
                          maximum: 1
                      required:
                        - text
                        - starts_at
                        - ends_at
                        - confidence
                  source_url:
                    type:
                      - string
                      - 'null'
                    format: uri
                required:
                  - speaker
                  - starts_at
                  - ends_at
                  - chapter
                  - word_count
                  - text
                  - source_url
            chapters:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  transcript:
                    type: string
                  parent:
                    type:
                      - string
                      - 'null'
                  level:
                    type: integer
                  kind:
                    type: string
                    enum:
                      - remarks
                      - qa
                      - question
                      - topic
                      - chapter
                  title:
                    type: string
                  starts_at:
                    type: number
                  ends_at:
                    type: number
                  asker:
                    anyOf:
                      - type: object
                        properties:
                          name:
                            type: string
                          company:
                            type:
                              - string
                              - 'null'
                        required:
                          - name
                          - company
                      - type: 'null'
                  from:
                    type: string
                    enum:
                      - show
                      - script
                      - model
                required:
                  - id
                  - transcript
                  - parent
                  - level
                  - kind
                  - title
                  - starts_at
                  - ends_at
                  - asker
                  - from
            chapters_missing:
              type:
                - string
                - 'null'
            sections:
              type: array
              items:
                type: object
                properties:
                  title:
                    type: string
                  item:
                    type:
                      - string
                      - 'null'
                  level:
                    type: integer
                  first_page:
                    type: integer
                  last_page:
                    type: integer
                required:
                  - title
                  - item
                  - level
                  - first_page
                  - last_page
            missing:
              type:
                - string
                - 'null'
          required:
            - speakers
            - turns
            - chapters
            - chapters_missing
            - sections
            - missing
        near:
          type: object
          properties:
            quotes:
              type: array
              items:
                $ref: '#/components/schemas/Quote'
            passages:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  'n':
                    type: integer
                  kind:
                    type: string
                    enum:
                      - text
                      - table
                      - heading
                  word_count:
                    type: integer
                  place:
                    anyOf:
                      - type: 'null'
                      - type: object
                        properties:
                          boxes:
                            type: array
                            items:
                              type: object
                              properties:
                                x:
                                  type: number
                                'y':
                                  type: number
                                width:
                                  type: number
                                height:
                                  type: number
                              required:
                                - x
                                - 'y'
                                - width
                                - height
                          start:
                            type:
                              - integer
                              - 'null'
                          end:
                            type:
                              - integer
                              - 'null'
                        required:
                          - boxes
                          - start
                          - end
                required:
                  - id
                  - 'n'
                  - kind
                  - word_count
                  - place
          required:
            - quotes
            - passages
      required:
        - kind
        - shown
        - removed
        - quote
        - passage
        - episode
        - event
        - document
        - page
        - labels
        - open
        - outline
        - near
    ApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - bad_request
                - no_key
                - plan
                - forbidden
                - not_found
                - conflict
                - unclear
                - slow_down
                - internal
            message:
              type: string
          required:
            - code
            - message
      required:
        - error
    Quote:
      type: object
      properties:
        id:
          type: string
        text:
          type:
            - string
            - 'null'
        speaker:
          type: object
          properties:
            id:
              type:
                - string
                - 'null'
            name:
              type: string
            role:
              type: string
            company:
              type: object
              properties:
                id:
                  type: string
                name:
                  type: string
                ticker:
                  type: string
                exchange:
                  type: string
              required:
                - id
                - name
            page:
              type: string
              format: uri
            status:
              type: string
              enum:
                - confirmed
                - unconfirmed
          required:
            - id
            - name
            - status
        show:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
            page:
              type: string
              format: uri
          required:
            - id
            - name
        episode:
          type: object
          properties:
            id:
              type: string
            title:
              type: string
            date:
              type: string
              format: date
          required:
            - id
            - title
            - date
        starts_at:
          type: number
        ends_at:
          type: number
        clock:
          type: string
          enum:
            - video
            - audio
        url:
          type: string
          format: uri
        source_url:
          type:
            - string
            - 'null'
          format: uri
        cite:
          type: string
        corrected:
          type:
            - object
            - 'null'
          properties:
            at:
              type: string
              format: date-time
            field:
              type: string
              enum:
                - speaker
                - text
                - time
        names:
          type: array
          items:
            type: object
            properties:
              kind:
                type: string
                enum:
                  - company
                  - person
              name:
                type: string
              said:
                type: string
              id:
                type:
                  - string
                  - 'null'
              ticker:
                type: string
              exchange:
                type: string
            required:
              - kind
              - name
              - said
              - id
        claim:
          type:
            - object
            - 'null'
          properties:
            kind:
              type: string
              enum:
                - forecast
                - commitment
                - admission
                - figure
                - none
            due:
              type:
                - object
                - 'null'
              properties:
                said:
                  type: string
                from:
                  type:
                    - string
                    - 'null'
                  format: date
                to:
                  type:
                    - string
                    - 'null'
                  format: date
              required:
                - said
                - from
                - to
          required:
            - kind
            - due
        spelled:
          type: array
          items:
            type: object
            properties:
              heard:
                type: string
              fixed:
                type: string
            required:
              - heard
              - fixed
        event:
          type:
            - object
            - 'null'
          properties:
            id:
              type: string
            type:
              type: string
              enum:
                - earnings_call
                - investor_day
                - analyst_day
                - capital_markets_day
                - conference
                - shareholder_meeting
                - deal_call
                - guidance_update
                - business_update
                - keynote
                - other
            title:
              type: string
            date:
              type: string
              format: date
            company:
              type: object
              properties:
                id:
                  type: string
                name:
                  type: string
                ticker:
                  type: string
                exchange:
                  type: string
              required:
                - id
                - name
            fiscal_year:
              type:
                - integer
                - 'null'
            fiscal_period:
              type:
                - string
                - 'null'
              enum:
                - Q1
                - Q2
                - Q3
                - Q4
                - H1
                - H2
                - FY
                - null
            chapter:
              type:
                - object
                - 'null'
              properties:
                'n':
                  type: integer
                kind:
                  type: string
                  enum:
                    - remarks
                    - qa
                    - question
                title:
                  type: string
                starts_at:
                  type: number
                ends_at:
                  type: number
                analyst:
                  type:
                    - string
                    - 'null'
                firm:
                  type:
                    - string
                    - 'null'
              required:
                - 'n'
                - kind
                - title
                - starts_at
                - ends_at
                - analyst
                - firm
          required:
            - id
            - type
            - title
            - date
            - company
            - fiscal_year
            - fiscal_period
            - chapter
        match_spans:
          type: array
          items:
            type: object
            properties:
              from:
                type: integer
                minimum: 0
              to:
                type: integer
                minimum: 0
            required:
              - from
              - to
      required:
        - id
        - text
        - speaker
        - show
        - episode
        - starts_at
        - ends_at
        - clock
        - url
        - source_url
        - cite
        - corrected
        - event
    CompanyRef:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        ticker:
          type: string
        exchange:
          type: string
      required:
        - id
        - name
    Document:
      type: object
      properties:
        id:
          type: string
        company:
          $ref: '#/components/schemas/CompanyRef'
        event:
          anyOf:
            - $ref: '#/components/schemas/EventRef'
            - type: 'null'
        kind:
          $ref: '#/components/schemas/DocumentKind'
        group:
          anyOf:
            - $ref: '#/components/schemas/DocumentGroup'
            - type: 'null'
        type:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
          required:
            - id
            - name
        form:
          type:
            - string
            - 'null'
        exhibit:
          type:
            - string
            - 'null'
        title:
          type: string
        filed:
          type: string
          format: date
        accepted_at:
          type:
            - string
            - 'null'
          format: date-time
        period_end:
          type:
            - string
            - 'null'
          format: date
        fiscal:
          anyOf:
            - type: object
              properties:
                year:
                  type: integer
                period:
                  type: string
                  enum:
                    - Q1
                    - Q2
                    - Q3
                    - Q4
                    - H1
                    - H2
                    - FY
              required:
                - year
                - period
            - type: 'null'
        pages:
          type:
            - integer
            - 'null'
        source:
          type: string
          enum:
            - edgar
            - site
        source_url:
          type: string
          format: uri
        filing_url:
          type:
            - string
            - 'null'
          format: uri
        shown:
          type: string
          enum:
            - passages
            - whole
        file_url:
          type:
            - string
            - 'null'
          format: uri
        article:
          anyOf:
            - type: object
              properties:
                form:
                  type: string
                  enum:
                    - interview
                    - news
                outlet:
                  type: object
                  properties:
                    id:
                      type: string
                    name:
                      type: string
                  required:
                    - id
                    - name
                author:
                  type:
                    - string
                    - 'null'
                published_at:
                  type:
                    - string
                    - 'null'
                people:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      role:
                        type: string
                        enum:
                          - interviewed
                          - written_about
                    required:
                      - id
                      - name
                      - role
              required:
                - form
                - outlet
                - author
                - published_at
                - people
            - type: 'null'
        created:
          type: string
          format: date-time
        updated:
          type: string
          format: date-time
      required:
        - id
        - company
        - event
        - kind
        - group
        - type
        - form
        - exhibit
        - title
        - filed
        - accepted_at
        - period_end
        - fiscal
        - pages
        - source
        - source_url
        - filing_url
        - shown
        - file_url
        - created
        - updated
    Page:
      type: object
      properties:
        id:
          type: string
        document:
          type: string
        number:
          type: integer
        label:
          type:
            - string
            - 'null'
        title:
          type:
            - string
            - 'null'
        section:
          type:
            - string
            - 'null'
        word_count:
          type: integer
        source_url:
          type: string
          format: uri
        text:
          type:
            - string
            - 'null'
        image_url:
          type:
            - string
            - 'null'
          format: uri
      required:
        - id
        - document
        - number
        - label
        - title
        - section
        - word_count
        - source_url
        - text
        - image_url
    EventRef:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        type:
          type: string
        date:
          type: string
      required:
        - id
        - title
        - type
        - date
    DocumentKind:
      type: string
      enum:
        - report
        - slides
        - article
    DocumentGroup:
      type: string
      enum:
        - earnings_release
        - press_release
        - interim_report
        - annual_report
        - proxy_statement
        - registration_statement
  securitySchemes:
    key:
      type: http
      scheme: bearer
      description: >-
        An API key, sent as `Authorization: Bearer pd_live_…`. Someone on your
        team makes one in the workspace, Settings › API keys; it's shown once.
        Staging's keys start with `pd_test_`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.