Response format
Every actor returns the same envelope, so your code never changes shape between actors.
{
"actor": "github-repo",
"status": "SUCCEEDED",
"stats": { "items": 1, "runtime_secs": 0.4 },
"items": [ { "full_name": "torvalds/linux", "stargazers_count": 178000 } ],
"sources": [ "https://api.github.com/repos/torvalds/linux" ],
"brand": "Vector by Phoenix · PHX-IT",
"copyright": "© 2026 Skyler J. Jones (PHX-IT). MIT licensed."
}
Fields
| Field | Type | Meaning |
|---|---|---|
actor | string | The actor that ran. |
status | string | SUCCEEDED, FAILED, or PARTIAL. |
stats | object | items count and runtime_secs. |
items | array | The data. Point your app here. |
sources | array | Every URL the data came from — cited by design. |
brand / copyright | string | Attribution. |
The golden rule
Whatever actor you call, read response.items. That's the contract — one shape, every time.