anycapanycap
Capabilities

Generate

Image GenerationCreate and edit images from prompts or references.Video GenerationCreate motion outputs from text and image inputs.Music GenerationProduce music tracks through one runtime.Audio GenerationGenerate speech, dialogue, sound effects, and complete audio scenes from text, audio, or image input.

Understand

Image UnderstandingRead screenshots, diagrams, and visual references.Video AnalysisInspect recordings and extract structured details.Audio UnderstandingTranscribe and analyze voice and audio files.

Retrieve

Web SearchSearch the web from the same agent workflow.Grounded Web SearchReturn synthesized answers with live citations.Web CrawlFetch pages and convert them into clean content.Social Media LookupRead Instagram and X profiles, posts, feeds, and X search results.

Store

DriveStore outputs, organize assets, and create public URLs.
Equip Agents
Claude CodeCursorCodexDeepSeek HarnessManus
Resources

Explore

GuidesDecision guides for building reliable agent workflows.Context EngineeringUnderstand how prompts, files, and workspace state shape agent behavior.Agent SkillsSee how reusable skills package workflows and capability usage for agents.

Evaluate

Compare AnyCapBrowse comparison pages for adjacent agent tooling, media APIs, and tradeoffs.GlossaryA shared vocabulary for agent capabilities, tools, and workflows.
Docs ↗Pricing
I'm Agent
I'm Agent
  1. Home
  2. Capabilities
  3. Social Media Lookup

Capabilities · Last updated September 29, 2026

Social media lookup for AI agents

AnyCap social media lookup gives agents structured Instagram and X data through the same CLI they already use for search, crawl, generation, and analysis. The agent can read an account profile, fetch a post or reel by URL, list an account's recent posts, or search X, and get back normalized JSON instead of scraped HTML.

Equip your AgentInstagram guideX guide
Codex CLI terminal: an English prompt asks AnyCap to compare the natgeo and nasa Instagram accounts, Codex runs two anycap social profile lookups, and answers with a table of followers, following, posts, and verification.
A real Codex CLI run against production AnyCap on September 29, 2026: one English prompt, two profile lookups at 1 credit each, and a table built from the returned fields.

The short answer

Use AnyCap social media lookup when the agent needs facts from Instagram or X, such as follower counts, post text, media, or engagement, and would otherwise have to scrape a page or wire a separate social data API.

  • Four operations cover both platforms: profile, get, list, and search.
  • Instagram and X results share one JSON shape for profiles, content, media, and metrics.
  • Missing metrics stay null instead of being reported as zero, so the agent does not invent numbers.

CLI usage

Read an Instagram or X profile

$
anycap social profile --platform instagram --username natgeo
anycap social profile --platform x --username nasa

Fetch a post or reel by URL

$
anycap social get --url "https://www.instagram.com/reel/<shortcode>/"
anycap social get --url "https://x.com/<username>/status/<post-id>"

List an account's recent posts

$
anycap social list --platform instagram --username natgeo --type reel
anycap social list --platform x --user-id "<platform_id from profile>"

Search X posts

$
anycap social search --platform x --query 'from:nasa'

How social lookup fits an AnyCap workflow

  1. 1.

    Locate

    The agent starts from a username, a post URL, or a search query. On X, a profile lookup also returns the platform ID used to list that account's posts.

  2. 2.

    Read

    AnyCap returns the profile, post, or batch of posts as structured JSON with string IDs, ordered media URLs, metrics, the retrieval time, and the credit cost.

  3. 3.

    Act

    The agent can compare accounts, summarize topics, pass a reel's video URL to video analysis, or store a report in Drive.

When agents need social media lookup

  1. —

    Competitor and creator research

    Compare follower counts, posting cadence, and engagement across Instagram and X accounts before a campaign.

  2. —

    Topic monitoring on X

    Search a keyword or expression, then summarize what people are saying with links to the source posts.

  3. —

    Reel and video review

    Fetch a reel by URL, then pass its video URL to video analysis to describe scenes and audio.

  4. —

    Content briefs

    Pull a brand's recent posts and use their text and media as reference material for new creative.

Related pages

  • Instagram data for AI agents →

    Step-by-step profile, post, reel, and feed lookup on Instagram.

    Guide

  • X (Twitter) data for AI agents →

    Profiles, posts, account feeds, and search on X, including the user ID step.

    Guide

  • Video Analysis →

    Analyze the video returned by a reel or post lookup.

    Related capability

FAQ

Which platforms does AnyCap social media lookup support?

+

Instagram and X (Twitter). Instagram supports profile lookup, a post or reel by URL, and account post or reel feeds. X supports profile lookup, a post by status URL, an account feed by platform ID, and keyword or search-expression search.

Does it publish posts or download media?

+

No. Social media lookup only reads public profile and content data. It does not post, reply, like, follow, or store media files. Media entries are resource URLs that may expire.

How many posts does a list or search return?

+

Each call returns one upstream batch, and the batch size varies. There is no pagination cursor, requested count, or full-history traversal, so treat the result as a recent sample rather than a complete archive.

How is social lookup priced?

+

Each successful call returns its own credit_cost, converted from the provider cost with the same credit conversion as other AnyCap capabilities. Read that field instead of assuming a fixed price. Profile and list are separate billed calls.

How is this different from web search or web crawl?

+

Web search and crawl return pages and text. Social lookup returns platform-specific fields such as follower counts, post metrics, media type, and string platform IDs, so an agent can compare accounts and posts without scraping HTML.

Let your agent read the feed.

Give the agent structured Instagram and X data through the same login and CLI it already uses for the rest of its capabilities.

Equip your AgentInstagram guideX guide
CLI version and updating · 0.6.5

Current release checked October 21, 2026: 0.6.5. Use the update command for your installation method, then verify the version and login in the same environment that runs your agent.

Direct binary installation

$
anycap update

npm installation

$
npm install -g @anycap/cli@latest
$
anycap --version
anycap status

Version 0.6.5 retries transient downloads, recovers an expired video link by querying the same task, and saves multiple image outputs to numbered files. After a video download failure, resume the existing task instead of generating again.

$
anycap video tasks wait <task-id> -o result.mp4

Dated examples retain the CLI version, output and charge from the original run. Updating the CLI does not revalidate an old result. Check the live model schema and current pricing before a new billed task.

Capabilities

  • Overview
  • Image Generation
  • Video Generation
  • Music Generation
  • Image Understanding
  • Video Analysis
  • Audio Understanding
  • Web Search
  • Grounded Web Search
  • Web Crawl
  • Social Media Lookup
  • Drive

Equip Agents

  • Overview
  • Start here
  • Claude Code
  • Cursor
  • Codex
  • Manus

Resources

  • Overview
  • Context Engineering
  • Agent Skills
  • What Agents Can't Do
  • Compare agents and tools

Product

  • Product overview
  • Models
  • Install AnyCap
  • Install the Agent Skill

Documentation

  • Docs overview
  • Install AnyCap
  • MCP setup
  • CLI reference

Company

  • About
  • Contact
  • Privacy
  • Terms
anycap
Join the AnyCap Discord