Run app (Table)

Executes a published NextRows app with the provided inputs and returns the result as table data with column headers and rows.

Currently, the API playground is under heavy development.
  • If you want to specify the extraction schema, please use the 'Open JSON Editor' button.
POST
/v1/apps/run/table
AuthorizationBearer <token>

The API key to authenticate the request.

In: header

Request Body

application/json

appId*string

The ID of the app to run.

inputs*

Array of input parameters for the app. Each input has a key-value pair.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.nextrows.com/v1/apps/run/table" \  -H "Content-Type: application/json" \  -d '{    "appId": "abc123xyz",    "inputs": [      {        "key": "max-items",        "value": 10      }    ]  }'
{
  "success": true,
  "data": {
    "columns": [
      "Name",
      "Price",
      "URL"
    ],
    "tableData": [
      [
        "Product A",
        29.99,
        "https://example.com/product-a"
      ],
      [
        "Product B",
        49.99,
        "https://example.com/product-b"
      ]
    ]
  },
  "runId": "run_abc123",
  "elapsedTime": 2500
}
{
  "success": false,
  "error": "Bad request"
}
{
  "success": false,
  "error": "Unauthorized"
}
{
  "success": false,
  "error": "Credits exhausted"
}
{
  "success": false,
  "error": "App not found"
}
{
  "success": false,
  "error": "Internal server error"
}