@apidirect/piece-api-direct
v0.3.10
Published
Activepieces piece for API Direct: search and monitor Twitter/X, Facebook, Instagram, TikTok, YouTube, Reddit, Threads, Truth Social, Bluesky, Substack, Amazon, Trustpilot and Google from your flows.
Maintainers
Readme
API Direct for Activepieces
The official Activepieces piece for API Direct: search and monitor social media, news, reviews and the web from your flows.
API Direct is a pay-as-you-go API for real-time data from Twitter/X, Facebook, Instagram, TikTok, YouTube, Reddit, Threads, Truth Social, Bluesky, Substack, Amazon, Trustpilot and Google, all through one key and one consistent interface. There are no subscriptions: you only pay for the requests you make.
Installation
On a self-hosted Activepieces instance, open Settings → Pieces → Install Piece and enter the package name @apidirect/piece-api-direct.
Connection
- Sign up at apidirect.io. Every account gets 50 free requests per endpoint every month, no card required.
- Create a key on the API Keys page.
- In Activepieces, add an API Direct connection and paste the key.
Activepieces checks the key against the cheapest endpoint (/v1/time, $0.001). See Authentication.
Actions
143 actions plus a Custom API Call for anything else in the API reference:
| Platform | Actions | |---|---| | Twitter | Search Twitter Posts, Search Twitter Users, Twitter User Profile, Twitter User Tweets, Twitter User Followers, Twitter User Following, Twitter Verified Followers, Twitter User Replies, Twitter Tweet Details, Twitter Tweet Retweets, Twitter Quote Tweets, Twitter Tweet Comments, Twitter Trending Topics | | Facebook | Search Facebook Posts, Search Facebook Locations, Search Facebook Pages, Search Facebook Videos, Search Facebook Events, Facebook Page Details, Facebook Page Posts, Facebook Page Photos, Facebook Page Videos, Facebook Page Reels, Facebook Page Reviews, Facebook Group Details, Facebook Group Posts, Search Facebook Group Posts, Facebook Post Comments | | Instagram | Search Instagram Posts, Search Instagram Users, Instagram User Profile, Instagram User Posts, Instagram Post Details, Instagram User Followers, Instagram User Following, Instagram User Stories, Instagram User Highlights, Instagram Highlight Stories, Instagram Post Comments, Instagram Comment Replies, Instagram Post Likes, Instagram Hashtag Posts | | LinkedIn | Search LinkedIn Posts, LinkedIn Person Profile, LinkedIn Person Posts, LinkedIn Post Details, Search LinkedIn Companies, LinkedIn Company Details, LinkedIn Company Posts, Search LinkedIn Jobs, LinkedIn Job Details | | TikTok | Search TikTok Videos, Search TikTok Users, TikTok User Profile, TikTok Video Details, TikTok User Videos, TikTok User Likes, TikTok User Stories, TikTok User Followers, TikTok User Following, TikTok Video Comments, TikTok Comment Replies, Search TikTok Hashtags, TikTok Hashtag Details, TikTok Hashtag Videos, TikTok Music Details, TikTok Music Videos, TikTok Playlist Details, TikTok Playlist Videos | | YouTube | Search YouTube Videos, Search YouTube Channels, YouTube Channel Details, YouTube Video Details, YouTube Video Comments | | Reddit | Search Reddit Posts, Search Reddit Comments, Search Reddit Users, Search Reddit Subreddits, Reddit Post Details, Reddit Post Comments, Reddit Post Crossposts, Reddit User Profile, Reddit User Posts, Reddit User Comments, Reddit Subreddit Details, Reddit Subreddit Posts, Reddit Subreddit Rules, Reddit Trending Posts | | Threads | Search Threads Posts, Search Threads Users, Threads User Profile, Threads User Posts | | Truth Social | Truth Social User Posts | | Bluesky | Search Bluesky Posts, Search Bluesky Users, Bluesky User Profile, Bluesky User Posts, Bluesky User Followers, Bluesky User Following, Bluesky User Likes, Bluesky Post Details, Bluesky Post Comments, Bluesky Post Likes, Bluesky Post Quotes, Bluesky Post Reposts | | Substack | Search Substack Posts, Search Substack Users, Search Substack Publications, Search Substack Notes, Substack User Profile, Substack User Posts, Substack User Activity, Substack Publication Details, Substack Publication Posts, Substack Publication Recommendations, Substack Post Details, Substack Post Comments, Substack Post Likes, Substack Note Details, Substack Category Publications, Substack Category Feed, Substack Trending Posts | | Amazon | Search Amazon Products, Amazon Product Details, Amazon Seller Profile, Amazon Seller Reviews, Amazon Seller Products, Amazon Best Sellers | | Trustpilot | Trustpilot Company Reviews, Search Trustpilot Companies, Trustpilot Category Companies, Trustpilot Category Newest, Trustpilot Category Details, Search Trustpilot Categories, Trustpilot User Profile | | Google Search | Google Web Search, Google AI Mode | | Google Places | Search Google Places, Google Place Details, Google Place Reviews, Google Place Photos | | News | Search News Articles | | Forums | Search Forum Posts |
Every action's description shows its price. Most list actions take an optional Get Sentiment checkbox that adds emotion, polarity and intensity scores to each result, and a Pages field that fetches several pages in one call (each page is billed as one request).
Usage notes
- Pagination: list actions take
PagesorPageinstead of cursors. See Pagination. - Boolean search: search actions pass the query to each platform's own search engine, so exact phrases,
OR, exclusions and grouping work where the platform supports them. See Boolean search. - Dependent IDs: some Facebook actions need IDs returned by others.
Facebook Page Detailsreturns thepage_id,delegate_page_idandreels_page_idused by the page posts, videos and reels actions;Search Facebook Locationsreturns thelocation_idused to filter post and event searches. - Output: each action returns the API response as documented, with an output schema so the flow builder shows the fields by name.
Support
- Documentation: apidirect.io/docs, including error codes and rate limits.
- Help, bugs and feature requests: [email protected].
Development
The action files are generated from the public OpenAPI spec (https://apidirect.io/openapi.json) by generate.py; re-run it after the spec changes instead of editing them by hand.
