Sign in
Default dataset

Store items

Appends an item or an array of items to the end of the Actor run's default dataset.

This endpoint is a shortcut that resolves the run's defaultDatasetId and proxies to the Store items endpoint.

To save bandwidth and speed up your upload, you can send the request payload compressed and set the Content-Encoding header accordingly.

Below is a list of supported Content-Encoding types.

  • Brotli: Content-Encoding: br
  • Gzip: Content-Encoding: gzip
  • Deflate: Content-Encoding: deflate
post/v2/actor-runs/{runId}/dataset/items

Path parameters

runIdstring required
Example:3KH8gEpp4d8uQSe8T

Actor run ID.

Headers

Content-Encoding'br' | 'gzip' | 'deflate' | 'identity'

Compression encoding of the request body.

Request body

PutItemsRequest required

The request body containing the item(s) to add to the dataset. Can be a single object or an array of objects. Each object represents one dataset item.

OR
PutItemsRequest[] required

Example request

{
  "title": "Example Item",
  "url": "https://example.com",
  "price": 19.99
}

Response

object required

Example response

{}

Changes

Changed in 2 of the 7 revisions of this API.16

  • 0a98d6a098a48See the full diff
    • ●

      added the new cannot-publish-actor-task enum value to the anyOf[subschema #2: ErrorResponse]/error/type response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 405

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 413

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 415

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 429

      response-property-enum-value-added

  • b94a8abdfff18See the full diff
    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the anyOf[subschema #2: ErrorResponse]/error/type response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 405

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 413

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 415

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 429

      response-property-enum-value-added