{"uid":"cap_NgCGfKU7oa3bbDAEn2Ssc","slug":"glim-sh-twitter-user-profile-lookup-796529d7","name":"glim.sh Twitter User Profile Lookup","description":"Fetch a user profile by username or ID","url":"https://glim.sh/api/v1/twitter/users/:ref","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{},"description":"No body parameters - the user @handle or id is taken from the URL path"},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"pathParams":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data"],"properties":{"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WGUoq8RZRAiN-na6gcN_F","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a live Twitter/X user profile by username or user ID, returning account metadata and stats","exampleAgentPrompt":"Look up the Twitter profile for @paulg — I want their bio, follower count, and when the account was created.","exampleUseCases":[{"title":"Influencer research for campaign targeting","prompt":"Pull the Twitter profile for @sama — I need their follower count, bio, and verified status so I can decide whether to reach out for a partnership."},{"title":"Resolving a Twitter handle to account details","prompt":"I have a Twitter username 'naval' — can you fetch their full profile so I can see their account stats and description?"},{"title":"Monitoring a competitor's social presence","prompt":"Fetch the current Twitter profile for @OpenAI, including their follower count and bio, so I can track how their account is growing."}],"resultDescription":"Returns a live Twitter/X user profile object including display name, username (handle), bio/description, follower count, following count, tweet count, profile image URL, account creation date, verified status, and other public account metadata.","failureModes":["User not found — username or ID does not exist or account is suspended","Rate limit exceeded — too many requests in a short window","Private/protected account — profile details may be restricted","Invalid ref format — malformed username or ID returns a 400-level error","Twitter API downstream outage — service temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need live, up-to-date Twitter/X user profile data (follower counts, bio, verified status) for a specific user by handle or ID. Prefer it over cached social data sources when recency matters, or when enriching contact records with current social metadata. It's the right choice when you already know the username or ID and need a direct profile lookup rather than a search.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:31.408Z","isFirstParty":false}