Get refresh job status

curl --request GET \
  --url https://app.descripio.com/api/v1/jobs/{jobId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.descripio.com/api/v1/jobs/{jobId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.descripio.com/api/v1/jobs/{jobId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.descripio.com/api/v1/jobs/{jobId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.descripio.com/api/v1/jobs/{jobId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.descripio.com/api/v1/jobs/{jobId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.descripio.com/api/v1/jobs/{jobId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "jobId": 2877,
  "asin": "B08N5WRWNW",
  "status": "processing",
  "createdAt": "2026-02-02T10:30:00.000Z",
  "updatedAt": "2026-02-02T10:31:05.000Z",
  "productTitle": "Example Product Title"
}

{
  "error": "Invalid job ID"
}

{
  "error": "Invalid API key",
  "message": "Unable to process request. Please retry in a few moments.",
  "retryable": true
}

{
  "error": "Job not found"
}

{
  "error": "Invalid API key",
  "message": "Unable to process request. Please retry in a few moments.",
  "retryable": true
}

GET

api

jobs

{jobId}

Get refresh job status

curl --request GET \
  --url https://app.descripio.com/api/v1/jobs/{jobId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.descripio.com/api/v1/jobs/{jobId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.descripio.com/api/v1/jobs/{jobId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.descripio.com/api/v1/jobs/{jobId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.descripio.com/api/v1/jobs/{jobId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.descripio.com/api/v1/jobs/{jobId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.descripio.com/api/v1/jobs/{jobId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "jobId": 2877,
  "asin": "B08N5WRWNW",
  "status": "processing",
  "createdAt": "2026-02-02T10:30:00.000Z",
  "updatedAt": "2026-02-02T10:31:05.000Z",
  "productTitle": "Example Product Title"
}

{
  "error": "Invalid job ID"
}

{
  "error": "Invalid API key",
  "message": "Unable to process request. Please retry in a few moments.",
  "retryable": true
}

{
  "error": "Job not found"
}

{
  "error": "Invalid API key",
  "message": "Unable to process request. Please retry in a few moments.",
  "retryable": true
}

GET /api/v1/jobs/

Check the status of a review scraping job.

Request

Headers:

Header	Value	Required
Authorization	`Bearer YOUR_API_KEY`	Yes

Path Parameters:

Parameter	Type	Description
jobId	number	Job ID from `POST /reviews/refresh`

Response (200 OK)

{
  "jobId": 2877,
  "asin": "B08N5WRWNW",
  "productTitle": "Example Product Title",
  "status": "completed",
  "createdAt": "2026-02-02T10:30:00.000Z",
  "updatedAt": "2026-02-02T10:31:05.000Z"
}

Field	Type	Description
jobId	number	Job identifier
asin	string	ASIN being processed
productTitle	string	Product title (if available)
status	string	`queued` \| `processing` \| `completed` \| `failed` \| `unknown`
createdAt	string	ISO 8601 timestamp of job creation
updatedAt	string	ISO 8601 timestamp of last status change

Job Statuses

Status	Description
queued	Job is waiting to be processed
processing	Job is actively scraping reviews
completed	Job finished successfully (reviews now cached)
failed	Job failed
unknown	Unexpected internal status (fallback value)

Errors

Status	Error	Cause
400	`Invalid job ID`	jobId is not a valid number
401	`Invalid API key`	Key doesn’t exist or was revoked
404	`Job not found`	Job doesn’t exist or belongs to another store
500	`Internal server error`	Temporary backend/service issue

Examples

cURL:

curl https://app.descripio.com/api/v1/jobs/2877 \
  -H "Authorization: Bearer dscr_abc123..."

Python (with polling):

import requests
import time

API_KEY = "dscr_abc123..."
job_id = 2877
max_attempts = 24  # 2 minutes max

for attempt in range(max_attempts):
    response = requests.get(
        f"https://app.descripio.com/api/v1/jobs/{job_id}",
        headers={"Authorization": f"Bearer {API_KEY}"}
    )
    
    job = response.json()
    status = job["status"]
    
    if status == "completed":
        print(f"✅ Job complete! Fetching reviews...")
        break
    elif status == "failed":
        print(f"❌ Job failed")
        break
    else:
        print(f"⏳ Status: {status}, waiting...")
        time.sleep(5)
else:
    print("⚠️ Timeout: Job took longer than expected")

JavaScript (with polling):

async function pollJob(jobId, apiKey) {
  const maxAttempts = 24;
  
  for (let attempt = 0; attempt < maxAttempts; attempt++) {
    const response = await fetch(
      `https://app.descripio.com/api/v1/jobs/${jobId}`,
      { headers: { 'Authorization': `Bearer ${apiKey}` } }
    );
    
    const job = await response.json();
    
    if (job.status === 'completed') {
      console.log('Job complete!');
      return job;
    } else if (job.status === 'failed') {
      throw new Error('Job failed');
    }
    
    console.log(`Status: ${job.status}, waiting...`);
    await new Promise(resolve => setTimeout(resolve, 5000));
  }
  
  throw new Error('Timeout');
}

Best Practices

Poll interval: Start with 5 seconds, use exponential backoff if needed
Max timeout: Set a reasonable limit (2-3 minutes) to avoid infinite loops
Error handling: Always check for failed status and handle gracefully

Authorizations

Authorization

string

header

required

API key passed in Authorization header as Bearer token.

Path Parameters

jobId

integer

required

Response

Job found

jobId

integer

required

Example:

2877

asin

string

required

Example:

"B08N5WRWNW"

status

enum<string>

required

pending→queued, in_progress→processing, success→completed, failed→failed.

Available options:

queued,

processing,

completed,

failed,

unknown

Example:

"processing"

createdAt

string<date-time>

required

Example:

"2026-02-02T10:30:00.000Z"

updatedAt

string<date-time>

required

Example:

"2026-02-02T10:31:05.000Z"

productTitle

string | null

Example:

"Example Product Title"

POST /reviews/refresh GET /reviews

​GET /api/v1/jobs/

​Request

​Response (200 OK)

​Job Statuses

​Errors

​Examples

​Best Practices

Authorizations

Path Parameters

Response

GET /api/v1/jobs/

Request

Response (200 OK)

Job Statuses

Errors

Examples

Best Practices