Download every result of a job (JSON Lines)

The job's results_url: every result as JSON Lines (one JobResult object per line, in completion order), streamed. The URL is signed: it needs no API key and works until results_url_expires_at; GET the job again for a fresh one. Free.

Auth: none: the signed URL is the credential.

Example

cURL

curl 'https://socialtap.dev/v1/jobs/<id>/results.jsonl'

Path parameters

idstringrequired

Job ID (job_…).

Query parameters

accountstringmax 100 chars

Set by SocialTap: the job's account (and mode).

expiresintegermin 0

Set by SocialTap: when the URL stops working (Unix seconds).

signaturestringmax 200 chars

Set by SocialTap: the URL's signature.

Response

application/json

200

Download every result of a job (JSON Lines) (application/jsonl)

400

400 Bad Request.

invalid_inputNo retry

A parameter is missing or malformed, or the link is not one this endpoint takes.

Fix the parameter named in param as the message says. For a link of the wrong kind, call an endpoint listed in details.endpoints, when there is one.

401

401 Unauthorized.

unauthorizedNo retry

The x-api-key header is missing, or its key is unknown or revoked. On the dashboard's routes: the session cookie is missing or expired.

Send a valid API key in the x-api-key header. No key yet? A person gets one at details.signup_url; an AI agent follows details.agent_auth_url.

404

404 Not Found.

job_not_foundNo retry

The account has no job with this ID: the ID is wrong, or the job is past its retention.

Check the job ID. Finished jobs are kept for a limited time.

operationId jobs.results.download