Skip to content

Conversation

ammeek
Copy link

@ammeek ammeek commented Sep 10, 2025

I've wrote a short guide that shows how to use Apify from Kestra flows (running Actors, getting the last run, fetching datasets as files or structured JSON, and a simple example flow). It includes:

A friendly intro to Kestra + why it pairs nicely with Apify

Authentication notes (API key + Kestra Secrets)

A step-by-step example flow and a copy-paste YAML you can run in Kestra

Links to the plugin repo and relevant docs, plus a small troubleshooting section

Please let me know if any changes are required.

@ammeek ammeek changed the title Add page for Kestra integration. docs: add page for Kestra integration Sep 10, 2025
@ammeek ammeek marked this pull request as ready for review September 11, 2025 18:38
@ammeek ammeek requested a review from TC-MO as a code owner September 11, 2025 18:38
1. Add a new task below the **run_apify_actor** with an ID of **get_dataset** and a type of **io.kestra.plugin.apify.dataset.Get**.:
1. Configure the **get_dataset** to fetch the dataset generated by the **run_apify_actor** task by configuring the following values:
- **datasetId**: The ID of the dataset to fetch. You can use the value from the previous task using the following syntax: "\{\{secret(namespace=flow.namespace, key='APIFY_API_KEY')\}\}"
- **apiToken**: A reference to the secret value you set up earlier. For example '\{\{secret(namespace=flow.namespace, key='APIFY_API_KEY')\}\}'

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like apiToken made it in here twice.

@drobnikj drobnikj self-requested a review September 12, 2025 07:23
Copy link

@fdelbrayelle fdelbrayelle left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for having added this doc!

@ammeek
Copy link
Author

ammeek commented Sep 12, 2025

Thank you all for the feedback. I've committed all of the suggested changes.

I noticed that their is also a reference to the docs and repos for other integrations on the Integrate with Apify page so I've added a reference to Kestra as well.

@fdelbrayelle are you able to confirm that the Kestra documentation for Apify will eventually be available from the link bellow?
'https://kestra.io/plugins/plugin-apify'

Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR is being reviewed by Cursor Bugbot

Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, please have a team admin upgrade your team to Bugbot Pro by visiting the Cursor dashboard. Your first 14 days will be free!

Comment @cursor review or bugbot run to trigger another review on this PR

- id: get_data_set_raw
type: io.kestra.plugin.apify.dataset.Get
datasetId: '{{outputs.run_actor.defaultDatasetId}}'
apiToken: "{{secret(namespace=flow.namespace, key='APIFY_API_KEY')}}"
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: YAML Configuration Errors in Kestra Guide

The example YAML in the Kestra integration guide has a few issues. The maxItems property is incorrectly placed under the actor.Run task, where it will likely be ignored or cause errors, as it's intended for dataset fetching operations. Additionally, the apiToken property is redundantly specified for both tasks, which could lead to confusion.

Fix in Cursor Fix in Web

@fdelbrayelle
Copy link

@fdelbrayelle are you able to confirm that the Kestra documentation for Apify will eventually be available from the link bellow? 'https://kestra.io/plugins/plugin-apify'

Yes @ammeek correct! @aj-emerich It will be from 1.1, won't it?

@aj-emerich
Copy link

Yeah that looks correct.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants