# StableSocial Job Status Poller

> StableSocial Job Status Poller is a free API for AI agents from StableSocial at stablesocial.dev, callable via MPP, Free, status unknown (last checked 2026-10-10, last successful call 2026-06-27).

Polls the status of an async social media scraping job and retrieves results using a signed JWT job token.

## Facts

- Endpoint: GET https://stablesocial.dev/api/jobs?utm_source=zero.xyz
- Price: Free
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-06-27
- Success rate: 100% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 311
- Provider: StableSocial
- Docs: https://stablesocial.dev
- Website: https://stablesocial.dev
- Tags: tiktok, instagram, facebook, reddit, scraping, social, data
- Canonical page: https://www.zero.xyz/c/stablesocial-jobs-f22364c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cEj6VRpWQeZYEUzoJ94rz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stablesocial-jobs-f22364c2
```

Example prompt: Check if my StableSocial scraping job is done and get the results — here's the job token from the 202 response: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.abc123.xyz

## When to prefer this

Use this endpoint after receiving a 202 Accepted response from any StableSocial scraping endpoint (TikTok, Instagram, Facebook, Reddit). This is the only way to retrieve async job results on the StableSocial platform. Prefer this over re-submitting the original request — only the paying wallet can poll, so ensure wallet auth context is preserved.

## Known failure modes

- Invalid or expired JWT token returns 401 unauthorized
- Wallet mismatch — polling with a different wallet than the one that paid returns 403 forbidden
- Job not yet complete returns a pending status with no results
- Malformed token returns 400 bad request
- Job ID not found returns 404

## How this service works

List durable StableSocial jobs, or poll a legacy token. Requires SIWX wallet auth from the paying wallet.

## Output

Returns the current status of the async job (e.g. pending, complete, failed) and, if complete, the scraped social media data payload (posts, comments, followers, etc.) originally requested. Only accessible to the wallet that initiated and paid for the job.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum jobs to return when listing durable jobs"
  },
  "token": {
   "type": "string",
   "minLength": 1,
   "description": "Legacy signed JWT job token from a 202 response"
  },
  "cursor": {
   "type": "string",
   "description": "Pagination cursor from a previous durable job list response"
  },
  "status": {
   "enum": [
    "pending",
    "finished",
    "failed"
   ],
   "type": "string",
   "description": "Optional durable job status filter"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablesocial-jobs-f22364c2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablesocial.dev](https://www.zero.xyz/host/stablesocial.dev/llms.txt)
