Fireflies API Reference

Authentication

All requests use Bearer token: Authorization: Bearer PLACEHOLDER_TOKEN. The API key is obtained from Fireflies Developer Settings.

Endpoint: https://api.fireflies.ai/graphql

GraphQL Queries

transcripts (list meetings)

List meetings with optional filters. Returns metadata without full transcript content.

query Transcripts($limit: Int, $keyword: String, $fromDate: DateTime) {
  transcripts(limit: $limit, keyword: $keyword, fromDate: $fromDate) {
    id
    title
    date
    duration
    participants
    speakers { id name }
    summary { gist short_summary action_items }
  }
}

Arguments:

• limit (Int): Max results, up to 50
• keyword (String): Search in title and transcript content
• fromDate (DateTime): ISO 8601 format like 2024-12-01T00:00:00.000Z
• toDate (DateTime): End of date range
• mine (Boolean): Only meetings where API owner is organizer

transcript (get single meeting)

Fetch full transcript with sentences, summary, and analytics.

query Transcript($id: String!) {
  transcript(id: $id) {
    id
    title
    date
    duration
    participants
    speakers { id name }
    sentences {
      index
      speaker_name
      text
      start_time
      end_time
      ai_filters { task question sentiment }
    }
    summary {
      overview
      action_items
      keywords
      short_summary
      bullet_gist
      topics_discussed
    }
    analytics {
      sentiments { positive_pct neutral_pct negative_pct }
      speakers {
        name
        duration
        duration_pct
        word_count
        words_per_minute
        questions
        filler_words
      }
    }
  }
}

Key Fields

Transcript metadata: id, title, date (epoch ms), duration (minutes), participants (email array), transcript_url (web link).

Sentences: Speaker-labeled with timestamps. start_time and end_time are floats in seconds. ai_filters tags sentences as tasks, questions, etc.

Summary: AI-generated overview, action items, keywords, and topics. Available on all plans.

Analytics: Sentiment percentages and per-speaker stats. Requires Pro plan—may return null on free tier.

Common Patterns

Recent meetings: Query with limit: 20 and no date filter returns newest first.

Search by keyword: Use keyword to search both titles and spoken content. Set scope: "all" for comprehensive search.

Date range: Use ISO 8601 strings for fromDate and toDate. Fireflies uses UTC.

Error Handling

Error	Meaning
object_not_found	Invalid transcript ID or no access
unauthorized	Invalid or expired API key
rate_limited	Too many requests, wait and retry

Limitations

• List queries return max 50 results per call
• Analytics require Fireflies Pro subscription
• Audio/video URLs expire after 24 hours
• Cannot modify meetings via API (read-only)