Skip to content

Get status

Request status

You can check the status of your request by sending a GET request to the following endpoint. Please note that this endpoint is not intended for polling.

Base URL

GET https://tiktok-scraper-api.datashake.com/v1/requests/:request_id

Request parameters

request_id

Field type: string
Required: true
Description: The unique identifier for the request.

Code example 
curl --location 'https://tiktok-scraper-api.datashake.com/v1/requests/1742517759478683074-2b1a61cf-89d0-4d' --header 'x-api-key: your-api-key'

import requests

url = "https://tiktok-scraper-api.datashake.com/v1/requests/1742517759478683074-2b1a61cf-89d0-4d"

headers = {
    "x-api-key": "your-api-key"
}

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

Response

API Response example 
{
    "request_id": "1742517759478683074-2b1a61cf-89d0-4d",
    "created_at": "2025-03-21T00:42:39.480627+00:00",
    "updated_at": "2025-03-21T00:45:11.696992+00:00",
    "status": "completed",
    "credits_used": 100,
    "request_metadata": {
        "callback_url": "https://example.com/callback",
        "external_identifier": null,
        "get_comments": true,
        "url": "https://www.tiktok.com/@surthycooks/video/7473271005096463671"
    }
}

The status indicates the general state of the request. It can have the following values: created, in_progress, failed, login_required, or completed