README
@actionsflow/trigger-instagram
This is a instagram trigger of Actionsflow. Any new action in Instagram will trigger the trigger.
This is an official trigger, you don't need to install it manually.
Usage
Get your instagram posts:
on:
instagram:
access_token: ${{ secrets.INSTAGRAM_ACCESS_TOKEN }}
Get somebody's instagram posts:
on:
instagram:
user_id: "17841432487737681"
access_token: ${{ secrets.INSTAGRAM_ACCESS_TOKEN }}
Or, multiple users:
on:
instagram:
user_id:
- "17841432487737681"
- "17841432487737682"
access_token: ${{ secrets.INSTAGRAM_ACCESS_TOKEN }}
Options
access_token
, required, instagram API authentication, you should get it from Facebook Developers App, See also Official docs, How to create access_token using User Token Generatoruser_id
, optional,string
orstring[]
, you can get it by requesting aget
request:https://graph.instagram.com/me?fields=id&access_token={access-token}
, or see this answerfetchAllResultsAtFirst
, optional,boolean
, if fetch all results at first run, the default isfalse
, iftrue
, it will fetch all results of your instagram.maxCount
, optional,number
, iffetchAllResultsAtFirst
istrue
, you can usemaxCount
to limit the number of fetched results, such like1000
.
You can use General Config for Actionsflow Trigger for more customization.
Outputs
An outputs example:
{
"caption": "#coronavirus #no so bad",
"id": "17869684195728842",
"media_type": "IMAGE",
"media_url": "https://scontent-lax3-1.cdninstagram.com/v/t51.2885-15/94169052_3071944286203383_250459185632461249_n.jpg?_nc_cat=102&ccb=2&_nc_sid=8ae9d6&_nc_ohc=mrmFbLbLfeIAX8hhBzd&_nc_ht=scontent-lax3-1.cdninstagram.com&oh=ce7c2480b1f0c6765f525718da8f51c5&oe=602F563C",
"permalink": "https://www.instagram.com/p/B_ZnxcNnfCa/",
"timestamp": "2020-04-25T10:22:38+0000",
"username": "iamowenyoung"
}
You can use the outputs like this:
on:
instagram:
jobs:
print:
name: Print
runs-on: ubuntu-latest
steps:
- name: Print Outputs
env:
outputs: ${{ toJSON(on.instagram.outputs) }}
run: |
echo outputs: $outputs