✓ Verified 📱 Social Media ✓ Enhanced Data

V2ex

V2EX API 2.0 integration for accessing V2EX forum data, notifications, topics, nodes, and member pro

Rating
4 (255 reviews)
Downloads
31,718 downloads
Version
1.0.0

Overview

V2EX API 2.0 integration for accessing V2EX forum data, notifications, topics, nodes, and member profiles.

Complete Documentation

View Source →

Overview

This skill provides integration with V2EX API 2.0 Beta, allowing you to access V2EX forum functionality including notifications, topics, nodes, and member information.

Authentication

V2EX API 2.0 requires a Personal Access Token for authentication.

  • Visit https://www.v2ex.com/settings/tokens to create a token
  • Use the token in the Authorization header: Authorization: Bearer
  • Store your token securely (e.g., in environment variables)

API Base URL

text
https://www.v2ex.com/api/v2/

Available Endpoints

Notifications

#### Get Latest Notifications

text
GET /notifications

Optional parameters:

  • p - Page number (default: 1)
Example:
bash
curl -H "Authorization: Bearer <token>" \
  "https://www.v2ex.com/api/v2/notifications?p=1"

#### Delete a Notification

text
DELETE /notifications/:notification_id

Example:

bash
curl -X DELETE \
  -H "Authorization: Bearer <token>" \
  "https://www.v2ex.com/api/v2/notifications/123456"

Member

#### Get Your Profile

text
GET /member

Example:

bash
curl -H "Authorization: Bearer <token>" \
  "https://www.v2ex.com/api/v2/member"

Token

#### Get Current Token Info

text
GET /token

Example:

bash
curl -H "Authorization: Bearer <token>" \
  "https://www.v2ex.com/api/v2/token"

Nodes

#### Get Node Information

text
GET /nodes/:node_name

Example:

bash
curl -H "Authorization: Bearer <token>" \
  "https://www.v2ex.com/api/v2/nodes/programmer"

#### Get Topics in a Node

text
GET /nodes/:node_name/topics

Example:

bash
curl -H "Authorization: Bearer <token>" \
  "https://www.v2ex.com/api/v2/nodes/programmer/topics"

Topics

#### Get Hot Topics (Classic API)

text
GET https://www.v2ex.com/api/topics/hot.json

Returns the currently trending topics across all nodes. No authentication required.

Example:

bash
curl -s "https://www.v2ex.com/api/topics/hot.json"

#### Get Latest Topics (Classic API)

text
GET https://www.v2ex.com/api/topics/latest.json

Returns the most recent topics across all nodes. No authentication required.

Example:

bash
curl -s "https://www.v2ex.com/api/topics/latest.json"

#### Get Topic Details (API v2)

text
GET /topics/:topic_id

Example:

bash
curl -H "Authorization: Bearer <token>" \
  "https://www.v2ex.com/api/v2/topics/12345"

#### Get Topic Replies (API v2)

text
GET /topics/:topic_id/replies

Example:

bash
curl -H "Authorization: Bearer <token>" \
  "https://www.v2ex.com/api/v2/topics/12345/replies"

Rate Limiting

Default rate limit: 600 requests per hour per IP

Rate limit headers in responses:

  • X-Rate-Limit-Limit - Total allowed requests
  • X-Rate-Limit-Reset - Unix timestamp when limit resets
  • X-Rate-Limit-Remaining - Remaining requests in current window
Note: CDN-cached requests only consume rate limit on the first request.

Common Workflows

Check New Notifications

  • Call GET /notifications to fetch latest notifications
  • Parse the response for unread items
  • Optionally delete notifications after reading

Browse Hot Topics

  • Call GET /api/topics/hot.json to get trending topics (no token required)
  • Parse response to see popular discussions across all nodes
  • Use topic URLs or IDs to view details on V2EX website

Browse Node Topics

  • Call GET /nodes/:node_name/topics to get topics
  • Use topic IDs to fetch detailed information with GET /topics/:topic_id
  • Fetch replies with GET /topics/:topic_id/replies

Monitor Specific Topics

  • Store topic IDs of interest
  • Periodically poll GET /topics/:topic_id for updates
  • Check GET /topics/:topic_id/replies for new comments

Response Format

All API responses are in JSON format. Common fields include:

  • success - Boolean indicating request success
  • message - Error message if request failed
  • Data fields specific to each endpoint

Error Handling

Common HTTP status codes:

  • 200 - Success
  • 401 - Unauthorized (invalid or missing token)
  • 403 - Forbidden (insufficient permissions)
  • 404 - Not found
  • 429 - Rate limit exceeded
  • 500 - Server error

Best Practices

  • Store Personal Access Tokens securely (environment variables, not in code)
  • Handle rate limits by checking headers and implementing backoff
  • Cache responses when appropriate to reduce API calls
  • Use pagination for endpoints that support it
  • Handle errors gracefully with user-friendly messages

References

  • V2EX API Documentation: https://www.v2ex.com/help/api
  • Personal Access Tokens: https://www.v2ex.com/settings/tokens
  • V2EX API Node: https://www.v2ex.com/go/v2ex-api

Example Implementation (Python)

python
import os
import requests

class V2EXClient:
    BASE_URL = "https://www.v2ex.com/api/v2"
    
    def __init__(self, token=None):
        self.token = token or os.environ.get('V2EX_TOKEN')
        if not self.token:
            raise ValueError("V2EX token is required")
        self.headers = {
            "Authorization": f"Bearer {self.token}"
        }
    
    def get_notifications(self, page=1):
        """Get latest notifications"""
        response = requests.get(
            f"{self.BASE_URL}/notifications",
            headers=self.headers,
            params={"p": page}
        )
        response.raise_for_status()
        return response.json()
    
    def delete_notification(self, notification_id):
        """Delete a specific notification"""
        response = requests.delete(
            f"{self.BASE_URL}/notifications/{notification_id}",
            headers=self.headers
        )
        response.raise_for_status()
        return response.json()
    
    def get_member(self):
        """Get current member profile"""
        response = requests.get(
            f"{self.BASE_URL}/member",
            headers=self.headers
        )
        response.raise_for_status()
        return response.json()
    
    def get_node(self, node_name):
        """Get node information"""
        response = requests.get(
            f"{self.BASE_URL}/nodes/{node_name}",
            headers=self.headers
        )
        response.raise_for_status()
        return response.json()
    
    def get_node_topics(self, node_name):
        """Get topics in a node"""
        response = requests.get(
            f"{self.BASE_URL}/nodes/{node_name}/topics",
            headers=self.headers
        )
        response.raise_for_status()
        return response.json()
    
    def get_topic(self, topic_id):
        """Get topic details"""
        response = requests.get(
            f"{self.BASE_URL}/topics/{topic_id}",
            headers=self.headers
        )
        response.raise_for_status()
        return response.json()
    
    def get_topic_replies(self, topic_id):
        """Get replies for a topic"""
        response = requests.get(
            f"{self.BASE_URL}/topics/{topic_id}/replies",
            headers=self.headers
        )
        response.raise_for_status()
        return response.json()
    
    def get_hot_topics(self):
        """Get trending topics across all nodes (classic API, no token required)"""
        response = requests.get("https://www.v2ex.com/api/topics/hot.json")
        response.raise_for_status()
        return response.json()
    
    def get_latest_topics(self):
        """Get latest topics across all nodes (classic API, no token required)"""
        response = requests.get("https://www.v2ex.com/api/topics/latest.json")
        response.raise_for_status()
        return response.json()

# Usage example
if __name__ == "__main__":
    client = V2EXClient()
    
    # Get notifications
    notifications = client.get_notifications()
    print(f"You have {len(notifications.get('result', []))} notifications")
    
    # Get member profile
    member = client.get_member()
    print(f"Hello, {member.get('result', {}).get('username')}!")
    
    # Get node info
    node = client.get_node("python")
    print(f"Node: {node.get('result', {}).get('title')}")
    
    # Get topics from a node
    topics = client.get_node_topics("python")
    for topic in topics.get('result', []):
        print(f"- {topic.get('title')}")
    
    # Get hot topics (no token required)
    hot_topics = client.get_hot_topics()
    print("\n🔥 Hot Topics:")
    for topic in hot_topics[:5]:
        print(f"- [{topic['node']['title']}] {topic['title']} ({topic['replies']} replies)")

Testing with REST Client

You can use VS Code's REST Client extension to test the API:

http
### Get hot topics (classic API, no auth required)
GET https://www.v2ex.com/api/topics/hot.json

### Get latest topics (classic API, no auth required)
GET https://www.v2ex.com/api/topics/latest.json

### Get notifications
GET https://www.v2ex.com/api/v2/notifications
Authorization: Bearer <your-token>

### Get member profile
GET https://www.v2ex.com/api/v2/member
Authorization: Bearer <your-token>

### Get node info
GET https://www.v2ex.com/api/v2/nodes/programmer
Authorization: Bearer <your-token>

### Get topic
GET https://www.v2ex.com/api/v2/topics/12345
Authorization: Bearer <your-token>

Installation

Terminal bash 

openclaw install v2ex
Copied!

💻Code Examples

https://www.v2ex.com/api/v2/

httpswwwv2excomapiv2.txt
## Available Endpoints

### Notifications

#### Get Latest Notifications

GET /notifications

get-notifications.txt
Optional parameters:
- `p` - Page number (default: 1)

Example:

"https://www.v2ex.com/api/v2/notifications/123456"

-httpswwwv2excomapiv2notifications123456.txt
### Member

#### Get Your Profile

"https://www.v2ex.com/api/v2/member"

-httpswwwv2excomapiv2member.txt
### Token

#### Get Current Token Info

"https://www.v2ex.com/api/v2/token"

-httpswwwv2excomapiv2token.txt
### Nodes

#### Get Node Information

"https://www.v2ex.com/api/v2/nodes/programmer/topics"

-httpswwwv2excomapiv2nodesprogrammertopics.txt
### Topics

#### Get Hot Topics (Classic API)

GET https://www.v2ex.com/api/topics/hot.json

get-httpswwwv2excomapitopicshotjson.txt
Returns the currently trending topics across all nodes. **No authentication required.**

Example:

GET https://www.v2ex.com/api/topics/latest.json

get-httpswwwv2excomapitopicslatestjson.txt
Returns the most recent topics across all nodes. **No authentication required.**

Example:

"https://www.v2ex.com/api/v2/topics/12345/replies"

-httpswwwv2excomapiv2topics12345replies.txt
## Rate Limiting

Default rate limit: 600 requests per hour per IP

Rate limit headers in responses:
- `X-Rate-Limit-Limit` - Total allowed requests
- `X-Rate-Limit-Reset` - Unix timestamp when limit resets
- `X-Rate-Limit-Remaining` - Remaining requests in current window

Note: CDN-cached requests only consume rate limit on the first request.

## Common Workflows

### Check New Notifications
1. Call `GET /notifications` to fetch latest notifications
2. Parse the response for unread items
3. Optionally delete notifications after reading

### Browse Hot Topics
1. Call `GET /api/topics/hot.json` to get trending topics (no token required)
2. Parse response to see popular discussions across all nodes
3. Use topic URLs or IDs to view details on V2EX website

### Browse Node Topics
1. Call `GET /nodes/:node_name/topics` to get topics
2. Use topic IDs to fetch detailed information with `GET /topics/:topic_id`
3. Fetch replies with `GET /topics/:topic_id/replies`

### Monitor Specific Topics
1. Store topic IDs of interest
2. Periodically poll `GET /topics/:topic_id` for updates
3. Check `GET /topics/:topic_id/replies` for new comments

## Response Format

All API responses are in JSON format. Common fields include:
- `success` - Boolean indicating request success
- `message` - Error message if request failed
- Data fields specific to each endpoint

## Error Handling

Common HTTP status codes:
- `200` - Success
- `401` - Unauthorized (invalid or missing token)
- `403` - Forbidden (insufficient permissions)
- `404` - Not found
- `429` - Rate limit exceeded
- `500` - Server error

## Best Practices

1. Store Personal Access Tokens securely (environment variables, not in code)
2. Handle rate limits by checking headers and implementing backoff
3. Cache responses when appropriate to reduce API calls
4. Use pagination for endpoints that support it
5. Handle errors gracefully with user-friendly messages

## References

- V2EX API Documentation: https://www.v2ex.com/help/api
- Personal Access Tokens: https://www.v2ex.com/settings/tokens
- V2EX API Node: https://www.v2ex.com/go/v2ex-api

## Example Implementation (Python)

print(f"- [{topic['node']['title']}] {topic['title']} ({topic['replies']} replies)")

-printf--topicnodetitle-topictitle-topicreplies-replies.txt
## Testing with REST Client

You can use VS Code's REST Client extension to test the API:

Tags

#communication #api #data #integration

Quick Info

Category Social Media
Model Claude 3.5
Complexity One-Click
Author timqian
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install v2ex

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0
✓ Verified 💻 Development

Adversarial Prompting

Adversarial analysis to critique, fix.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.6 (372)
↓ 28,222
v1.0.0