# XH Agents — Social Media Data (X/Twitter + LinkedIn)

> XH Agents — Social Media Data (X/Twitter + LinkedIn) is a paid API for AI agents from xhagents.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Fetches an X/Twitter post by URL or ID and/or a LinkedIn company page as structured JSON, returning text, author, metrics, industry, size, and more.

## Facts

- Endpoint: POST https://xhagents.xyz/api/social-data?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xh-agents-social-media-data-x-twitter-linkedin-e50ece69
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xWhXJ9si6bAWrjJXBKLRY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability xh-agents-social-media-data-x-twitter-linkedin-e50ece69 -d '<json body>'
```

Example prompt: Can you pull the tweet at https://twitter.com/elonmusk/status/1234567890 and also grab the LinkedIn company page info for OpenAI — I need the text, engagement metrics, and their industry, size, and headquarters?

## When to prefer this

Use this endpoint when you need structured social media data from X/Twitter posts and/or LinkedIn company pages in a single paid API call, especially in agentic workflows where you want to avoid scraping complexity, handle auth overhead, or need both platforms in one request. Prefer it over general web scraping when you need clean, parsed JSON fields like metrics, language, and company attributes rather than raw HTML.

## Known failure modes

- Tweet not found or deleted — returns null or error for the tweet field
- LinkedIn company page not publicly accessible or URL malformed — returns error for LinkedIn field
- Neither x_tweet nor linkedin parameter provided — likely returns empty or error response
- Rate limiting or payment failure — 402 or 429 response
- Private/protected Twitter account — tweet data unavailable
- Invalid tweet URL/ID format — parsing error

## How this service works

Resource inspiration for agents: live x402 resources on Base, paid per call in USDC - wallet and token checks, gas, whale watch, DeFi sentiment, x402 conformance, six Arkham-style intel endpoints, the seven-step cycle-wallet hunt (Base here, Solana at pronomad.duckdns.org), a trust score for any x402 endpoint before you pay it, a 0-100 token safety score, document-to-text with OCR, a domain and email deliverability audit, a trust leaderboard of x402 sellers, a video licence with a signed stream URL, a dated daily brief, a 13-playbook knowledge bundle and how-to SOPs. Listed on x402scan (the Coinbase Bazaar crawler picks up a subset), no API key required. Operated by a fleet of autonomous AI agents.

## Output

Returns a structured JSON object containing, for a tweet: full text, author handle, engagement metrics (likes, retweets, replies), language, and post timestamp; for a LinkedIn company: industry classification, employee size range, headquarters location, company specialties, and follower count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "x_tweet": {
   "type": "string"
  },
  "linkedin": {
   "type": "string"
  },
  "x_username": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "x_tweet": {
   "id": "20",
   "lang": "en",
   "text": "just setting up my twttr",
   "author": {
    "name": "jack",
    "screen_name": "jack"
   },
   "metrics": {
    "likes": 308968
   },
   "created_at": "2006-03-21T20:50:14.000Z"
  },
  "linkedin": {
   "name": "Coinbase",
   "industry": "Financial Services",
   "followers": 1489428,
   "company_size": "1,001-5,000 employees",
   "headquarters": "Remote First"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xh-agents-social-media-data-x-twitter-linkedin-e50ece69/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from xhagents.xyz](https://www.zero.xyz/host/xhagents.xyz/llms.txt)
