NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Hypeauditor connects to a Nagent workspace with an API key. Once it is connected, agents can call 4 Hypeauditor actions, such as "Get Instagram Account Media", "Get Instagram report" and "Get TikTok Analytics Report". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Hypeauditor, with input parameters and output schema.
HYPEAUDITOR_GET_ACCOUNT_MEDIATool to retrieve media content of an Instagram account. Use when you need detailed post-level data and performance metrics for analysis.
Input parameters
Optional API version parameter if required by the endpoint (e.g., '2').
Social network type. Some deployments require this explicitly.
Instagram account username to retrieve media for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HYPEAUDITOR_GET_REPORT_INSTAGRAMTool to retrieve a detailed Instagram report. Use after providing username or user_id. Example: GET_REPORT_INSTAGRAM(username="nasa").
Input parameters
API version; only v=2 is supported.
Instagram user ID string. Required if username is not provided.
List of additional features to include. Allowed values: ranking, mentions, mentioned_by, notable_audience, audience_brand_affinity, er_benchmarks.
Instagram username without '@'. Required if user_id is not provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HYPEAUDITOR_GET_REPORT_TIK_TOKRetrieves comprehensive analytics report for a TikTok account including audience demographics, engagement metrics, content performance, follower growth, and authenticity scores. Use this to analyze TikTok influencers or get detailed insights about a TikTok channel's performance and audience quality.
Input parameters
API version string in YYYY-MM-DD format. If not specified, the latest API version is used automatically. Most users should omit this parameter.
TikTok username (handle) without the '@' symbol. Example: for @littlebig, use 'littlebig'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HYPEAUDITOR_SEARCH_INFLUENCERS_SUGGESTERTool to search for influencer social network accounts by keyword. Use when you need to find influencers matching a search term, with optional filtering by social network type.
Input parameters
Social network types supported by HypeAuditor
Social Network Types to exclude from results. Can be a single type (e.g., 'IG') or comma-separated list (e.g., 'IG,TT').
Search keyword to find influencer accounts (e.g., 'fashion', 'tech', 'fitness')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 4 Hypeauditor actions on Nagent, including "Get Instagram Account Media", "Get Instagram report" and "Get TikTok Analytics Report". Get Instagram Account Media: Retrieve media content of an Instagram account. Each action is listed on this page with its input parameters and its output.
Hypeauditor connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Get Instagram Account Media takes 1 required input: username. It also takes 2 optional inputs: v and type. It returns data, error and successful.