Skip to main content
GET
/
api
/
v1
/
jobs
/
{jobId}
Get refresh job status
curl --request GET \
  --url https://app.descripio.com/api/v1/jobs/{jobId} \
  --header 'Authorization: Bearer <token>'
{
  "jobId": 2877,
  "asin": "B08N5WRWNW",
  "status": "processing",
  "createdAt": "2026-02-02T10:30:00.000Z",
  "updatedAt": "2026-02-02T10:31:05.000Z",
  "productTitle": "Example Product Title"
}

​
GET /api/v1/jobs/

Check the status of a review scraping job.

​
Request

Headers:
HeaderValueRequired
AuthorizationBearer YOUR_API_KEYYes
Path Parameters:
ParameterTypeDescription
jobIdnumberJob 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"
}
FieldTypeDescription
jobIdnumberJob identifier
asinstringASIN being processed
productTitlestringProduct title (if available)
statusstringqueued | processing | completed | failed | unknown
createdAtstringISO 8601 timestamp of job creation
updatedAtstringISO 8601 timestamp of last status change

​
Job Statuses

StatusDescription
queuedJob is waiting to be processed
processingJob is actively scraping reviews
completedJob finished successfully (reviews now cached)
failedJob failed
unknownUnexpected internal status (fallback value)

​
Errors

StatusErrorCause
400Invalid job IDjobId is not a valid number
401Invalid API keyKey doesn’t exist or was revoked
404Job not foundJob doesn’t exist or belongs to another store
500Internal server errorTemporary 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"