Run app (JSON)

Executes a published NextRows app with the provided inputs and returns the result as an array of JSON objects. Each object represents a row with column names as keys.

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/json
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/json" \  -H "Content-Type: application/json" \  -d '{    "appId": "abc123xyz",    "inputs": [      {        "key": "max-items",        "value": 10      }    ]  }'
{
  "success": true,
  "data": [
    {
      "Name": "Product A",
      "Price": 29.99,
      "URL": "https://example.com/product-a"
    },
    {
      "Name": "Product B",
      "Price": 49.99,
      "URL": "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"
}