Search Conversations

post

https://api.apollo.io/api/v1/conversations/search

Endpoint essentials
API key access	`api/v1/conversations/search` or `Master API key`
OAuth scopes	`conversations_search`
Credit usage	`0 credits` Learn more about API pricing and credits.

Conversations are prospect video meetings stored in Apollo.

Use the Search Conversations endpoint to find a list of conversations. Several filters are available to help narrow your search, including by type, account, contact, date range, and more. Each result includes a summary of the conversation.

This endpoint doesn't include transcripts or recording URLs. Use the conversation ID retrieved from your search to request full details using Get Conversations Info.

Body Params

page

integer

Page number for pagination.

num_fetch_result

integer

Maximum number of results to return.

conversation_type

string

enum

Filter by dialer calls, or video conference calls.

Allowed:

account_id

string

Filter by account ID.

contact_ids

array of strings

Filter by one or more contact IDs.

contact_ids

tag_ids

array of strings

Filter by label or tag IDs.

tag_ids

tracker_ids

array of strings

Filter by tracker IDs.

tracker_ids

organization_ids

array of strings

Filter by organization IDs.

organization_ids

date_range

object

Filter by date range.

scorecard_template_id

string

Filter by scorecard template ID.

scorecard_max_rating

number

Maximum scorecard rating to include in the results.

sort_by_field

string

Field to sort results by.

enforce_contact_boundary

boolean

When true, restricts results to conversations visible to the specified contacts.

Responses

200200

403403