lookup_profiles
Batch-fetch up to 100 social media profiles by platform and username. Ideal for comparing multiple accounts or checking if handles are real in one request.
Instructions
Batch-fetch up to 100 profiles by (platform, username) pairs.
Use this when the user has a list of handles and you need profile data for all of
them at once (e.g., "give me follower counts for these 30 accounts I'm considering"
or "which of @a @b @c are real accounts?"). One round-trip beats 30 calls to
get_profile.
Use this for exact batch handle lookup, not semantic discovery. For one exact
platform+username pair, use get_profile. For partial or fuzzy handle/name input,
use search_creators or autocomplete_creators. Use
semantic_search_creators only for topical/niche/audience discovery where
false-positive semantic matches are acceptable.
Examples:
User: "Compare @a, @b, and @c on Instagram" -> use this tool for the exact handle batch.
User: "Give me follower counts for these 30 accounts" -> use this tool.
User: "Find wellness creators in Austin" -> use
semantic_search_creators, not this tool.
The response splits results into data (profiles found) and not_found (the
(platform, username) pairs that weren't recognized). Profiles are returned in no
particular order — re-correlate via the platform/username fields if you need to
preserve input order.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| profiles | Yes | Profiles to lookup |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| results | No | ||
| count | No | ||
| ok | No | ||
| not_found | No | ||
| has_more | No | ||
| next_cursor | No | ||
| suggested_followups | No |