Jobs

Submit Topic Extraction Job

Starts an asynchronous job to extract topics from a transcript. The transcript can be supplied through text as plain text or json as a rev.com transcript format

SecurityAccessToken
Request
Request Body schema: application/json

Topic Extraction Job Options

metadata
string or null <= 512 characters

Optional metadata that was provided during job submission.

callback_url
string or null <= 1024 characters
Deprecated

Deprecated. Use notification_config instead. Optional callback url to invoke when processing is complete. If this parameter is used to pass in the callback url, the callback url will be visible in the response. It is recommended to provide webhooks with the notification_config parameter as authorization headers can be included and both the callback url and auth headers will be encrypted when stored.

object or null

Optional configuration for a callback url to invoke when processing is complete, in addition to auth headers if they are needed to invoke the callback url. Cannot be set if callback_url is set. This option will not be visible in the submission response.

delete_after_seconds
integer or null [ 0 .. 2592000 ]

Amount of time after job completion when job is auto-deleted. Present only when preference set in job request.

language
string or null
Default: "en"

The user input language of the transcript.

Value: "en"
text
string or null

Plain text to be analyzed in this job submission. No timestamps will be included in the response if input is provided this way.

object or null

Rev AI Transcript Model

Responses
200

Topic Extraction Job Details

400

Bad Request

401

Request Unauthorized

413

Payload Too Large

post/topic_extraction/v1/jobs
Request samples
application/json
{
  • "language": "en",
  • "metadata": "sample user provided metadata",
  • "notification_config": {},
  • "delete_after_seconds": 1000000,
  • "json": {
    }
}
Response samples
application/json
{
  • "id": "Umx5c6F7pH7r",
  • "status": "in_progress",
  • "language": "en",
  • "created_on": "2018-05-05T23:23:22.29Z",
  • "type": "topic_extraction"
}

Get List of Topic Extraction Jobs

Gets a list of topic extraction jobs submitted within the last 30 days in reverse chronological order up to the provided limit number of jobs per call. Note: Jobs older than 30 days will not be listed. Pagination is supported via passing the last job id from a previous call into starting_after.

SecurityAccessToken
Request
query Parameters
limit
integer or null [ 0 .. 1000 ]
Default: 100

Limits the number of jobs returned, default is 100, max is 1000

starting_after
string or null

If specified, returns jobs submitted before the job with this id, exclusive (job with this id is not included)

Responses
200

List of Rev AI Topic Extraction Jobs

400

Bad Request

401

Request Unauthorized

get/topic_extraction/v1/jobs
Request samples
curl -i -X GET \
  'https://api.rev.ai/topic_extraction/v1/jobs?limit=100&starting_after=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
Response samples
application/json
[
  • {
    },
  • {
    }
]

Get Topic Extraction Job By Id

Returns information about a topic extraction job

SecurityAccessToken
Request
path Parameters
id
required
string

Rev AI API Job Id

Responses
200

Topic Extraction Job Details

401

Request Unauthorized

404

Job Not Found

get/topic_extraction/v1/jobs/{id}
Request samples
curl -i -X GET \
  'https://api.rev.ai/topic_extraction/v1/jobs/{id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
Response samples
application/json
{
  • "id": "Umx5c6F7pH7r",
  • "status": "in_progress",
  • "language": "en",
  • "created_on": "2018-05-05T23:23:22.29Z",
  • "type": "topic_extraction"
}

Delete Topic Extraction Job by Id

Deletes a topic extraction job. All data related to the job will be permanently deleted. A job can only be deleted once it's completed (either with success or failure).

SecurityAccessToken
Request
path Parameters
id
required
string

Rev AI API Job Id

Responses
204

Job was successfully deleted

401

Request Unauthorized

404

Job Not Found

409

Conflict

delete/topic_extraction/v1/jobs/{id}
Request samples
curl -i -X DELETE \
  'https://api.rev.ai/topic_extraction/v1/jobs/{id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
Response samples
application/problem+json
{
  • "title": "Authorization has been denied for this request",
  • "status": 401
}

Get Topic Extraction Result By Id

Returns the results for a completed topic extraction job.

SecurityAccessToken
Request
path Parameters
id
required
string

Rev AI API Job Id

query Parameters
threshold
number or null [ 0 .. 1 ]
Default: 0.3

Score threshold for topics. If specified all topics with a score lower than this threshold will be filtered out

Responses
200

Rev AI API Topic Result

401

Request Unauthorized

404

Job Not Found

409

Conflict

get/topic_extraction/v1/jobs/{id}/result
Request samples
curl -i -X GET \
  'https://api.rev.ai/topic_extraction/v1/jobs/{id}/result?threshold=0.3' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
Response samples
application/vnd.rev.topic.v1.0+json
{
  • "topics": [
    ]
}