Facebook 接口

Facebook 接口

wpchell 226 2024-01-09

接口说明

  • 请确保所有请求均携带有效的token参数(各平台唯一)。

  • 接口统一返回JSON格式数据,重点关注message字段:值为"请求成功"表示成功;其他值请根据其提示排查错误。

  • 当响应中cost=true时,表示请求已生效并计费,即使遇到错误(如资源失效404),也请勿重复尝试。

  • 对于Facebook接口,由于其响应时间较长,强烈建议设置超时(timeout)不少于30秒,以避免因超时误判导致重复请求扣费。​

测试token

token: 请联系管理员开通 q:1098441010 vx:pchell11

余额查询

请求示例
http://43.134.116.51:10002/facebook/get_user_balance/?token=
参数

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

响应
{
    "cost": false,
    "data": {
        "count": 9999.0
    },
    "message": "请求成功"
}
其他说明

贴文搜索

请求示例
http://43.134.116.51:10002/facebook/search_post/?token=&keyword=&start_day=&end_day=&cursor=&filter_type=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

keyword

搜索关键词

-

start_day

开始日期

yyyy-MM-dd 例子:2021-12-12

end_day

结束日期

yyyy-MM-dd 例子:2021-12-12

cursor

翻页参数

从上一页获取

空,默认返回第一页数据

filter_type

排序方式

all:默认排序 recent_posts:按发布时间排序

all

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明

start_day跟end_day参数必须同时加,否则不会生效

用户搜索

请求示例
http://43.134.116.51:10002/facebook/search_user/?token=&keyword=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

keyword

搜索关键词

-

cursor

翻页参数

从上一页获取

空,默认返回第一页数据

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明

公共主页搜索

请求示例
http://43.134.116.51:10002/facebook/search_page/?token=&keyword=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

keyword

搜索关键词

-

cursor

翻页参数

从上一页获取

空,默认返回第一页数据

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明

用户信息

请求示例
http://43.134.116.51:10002/facebook/user_info/?token=&url=&is_about=
参数

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

url

用户主页url

-

is_about

是否从简介页面获取用户信息

0:否 1:是

1

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明

如果是使用国内服务器调用API接口建议使用post请求,用户主页url由于带facebook.com的域名在国内访问可能会被运营商直接拦截,curl请求示例如下:

curl --location 'http://43.134.116.51:10002/facebook/user_info/?token=***&is_about=***' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'url=***'

用户信息(新)

请求示例
http://43.134.116.51:10002/facebook/user_info_new/?token=&entity=
参数

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

entity

用户主页url/用户id/用户名

-

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明

该接口目前已经测试过上百万次均未发现异常,但是我们认为还不够,所以除非user_info发生异常的情况下,不然不建议使用

如果entity传参是用用户主页url的方式,并且使用国内服务器调用API接口建议使用post请求,用户主页url由于带facebook.com的域名在国内访问可能会被运营商直接拦截,curl请求示例如下:

curl --location 'http://43.134.116.51:10002/facebook/user_info_new/?token=***' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'entity=***'

话题信息

请求示例
http://43.134.116.51:10002/facebook/tag_info/?token=&tag_name=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

tag_name

话题名称

不需要带 #

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明

群组信息

请求示例
http://43.134.116.51:10002/facebook/group_info/?token=&group_name=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

group_name

群组名称/群组id

https://www.facebook.com/groups/112810009371885

取:112810009371885

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明

群组贴文列表

请求示例
http://43.134.116.51:10002/facebook/user_post_group/?token=&group_id=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

group_id

群组id

群组信息接口返回

cursor

翻页参数

取前一页返回

空,默认返回第一页

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明

按照发布时间排序

用户贴文列表

请求示例
http://43.134.116.51:10002/facebook/user_post/?token=&fbid=&before_time=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

fbid

用户id

用户信息接口返回

before_time

此时间戳之前的贴文

10位时间戳 例:1596470400

当前时间

cursor

翻页参数

取前一页返回

空,默认返回第一页

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明

按照发布时间排序

粉丝专页贴文列表

请求示例
http://43.134.116.51:10002/facebook/user_post_fans/?token=&fbid=&before_time=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

fbid

用户id

用户信息接口返回

before_time

此时间戳之前的贴文

10位时间戳 例:1596470400

当前时间

cursor

翻页参数

取前一页返回

空,默认返回第一页

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明

按照发布时间排序

用户reel列表

请求示例
http://43.134.116.51:10002/facebook/user_reel/?token=&fbid=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

fbid

用户id

用户信息接口返回

cursor

翻页参数

取前一页返回

空,默认返回第一页

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明

按照发布时间排序

贴文详情

请求示例
http://43.134.116.51:10002/facebook/post_detail/?token=&url=
参数

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

url

贴文链接

-

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明

如果是使用国内服务器调用API接口建议使用post请求,贴文url由于带facebook.com的域名在国内访问可能会被运营商直接拦截,curl请求示例如下:

curl --location 'http://43.134.116.51:10002/facebook/post_detail/?token=***' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'url=***'

评论

请求示例
http://43.134.116.51:10002/facebook/comment/?token=&post_id=&cursor=&expansionToken=&sort_type=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

post_id

贴文id/评论id

用户贴文接口/评论接口 返回

expansionToken

-

获取二级评论时必须传入

cursor

翻页参数

取前一页返回

空,默认返回第一页

sort_type

排序方式

all:默认 top:最相关 latest:最新

all

响应
{
     "cost": true,
     "data": {
          ... # facebook数据
     },
     "message": "请求成功"
}
其他说明