查询接口

提供搜索主机、获取详细信息的方法,使开发更容易。

GET

序号参数必填类型描述示例
1qbase64string经过base64编码后的查询语法,即输入的查询内容aXA9IjEwMy4zNS4xNjguMzgi
2fieldsstring可选字段,默认host,ip,port,详见附录1host,ip,port
3pageint是否翻页,默认为第一页,按照更新时间排序1
4sizeint每页查询数量,默认为100条,最大支持10,000条/页100
5fullboolean默认搜索一年内的数据,指定为true即可搜索全部数据false
6r_typestring可以指定返回json格式的数据json

附录1:查询接口支持的字段,按照示例配置 fields=ip,host,port 即可。

序号字段名描述权限
1ipip地址
2port端口
3protocol协议名
4country国家代码
5country_name国家名
6region区域
7city城市
8longitude地理位置 经度
9latitude地理位置 纬度
10asnasn编号
11orgasn组织
12host主机名
13domain域名
14os操作系统
15server网站server
16icpicp备案号
17title网站标题
18jarmjarm 指纹
19header网站header
20banner协议 banner
21cert证书
22base_protocol基础协议,比如tcp/udp
23link资产的URL链接
24cert.issuer.org证书颁发者组织
25cert.issuer.cn证书颁发者通用名称
26cert.subject.org证书持有者组织
27cert.subject.cn证书持有者通用名称
28tls.ja3sja3s指纹信息
29tls.versiontls协议版本
30cert.sn New证书的序列号
31cert.not_before证书生效时间
32cert.not_after证书到期时间
33cert.domain证书中的根域名
34status_codeHTTP 状态码
35header_hashhttp/https相应信息计算的hash值个人版及以上
36banner_hash New协议相应信息的完整hash值个人版及以上
37banner_fid New协议相应信息架构的指纹值个人版及以上
38cname域名cname专业版本及以上
39lastupdatetimeFOFA最后更新时间专业版本及以上
40product产品名专业版本及以上
41product_category产品分类专业版本及以上
42product.version Beta产品版本号商业版本及以上
43icon_hash返回的icon_hash值商业版本及以上
44cert.is_valid证书是否有效商业版本及以上
45cname_domaincname的域名商业版本及以上
46body网站正文内容商业版本及以上
47cert.is_match证书颁发者和持有者是否相同商业版本及以上
48cert.is_equal New证书和域名是否匹配商业版本及以上
49iconicon 图标企业会员
50fidfid企业会员
51structinfo结构化信息 (部分协议支持、比如elastic、mongodb)企业会员

*1: 当查询包含cert、banner ,size参数值最大为2000

*2: 当查询包含body, size参数值最大为500

FOFA API支持cURL、Python、Java、Go语言的请求,以cURL为例:

curl

`curl -X GET "https://fofa.info/api/v1/search/all?key=your_key&qbase64=dGl0bGU9ImJpbmci"`

响应示例:


{
      "error": false, // 是否出现错误
      "consumed_fpoint": 0, // 应扣F点
      "required_fpoints": 0, // 实扣F点
      "size": 244569, // 查询总数量
      "page": 1, // 当前页码
      "mode": "extended",
      "query": "title=\"bing\"", // 查询语句
      "results": [
        [
            "https://bingchillin.org",
            "172.67.213.134",
            "443"
        ],
        [
            "bingchillin.org",
            "104.21.69.223",
            "80"
        ],
        [
            "76.158.236.234:8080",
            "76.158.236.234",
            "8080"
        ],
        [
            "srkpixelsoft.com",
            "43.225.55.146",
            "80"
        ],
        [
            "https://srkpixelsoft.com",
            "43.225.55.146",
            "443"
        ],
        [
            "www.srkpixelsoft.com",
            "43.225.55.146",
            "80"
        ],
        [
            "https://www.srkpixelsoft.com",
            "43.225.55.146",
            "443"
        ],
        [
            "3.10.194.226",
            "3.10.194.226",
            "80"
        ],
        [
            "3.104.212.139",
            "3.104.212.139",
            "80"
        ]
      ]
    }