Use these endpoints to find conversations and retrieve detailed conversation information in your team's Apollo workspace. You can also export conversations within a time range and retrieve the completed export for use in your own system.
Key concepts
| Conversations | Conversations include recorded prospect meetings and phone calls stored in Apollo. You can search by conversation type, associated contacts or accounts, date range, and other criteria. |
| Search and full details | Search returns conversation summaries without transcripts or recording URLs. Use a conversation's ID with get conversations info to retrieve its full details. |
| Conversation and export IDs | A conversation ID identifies a single conversation. An export ID identifies an export request that can contain multiple conversations. Use the export ID to retrieve the download URL after processing completes. |
| Conversation exports | Exports collect conversations within a specified time range into a gzipped JSON file. Processing is asynchronous. Apollo emails the specified team member when the export is ready. |
Choose an endpoint
| I want to . . . | Use this |
|---|---|
| Find conversations that match my criteria | Search conversations |
| Retrieve full details for a conversation whose ID I have | Get conversations info |
| Export conversations within a time range | Export conversations |
| Retrieve the download URL for a completed export | Get conversations export |
Example workflows
Review conversations for an account
Retrieve conversations associated with a saved account to review prospect context before your next follow-up.
- Call search for accounts to find the saved account and retain its
id. - Pass the account ID as
account_idto search conversations. Review the summaries and retain the IDs of the conversations you want to explore. - Pass each conversation ID as
idto get conversations info to retrieve its full details.
If you already have the account or conversation ID, you can skip the corresponding lookup.
Learn more: Use the search conversations and get conversations info references to dig in to the workflow.
Export conversations for analysis
Bring conversations from a reporting period into your system for analysis or review.
- Call export conversations with
start_time,end_time, and theemailaddress of a team member to notify. Retain the returned export ID. - After the export is ready, pass the export ID as
idto get conversations export to retrieve its download URL. - Download and decompress the gzipped JSON file, then use the conversation data in your system.
Use ISO 8601 date-time values in GMT for the export range.
Learn more: Use the export conversations and get conversations export references to explore export requests and downloads.