List Delivery Logs

List tweet delivery logs for stream monitors. Shows each detected tweet with detection latency, delivery status, and webhook response details. Useful for monitoring stream health and debugging delivery issues.

GET /v1/twitter/stream/logs

List delivery logs

cURL

curl --request GET \
  --url https://scrapebadger.com/v1/twitter/stream/logs \
  --header 'x-api-key: <api-key>'

200

{
  "logs": [
    {
      "id": "<string>",
      "monitor_id": "<string>",
      "tweet_id": "<string>",
      "delivery_status": "<string>",
      "monitor_name": "<string>",
      "author_username": "<string>",
      "tweet_text_preview": "<string>",
      "tweet_url": "<string>",
      "tweet_published_at": "2023-11-07T05:31:56Z",
      "detected_at": "2023-11-07T05:31:56Z",
      "latency_ms": 123,
      "latency_badge": "<string>",
      "webhook_status_code": 123,
      "webhook_attempts": 123
    }
  ],
  "total": 123,
  "page": 123,
  "page_size": 123
}

Authorizations

x-api-key · string · header · required

Your ScrapeBadger API key. You can find this in your dashboard at https://scrapebadger.com/dashboard/api-keys.

Query Parameters

monitor_id · string

Filter logs by stream monitor ID.

page · integer · default: 1

Page number for pagination.

Required range: x >= 1

page_size · integer · default: 20

Number of logs per page.

Required range: 1 <= x <= 100

Response

200

application/json

Successfully retrieved delivery logs.

logs · object[]

Show child attributes

total · integer

Total number of delivery logs.

page · integer

Current page number.

page_size · integer

Number of items per page.