# glim.sh Twitter User Relationship Lookup

> glim.sh Twitter User Relationship Lookup is a paid API for AI agents from surf.cascade.fyi, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Checks the follow relationship between two Twitter/X users (whether user A follows user B and/or vice versa)

## Facts

- Endpoint: POST https://surf.cascade.fyi/api/v1/twitter/users/relationship
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/glim-sh-twitter-user-relationship-lookup-0547e5d9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8lN2wMnJ6clXmUoS6LZFF

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 glim-sh-twitter-user-relationship-lookup-0547e5d9 -d '<json body>'
```

Example prompt: Can you check on Twitter whether @elonmusk follows @OpenAI, and whether @OpenAI follows him back?

## When to prefer this

Use this endpoint when you need to programmatically check follow relationships between two specific Twitter/X users without managing your own Twitter API credentials or scraping infrastructure. Ideal for social graph analysis, follower verification, influencer auditing, or any agent workflow that needs to confirm mutual follows or one-way follows on X.

## Known failure modes

- One or both usernames do not exist on Twitter — returns error or empty data
- Twitter API rate limiting — may return 429 or error
- Private/suspended accounts may return restricted relationship data
- Malformed or missing user identifiers in request body — returns 400 error
- Service unavailability — upstream Twitter API outage

## How this service works

One remote endpoint gives your agent live data from Twitter, Reddit, the open web, GitHub and more. No API keys, no scraping stack - just connect the URL and go.

## Output

Returns a JSON object with two boolean fields: 'following' (whether user A follows user B) and 'followed_by' (whether user B follows user A), indicating the directional follow relationship between the two accounts.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "source": {
       "type": "string",
       "description": "Source user ID or username"
      },
      "target": {
       "type": "string",
       "description": "Target user ID or username"
      }
     },
     "required": [
      "source",
      "target"
     ]
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "following": {
         "type": "boolean"
        },
        "followed_by": {
         "type": "boolean"
        }
       },
       "required": [
        "following",
        "followed_by"
       ]
      }
     },
     "required": [
      "data"
     ]
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "following": false,
   "followed_by": true
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/glim-sh-twitter-user-relationship-lookup-0547e5d9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from surf.cascade.fyi](https://www.zero.xyz/host/surf.cascade.fyi/llms.txt)