Skip to main content
Glama

Search Social Media Profiles

search_profiles
Read-onlyIdempotent

Search tracked social media profiles by handle or name, filtered by platform. Returns profile metadata, follower counts and average performance stats. Use it to resolve a handle to a profile id before fetching stats or posts, or to discover creators in the database. Results may include deactivated profiles (is_active=false), e.g. an account that was renamed or went private, retained with frozen stats; filter on is_active if you only want live accounts. Note a creator who changed handles can appear as two rows (old deactivated + new active). Cost: 1 credit per 25 profiles returned.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, 1-based. A search serves its first 1,000 profiles; a page past that is refused at no charge, so narrow the filters instead.
queryNoHandle, @handle, or profile URL
pageSizeNoResults per page, 1 to 100 (default 25). Billed per 25 profiles returned: 25 costs 1 credit, 100 costs 4.
platformsNo
categoryIdNoNiche filter: a category id from list_categories (covers its subtree); without a query returns that niche's top profiles

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / page / description
      Added value: +"Page number, 1-based. A search serves its first 1,000 profiles; a page past that is refused at no charge, so narrow the filters instead."
    • addedInput schema / properties / pageSize / description
      Added value: +"Results per page, 1 to 100 (default 25). Billed per 25 profiles returned: 25 costs 1 credit, 100 costs 4."
  2. Changed1 schema field changed
    • addedInput schema / properties / categoryId
      Added value: +{
      +  "description": "Niche filter: a category id from list_categories (covers its subtree); without a query returns that niche's top profiles",
      +  "type": "string"
      +}
  3. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources