HypeAuditor APIhypeauditor.com ↗
Search creators, retrieve Instagram engagement metrics, extract bio contacts, find linked accounts, and get top influencer rankings via the HypeAuditor API.
What is the HypeAuditor API?
This API exposes 5 endpoints covering HypeAuditor's influencer data, including creator search across Instagram, TikTok, YouTube, and Twitter, and detailed Instagram profile analytics. The get_instagram_profile endpoint returns engagement rate, follower count, average likes and comments, and historical metrics. The search_creator endpoint accepts keywords, brand names, or country names and returns matching profiles with follower counts and verification status across all four platforms.
curl -X GET 'https://api.parse.bot/scraper/c8c0b6ea-32c1-4ee1-8616-01d29616788e/search_creator?query=fitness' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace hypeauditor-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: HypeAuditor SDK — search creators, drill into profiles, check rankings."""
from parse_apis.hypeauditor_influencer_api import HypeAuditor, Platform, ProfileNotFound
client = HypeAuditor()
# Search for creators by keyword — returns cross-platform matches.
for creator in client.creators.search(query="fitness", limit=5):
print(creator.full_name, creator.followers_count, creator.type)
# Drill into a specific Instagram profile for detailed metrics.
profile = client.instagramprofiles.get(username="cristiano")
print(profile.title, profile.subscribers_count, profile.engagement_rate)
# Walk sub-resources: linked accounts across platforms.
for account in profile.linked_accounts.list(limit=5):
print(account.platform, account.subscribers_count)
# Contact extraction from bio (emails/phones).
contacts = profile.contacts.get()
print(contacts.bio_raw, contacts.emails, contacts.phones)
# Top influencers ranking with typed error handling.
try:
top = client.rankedinfluencers.list(limit=3).first()
if top:
print(top.fullname, top.rank, top.subscribers_count, top.audience_country_code)
except ProfileNotFound as exc:
print(f"Profile gone: {exc.username}")
print("exercised: creators.search / instagramprofiles.get / linked_accounts.list / contacts.get / rankedinfluencers.list")
Full-text search for creators by keyword across Instagram, TikTok, YouTube, and Twitter. Returns up to 15 matching profiles with follower counts, platform type, and verification status. The query matches creator names, usernames, and associated keywords. Results are not paginated — a single request returns all matches for the query.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword such as a creator name, brand name, or topic. |
{
"type": "object",
"fields": {
"list": "array of creator objects each containing username, full_name, followers_count, type (platform code: ig, tt, yt, tr), avatar_url, is_verified, report_state",
"success": "boolean indicating the search completed successfully"
},
"sample": {
"data": {
"list": [
{
"link": "instagram/fitness/",
"type": "ig",
"user_id": "213052913",
"username": "fitness",
"full_name": "The Fitness Community",
"avatar_url": "https://cdn.hypeauditor.com/img/instagram/user/213052913.jpg?w=150",
"is_private": false,
"is_verified": false,
"report_state": "READY",
"followers_count": 900977
}
],
"success": true
},
"status": "success"
}
}About the HypeAuditor API
Creator Search and Profile Lookup
The search_creator endpoint accepts a query string — a creator name, brand name, or country — and returns an array of matching profiles. Each result includes username, full_name, followers_count, is_verified, avatar_url, and a type field indicating the platform (ig, tt, yt, tr). This makes it useful for building cross-platform creator discovery tools without needing separate lookups per platform.
Instagram Profile Analytics
The get_instagram_profile endpoint takes an Instagram username (no @ prefix) and returns three objects. The basic object includes account metadata: title, description, is_verified, report history, and username history. The metrics object covers subscribers_count, er (engagement rate), following_count, media_count, likes_avg, comments_avg, and historical deltas for each. The service_data object contains internal report metadata. This is the most data-dense endpoint in the set.
Contact Extraction and Linked Accounts
The get_influencer_contact_email endpoint parses an Instagram user's public bio and returns emails, phones, bio_raw, and the queried username. Arrays are empty when no contact information appears in the bio — the response does not throw an error in that case. The get_influencer_linked_accounts endpoint matches a given username across platforms and returns a linked_accounts array where each entry specifies the platform, username, subscribers_count, and avatar.
Top Influencer Rankings
The get_top_instagram_influencers endpoint returns HypeAuditor's global Instagram ranking. The data object contains a reports array with basic profile info and metrics including subscribers_count and engagement_avg. Pagination is controlled with limit and offset integer parameters, allowing you to page through the ranked list in batches.
The HypeAuditor API is a managed, monitored endpoint for hypeauditor.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when hypeauditor.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official hypeauditor.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a creator discovery tool that searches by country or niche keyword and displays follower counts and verification badges across platforms.
- Monitor Instagram engagement rate trends using historical
erandlikes_avgdata fromget_instagram_profile. - Automate outreach by extracting email addresses and phone numbers from influencer bios with
get_influencer_contact_email. - Identify whether a target Instagram creator also has a significant TikTok or YouTube presence using
get_influencer_linked_accounts. - Generate ranked lists of top Instagram influencers for benchmarking using pagination on
get_top_instagram_influencers. - Track username history and account changes over time using the
basicresponse fields fromget_instagram_profile. - Enrich a CRM with live follower counts and engagement averages by batch-querying Instagram usernames.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does HypeAuditor have an official developer API?+
What does `get_instagram_profile` return beyond a follower count?+
basic (account metadata including username history and report history), metrics (engagement rate, following count, media count, average likes and comments with historical deltas), and service_data (internal report metadata). All data pertains to the public Instagram profile.Does `get_influencer_contact_email` always return contact data?+
emails and phones as empty arrays when an influencer's bio contains no contact information. The bio_raw field is always populated with the raw bio text, so you can apply your own parsing logic if needed.Does the API cover TikTok or YouTube profile analytics in the same depth as Instagram?+
get_instagram_profile. The search_creator and get_influencer_linked_accounts endpoints return basic data (follower counts, avatar) for TikTok, YouTube, and Twitter, but there is no dedicated analytics endpoint for those platforms. You can fork this API on Parse and revise it to add a dedicated TikTok or YouTube profile analytics endpoint.Can I filter the top influencer ranking by country or category?+
get_top_instagram_influencers endpoint supports only limit and offset for pagination and returns a global ranking without country or category filters. You can fork this API on Parse and revise it to add filtering parameters if HypeAuditor's ranking pages expose that segmentation.