V-Spark Online Help

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 to M, 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 for EMOTION are improving, negative, positive, and worsening. Only one agent_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 for GENDER are female and male. Only one agent_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 named APPNAME 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: app.TOP_CATEGORY.LOWER_CATEGORY.LOWER_CATEGORY Score level may be one of the following values:

  • All - Score greater than 0

  • High - Score greater than 0.66

  • Medium - Score greater than 0.33

  • Low - Score between 0 and 0.33

  • None - Score of 0

client_clarity=N-M

Search for audio records with client voice clarity percentage within the range of N to M, 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 for EMOTION are improving, negative, positive, and worsening. Only one client_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 for GENDER are female and male. Only one client_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 and END values, though optional, are both expressed as YYYYMMDD[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 (where START is less than END). No verification is done to ensure that this is correct. Invalid date ranges will simply return no values. If START is not specified, a default value of 01 January, 1900 is used. If END 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, set SCORE 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 to M, which are a common colon delimited duration format hh: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 for EMOTION are improving, negative, positive, and worsening. Only one overall_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 for GENDER are female and male. Only one overall_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 to M, 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 to M, 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 or or operator, where and is the default operator. For example:

terms.tid=1,2&terms.op=or