// contact
联系我们
入口一
商家入驻
实体商家入驻,选择套餐并完成支付
前往 /merchant/join
入口二
个人发布
个人用户发布个人信息内容,走普通发帖流程
前往 /publish
入口三
会员服务
查看会员权益、解锁次数与相关服务
前往 /vip
入口四
API 接口
面向第三方开放的数据接口与接入文档
查看文档 ↓
入口五
联系客服
商务合作、支付问题、举报投诉可直接联系
@xunfang_help
个人与商家的区别
商家套餐与展示逻辑
白银商家
¥588/月,最多 3 张展示图。
黄金商家
¥1088/月,最多 6 张展示图,每日 1 次刷新,列表优先展示,高亮显示。
皇冠商家
¥1988/月,最多 9 张展示图,每日 3 次刷新,列表优先展示,高亮显示,商家页全省展示。
展示说明
商家统一在商家页展示,排序按套餐等级由高到低,图片展示数量与刷新次数与套餐权益相关。套餐到期后店铺置灰且联系方式隐藏,续费后自动恢复。
帖子置顶说明
帖子置顶是给个人发布的帖子使用的推广服务,不属于商家套餐。
个人发布后,如需额外曝光,可在帖子详情页申请置顶。
置顶后可获得网站列表优先展示、搜索结果优先、TG Bot 搜索优先等效果。
商家套餐与帖子置顶是两种不同服务,商家请前往 商家入驻。
USDT 支付须知
USDT 支付必须严格按照订单页面显示金额转账。
仅支持 TRC20 网络。
请按订单页面显示金额精确转账,包括小数位,金额不符系统将无法自动识别到账,需人工核实处理,影响您的到账时间。
未按订单金额付款,系统可能无法自动识别到账,需要人工核实处理。
商家套餐与帖子置顶的 USDT 订单都会生成独立金额,请以支付页显示金额为准。
如遇支付异常、长时间未到账、转错网络,请尽快联系客服并提供订单号与转账凭证。
平台规则与处理标准
红线规则
拒绝任何杀猪盘、打粉、空降炮台、引流诈骗、虚假身份、虚假交易、诱导转账等损害狼友利益行为。
一旦收到投诉、举报或核查发现异常,涉及帖子直接下架处理,不管个人商家、什么等级套餐,通道费用不退。
平台由专人逐条人工审核,请勿浑水摸鱼。批量注册后发布代聊、虚假、诈骗或钓鱼内容不会通过,投稿即封号,浪费彼此时间。
个人发布规则
个人只可以发布个人信息内容,不可冒充商家,不可借个人发布承接商家入驻业务。
商家入驻规则
商家必须有实体,不接诈骗广告,虽然赚钱,但我们不赚这个钱,只为做长期品牌。
处理结果
平台有权对违规内容执行下架、封禁、终止展示、拒绝继续合作等处理措施。
开放 API 接口
商务合作 · 数据接口
面向第三方网站 / 应用开放的标准 RESTful API,支持帖子、幽径、地区、统计、AI 搜索等数据查询。
接入信息
Base URL:https://xunfang.io/open/v1
认证方式:请求头 X-API-Key: your_key 或 Authorization: Bearer your_key
数据格式:JSON(UTF-8)
获取 Key:联系客服 @xunfang_help 购买
接口列表
| 方法 | 路径 | 说明 | 参数 |
|---|---|---|---|
| GET | /open/v1/posts | 帖子列表 | region, city, age, keyword, price_min, price_max, sort, page, per_page |
| GET | /open/v1/posts/{id} | 帖子详情 | id(路径参数)或 slug |
| GET | /open/v1/spots | 幽径列表 | region, city, keyword, price_range, status, sort, page, per_page |
| GET | /open/v1/spots/{id} | 幽径详情 | id(路径参数) |
| GET | /open/v1/regions | 地区列表 | - |
| GET | /open/v1/stats | 统计数据 | - |
| POST | /open/v1/ai-search | AI 搜索 | body: {"query": "...", "limit": 10} |
返回结构
所有接口统一返回 JSON,成功时 success: true,失败时 success: false + error 字段。
帖子列表返回示例
{
"success": true,
"total": 12680,
"page": 1,
"per_page": 20,
"total_pages": 634,
"posts": [
{
"id": 129156,
"slug": "guangdong-sz-129156",
"title": "南山区甜美学生妹",
"region": "广东",
"city": "深圳市",
"area": "南山区",
"age": "18-25岁",
"price": "500",
"publish_time": "2026-09-25 01:43:33",
"is_verified": true,
"views": 3842,
"has_image": true,
"is_top": false
}
]
}
帖子详情返回示例
{
"success": true,
"post": {
"id": 129156,
"slug": "guangdong-sz-129156",
"title": "南山区甜美学生妹",
"region": "广东",
"city": "深圳市",
"area": "南山区",
"age": "18-25岁",
"price": "500",
"content": "身高165,皮肤白...",
"services": "全套服务",
"contact": "微信:xxxx",
"publish_time": "2026-09-25 01:43:33",
"views": 3842,
"is_verified": true,
"images": [
"https://img.xunfang.io/posts/xxx.webp"
]
},
"comments": [
{
"id": 1,
"content": "确实不错",
"created_at": "2026-09-25 08:11:33",
"username": "yi***ng"
}
]
}
调用示例
import requests
API_KEY = "xf_your_api_key_here"
BASE_URL = "https://xunfang.io/open/v1"
headers = {"X-API-Key": API_KEY}
# 查询广东地区帖子
resp = requests.get(f"{BASE_URL}/posts", headers=headers, params={
"region": "广东",
"page": 1,
"per_page": 10
})
data = resp.json()
if data["success"]:
for post in data["posts"]:
print(f"{post['title']} - {post['city']} - {post['price']}")
else:
print(f"错误: {data['error']}")
# AI 搜索
resp = requests.post(f"{BASE_URL}/ai-search", headers=headers, json={
"query": "深圳300以内年轻的",
"limit": 5
})
print(resp.json())
const API_KEY = process.env.XUNFANG_API_KEY;
const BASE_URL = "https://xunfang.io/open/v1";
// 获取帖子列表
export async function getPosts(region, page = 1) {
const params = new URLSearchParams({ region, page, per_page: 20 });
const res = await fetch(`${BASE_URL}/posts?${params}`, {
headers: { "X-API-Key": API_KEY },
next: { revalidate: 60 },
});
return res.json();
}
// 获取帖子详情
export async function getPost(id) {
const res = await fetch(`${BASE_URL}/posts/${id}`, {
headers: { "X-API-Key": API_KEY },
});
return res.json();
}
// AI 搜索
export async function aiSearch(query) {
const res = await fetch(`${BASE_URL}/ai-search`, {
method: "POST",
headers: {
"X-API-Key": API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ query, limit: 10 }),
});
return res.json();
}
$apiKey = 'xf_your_api_key_here';
$baseUrl = 'https://xunfang.io/open/v1';
// 查询帖子列表
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $baseUrl . '/posts?' . http_build_query([
'region' => '广东',
'page' => 1,
'per_page' => 10,
]),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($response['success']) {
foreach ($response['posts'] as $post) {
echo $post['title'] . ' - ' . $post['price'] . PHP_EOL;
}
}
// AI 搜索
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $baseUrl . '/ai-search',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode(['query' => '深圳年轻的']),
CURLOPT_HTTPHEADER => [
'X-API-Key: ' . $apiKey,
'Content-Type: application/json',
],
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
错误码说明
| HTTP 状态码 | 含义 | 常见原因 |
|---|---|---|
| 400 | 参数错误 | 缺少必要参数、请求体非 JSON、搜索内容超长 |
| 401 | 未认证 | 缺少 API Key 或 Key 无效 / 已禁用 |
| 403 | 权限不足 | API Key 已过期 |
| 404 | 资源不存在 | 帖子 / 点位 ID 不存在或已下架 |
| 405 | 方法不允许 | 如对 GET 接口发送了 POST 请求 |
| 429 | 请求过于频繁 | 触发频率限制,请降低调用频率 |
| 500 | 服务端错误 | AI 解析失败等内部错误 |
| 503 | 服务不可用 | AI 服务暂时不可用,请稍后重试 |
错误返回格式:{"success": false, "error": "错误描述"}
接入须知
API Key 通过线下购买获取,联系客服获取报价与对接方案。
频率限制由 Cloudflare 控制,请合理控制请求频率,建议做本地缓存。
数据仅限自身业务使用,禁止二次转售或用于违法用途。
平台保留随时调整接口 / 吊销 Key 的权利。