Search Term Options
The types of searches that you can perform using the V‑Spark /search
API demonstrate its power and flexibility. Search parameters and potential values are the following:
- agent_clarity=N-M
Search for audio records with agent voice clarity percentage within the range of
N
toM
, which are floating point values. Agent voice clarity measures how clear the agent sounds in the recorded audio. Agents with a clarity of "1" would be the clearest. Low clarity is the result of poor signal, background noise, accent, or poor enunciation.- agent_emotion=EMOTION
Search for files where the emotional score of the agent's portion of the audio is
EMOTION
. Possible values forEMOTION
areimproving
,negative
,positive
, andworsening
. Only oneagent_emotion
value can be used within a single search. For example:agent_emotion=negative
- agent_gender=GENDER
Search for files where the gender of the agent has been identified as
GENDER
. Possible values forGENDER
arefemale
andmale
. Only oneagent_gender
value can be used within a single search. For example:agent_gender=female
- app.name=APPNAME and app.CATEGORY=SCORE
Search for transcripts that have received the specified
SCORE
level from the V‑Spark application namedAPPNAME
in the specified top-level category, or optional lower-level category of that category. Specify lower-level categories using a full dot-separated path through the category tree. For example:
Score level may be one of the following values:app.TOP_CATEGORY.LOWER_CATEGORY.LOWER_CATEGORY
All
- Score greater than 0High
- Score greater than 0.66Medium
- Score greater than 0.33Low
- Score between 0 and 0.33None
- Score of 0
- client_clarity=N-M
Search for audio records with client voice clarity percentage within the range of
N
toM
, which are floating point values. Client voice clarity measures how clear the client sounds in the recorded audio. Clients with a clarity of "1" would be the clearest. Low clarity is the result of poor signal, background noise, accent, or poor enunciation.- client_emotion=EMOTION
Search for files where the emotional score of the client's portion of the audio is
EMOTION
. Possible values forEMOTION
areimproving
,negative
,positive
, andworsening
. Only oneclient_emotion
value can be used within a single search. For example:client_emotion=improving
- client_gender=GENDER
Search for files where the gender of the client has been identified as
GENDER
. Possible values forGENDER
arefemale
andmale
. Only oneclient_gender
value can be used within a single search. For example:client_gender=male
- daterange=START-END
Enables you to specify a date range that your search should be restricted to. The
START
andEND
values, though optional, are both expressed asYYYYMMDD[HHmmss]
values where the year (YYYY) month (MM) and day (DD) values are required, the hours (HH), minutes (mm), and seconds (ss) are optional. Date ranges are always assumed to be positive (whereSTART
is less thanEND
). No verification is done to ensure that this is correct. Invalid date ranges will simply return no values. IfSTART
is not specified, a default value of 01 January, 1900 is used. IfEND
is not specified, the current date is used.- diarization=SCORE
Search for audio records with a diarization score of at least
SCORE
. which is a floating point value between 0 and 1. When mono (single-channel) audio has multiple speakers, diarization can separate the speakers for analysis. The diarization score identifies how completely the call was divided into individual speakers. A score of 2 means the call was not diarized. Diarization technology is not perfect, and to find calls where diarization is done well, setSCORE
closer to one than to zero. The tradeoff is that fewer calls will be retrieved.- duration=N-M
Search for audio records with durations within the range of
N
toM
, which are a common colon delimited duration formathh:mm:ss
that define a numeric range in seconds, where seconds (ss) is required, hours (hh) and minutes (mm) are optional, and colons are only included as appropriate when hours or minutes are included. The following example would find durations between 30 minutes and one hour:duration=30:00-01:00:00
- overall_emotion=EMOTION
Search for files where the overall emotional score of the audio is
EMOTION
. Possible values forEMOTION
areimproving
,negative
,positive
, andworsening
. Only oneoverall_emotion
value can be used within a single search. For example:overall_emotion=positive
- overall_gender=GENDER
Search for files where the overall gender of the speakers has been identified as
GENDER
. Possible values forGENDER
arefemale
andmale
. Only oneoverall_gender
value can be used within a single search. For example:overall_gender=male
- overtalk=N-M
Search for audio records with overtalk percentages within the range of
N
toM
, which are floating point values. Overtalk occurs when speakers talk over one another. A recording's ovetalk percentage is the count of Agent-initiated overtalk turns as a percentage of the total number of Agent speaking turns. In other words, out of all of the Agent’s turns, it measures how many turns interrupted a Client’s turn. An overtalk value of "1" indicates the most overtalk.- silence=N-M
Search for audio records with silence percentages within the range of
N
toM
, which are floating point values. Silence is equal to all non-speech time, as a percentage of the total audio duration. If music and noise are not decoded to word-events, they are counted as silence. Calls with a silence value of "1" contain the most silence.- terms.FIELD=VALUE
Fields that can identified for searching are the following:
agent
agentid
client
file
requestid
speakers
tag
tid
CLIENT-DATA
- search any of the custom metadata fields that have been entered within the folder with which your audio files are associated
Include multiple terms in the value by using a comma-separated list.
- terms.op=OPERATOR
Combine multiple search terms (and therefore, their associated fields) by using a logical
and
oror
operator, whereand
is the default operator. For example:terms.tid=1,2&terms.op=or