{"uid":"cap_t6OzDBsEGecz9sH0OKIFf","slug":"instagram-user-id-lookup-by-handle-fetcher-sh-5afbfb0b","name":"Instagram User ID Lookup by Handle — fetcher.sh","description":"Instagram (ig) data and scraping API: Profiles, posts, reels, stories, followers, hashtags, locations, and comment threads. 16 REST endpoints from $0.004 per call — no account, no OAuth, no subscription. Pay with x402 (USDC on Base, Polygon, Arbitrum, Monad or Solana) or prepaid credits.","url":"https://instagram.fetcher.sh/api/userid/%7Bhandle%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_urt-FsTEo_HSH4OyADsbN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves an Instagram username (handle) to its numeric user ID without requiring OAuth or an Instagram account.","exampleAgentPrompt":"What is the Instagram user ID for the handle 'natgeo'? Look it up without needing any login or OAuth.","exampleUseCases":[{"title":"Influencer profile ID resolution","prompt":"I need the numeric Instagram user ID for the handle 'cristiano' so I can pass it to other Instagram API calls — can you look that up?"},{"title":"Brand account ID enrichment","prompt":"We're building a database of brand Instagram accounts. Can you fetch the Instagram user IDs for the handles 'nike' and 'adidas' so we can store them?"},{"title":"Competitor monitoring setup","prompt":"I want to monitor posts from the Instagram account 'bbcnews' — first, can you resolve that handle to its Instagram user ID so I can wire up the rest of the pipeline?"}],"resultDescription":"Returns the numeric Instagram user ID corresponding to the provided handle, enabling downstream API calls (posts, followers, reels, etc.) that require an internal IG user ID rather than a username.","failureModes":["Handle does not exist or is misspelled — likely returns 404 or empty result","Account is private or suspended — may return null ID or error","Instagram anti-scraping measures may cause transient failures or rate limiting","Invalid handle format (e.g. spaces, special characters) — likely returns 400","Payment failure via x402 if wallet balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need to resolve an Instagram handle to a user ID without an Instagram developer account, OAuth tokens, or a subscription. It is ideal for agent pipelines that need to bootstrap downstream Instagram data calls using only a username, and for use cases requiring pay-per-call micro-billing in USDC with no upfront commitment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:53:06.022Z","isFirstParty":false}