• API 功能
    • 根据提供的文章链接智能分析出文章正文中包含的图片列表;
    • 支持传递图片大小以及图片分辨率条件对返回图片列表进行筛选;
    • 接口可同时返回原始 HTML 内容,供您二次解析使用;
    • 图片解析与标签处理基于机器学习;
    • 全接口支持 HTTPS(TLS v1.0 / v1.1 / v1.2 / v1.3);
    • 全面兼容 Apple ATS;
    • 全国多节点 CDN 部署;
    • 接口极速响应,多台服务器构建 API 接口负载均衡;
    • 接口调用状态与状态监控
  • API 文档

    接口地址: https://api.gugudata.com/news/fetchcontentimages

    返回格式: application/json; charset=utf-8

    请求方式: POST

    请求协议: HTTPS

    请求示例: https://api.gugudata.com/news/fetchcontentimages

    数据预览: https://www.gugudata.com/preview/fetchcontentimages

    接口测试: https://api.gugudata.com/news/fetchcontentimages/demo

    请求参数(POST 请求参数以 application/x-www-form-urlencoded 格式、文件流以 formdata 格式传递,具体可参见下方示例代码)

    参数名 参数类型 是否必须 默认值 备注
    appkey string YOUR_APPKEY 付费后获取的 APPKEY
    url string YOUR_VALUE 需要抓取正文的文章链接
    limittype string YOUR_VALUE 对图片大小进行筛选条件类型,参数值为 size 或 ratio。size:按照图片大小 (KB) 进行筛选,ratio:按照图片分辨率 [宽,高] 进行筛选
    limitvalue float / [int,int] YOUR_VALUE 对图片大小进行筛选条件值,如果类型为 size,参数值格式为 float 类型的图片最小限制值(单位为 KB),如果类型为 ratio,参数值格式为 int 数组 [宽,高],分别限制最小宽与高(单位为像素)
    imagewithtag bool false 是否返回获取到的图片原始 img HTML 标签
    htmlsourcecontent bool false 是否返回文章页面原始 HTML 内容,供您二次解析或分析正文图片列表失败时使用,需要注意接口的性能问题

    返回参数

    参数名 参数类型 备注
    DataStatus.StatusCode int 接口返回状态码
    DataStatus.StatusDescription string 接口返回状态说明
    DataStatus.ResponseDateTime string 接口数据返回时间
    DataStatus.DataTotalCount int 符合条件的图片集合数量
    Data.Url string 文章 Url
    Data.ImagesUrl string[] 文章正文中符合筛选条件的图片 Url 集合
    Data.ImagesTag string[] 当传递 imagewithtag 参数值为 true 时,返回获取到的图片原始 img HTML 标签
    Data.HTMLSourceContent string 文章的原始 HTML 内容(HTML 标签为 Unicode 编码)
  • 接口 HTTP 响应标准状态码
    状态码 状态码解释 备注
    200 接口正常响应 业务状态码参见下方 接口自定义状态码
    403 / 429 请求频率超限 CDN 层通过 IP 请求频率智能判断,一般不同 IP 高频请求不会触发此状态码。
  • 接口自定义状态码
    自定义状态码 自定义状态码解释 备注
    100 正常返回 可通过判断此状态码断言接口正常返回。
    -1 请求失败 请求处理请求失败。
    501 参数错误 请检查您传递的参数个数以及参数类型是否匹配。
    429 / 502 请求频率受限 一般建议同一个 IP 每秒请求不超过 5 次 (QPS<=5),我们不限制同一个 key 的请求总次数,但当单位时间内同一个 IP 请求次数过多,或 AI CDN 判定为恶意抓取数据、流量攻击等异常时,CDN 会返回此状态码,请适当降低请求频率。如有特殊大并发请求场景需求,可联系我们添加白名单处理。
    503 APPKEY 权限超限/订单到期 请至开发者中心检查您的 APPKEY 是否到期或是否权限超限。
    504 APPKEY 错误 请检查传递的 APPKEY 是否为开发者中心获取到的值。
    505 请求的次数超出接口限制 请检查对应接口是否有请求次数限制以及您目前的接口请求剩余次数。
    900 接口内部响应错误 接口可用性为 99.999%,如获取到此状态码请邮件联系我们。
  • 请求示例代码
    curl --location --request POST 'https://api.gugudata.com/news/fetchcontentimages' \
    --header 'Content-Type: application/x-www-form-urlencoded' \
    --data-urlencode 'appkey=YOUR_APPKEY' \
    --data-urlencode 'url=YOUR_VALUE' \
    --data-urlencode 'limittype=YOUR_VALUE' \
    --data-urlencode 'limitvalue=YOUR_VALUE' \
    --data-urlencode 'imagewithtag=false' \
    --data-urlencode 'htmlsourcecontent=false'
    CURL *curl;
    CURLcode res;
    curl = curl_easy_init();
    if(curl) {
      curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
      curl_easy_setopt(curl, CURLOPT_URL, "https://api.gugudata.com/news/fetchcontentimages");
      curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
      curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
      struct curl_slist *headers = NULL;
      headers = curl_slist_append(headers, "Content-Type: application/x-www-form-urlencoded");
      curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
      const char *data = "appkey=YOUR_APPKEY&url=YOUR_VALUE&limittype=YOUR_VALUE&limitvalue=YOUR_VALUE&imagewithtag=false&htmlsourcecontent=false";
      curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data);
      res = curl_easy_perform(curl);
    }
    curl_easy_cleanup(curl);
    var myHeaders = new Headers();
    myHeaders.append("Content-Type", "application/x-www-form-urlencoded");
    var urlencoded = new URLSearchParams();
    urlencoded.append("appkey", "YOUR_APPKEY");
    urlencoded.append("url", "YOUR_VALUE");
    urlencoded.append("limittype", "YOUR_VALUE");
    urlencoded.append("limitvalue", "YOUR_VALUE");
    urlencoded.append("imagewithtag", "false");
    urlencoded.append("htmlsourcecontent", "false");
    var requestOptions = {
      method: 'POST',
      headers: myHeaders,
      body: urlencoded,
      redirect: 'follow'
    };
    fetch("https://api.gugudata.com/news/fetchcontentimages", requestOptions)
      .then(response => response.text())
      .then(result => console.log(result))
      .catch(error => console.log('error', error));
    var client = new RestClient("https://api.gugudata.com/news/fetchcontentimages");
    client.Timeout = -1;
    var request = new RestRequest(Method.POST);
    request.AddHeader("Content-Type", "application/x-www-form-urlencoded");
    request.AddParameter("appkey", "YOUR_APPKEY");
    request.AddParameter("url", "YOUR_VALUE");
    request.AddParameter("limittype", "YOUR_VALUE");
    request.AddParameter("limitvalue", "YOUR_VALUE");
    request.AddParameter("imagewithtag", "false");
    request.AddParameter("htmlsourcecontent", "false");
    IRestResponse response = client.Execute(request);
    Console.WriteLine(response.Content);
    package main
    import (
      "fmt"
      "strings"
      "net/http"
      "io/ioutil"
    )
    func main() {
      url := "https://api.gugudata.com/news/fetchcontentimages"
      method := "POST"
      payload := strings.NewReader("appkey=YOUR_APPKEY&url=YOUR_VALUE&limittype=YOUR_VALUE&limitvalue=YOUR_VALUE&imagewithtag=false&htmlsourcecontent=false")
      client := &http.Client {
      }
      req, err := http.NewRequest(method, url, payload)
      if err != nil {
        fmt.Println(err)
      }
      req.Header.Add("Content-Type", "application/x-www-form-urlencoded")
      res, err := client.Do(req)
      defer res.Body.Close()
      body, err := ioutil.ReadAll(res.Body)
      fmt.Println(string(body))
    }
    OkHttpClient client = new OkHttpClient().newBuilder()
      .build();
    MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
    RequestBody body = RequestBody.create(mediaType, "appkey=YOUR_APPKEY&url=YOUR_VALUE&limittype=YOUR_VALUE&limitvalue=YOUR_VALUE&imagewithtag=false&htmlsourcecontent=false");
    Request request = new Request.Builder()
      .url("https://api.gugudata.com/news/fetchcontentimages")
      .method("POST", body)
      .addHeader("Content-Type", "application/x-www-form-urlencoded")
      .build();
    Response response = client.newCall(request).execute();
    var settings = {
      "url": "https://api.gugudata.com/news/fetchcontentimages",
      "method": "POST",
      "timeout": 0,
      "headers": {
        "Content-Type": "application/x-www-form-urlencoded"
      },
      "data": {
                "appkey":'YOUR_APPKEY', 
                "url":'YOUR_VALUE', 
                "limittype":'YOUR_VALUE', 
                "limitvalue":YOUR_VALUE, 
                "imagewithtag":false, 
                "htmlsourcecontent":false
      }
    };
    $.ajax(settings).done(function (response) {
      console.log(response);
    });
    #import <Foundation/Foundation.h>
    dispatch_semaphore_t sema = dispatch_semaphore_create(0);
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.gugudata.com/news/fetchcontentimages"]
      cachePolicy:NSURLRequestUseProtocolCachePolicy
      timeoutInterval:10.0];
    NSDictionary *headers = @{
      @"Content-Type": @"application/x-www-form-urlencoded"
    };
    [request setAllHTTPHeaderFields:headers];
    NSMutableData *postData =
    [[NSMutableData alloc] initWithData:[@"appkey=YOUR_APPKEY" dataUsingEncoding:NSUTF8StringEncoding]];[postData appendData:[@"&url=YOUR_VALUE" dataUsingEncoding:NSUTF8StringEncoding]];[postData appendData:[@"&limittype=YOUR_VALUE" dataUsingEncoding:NSUTF8StringEncoding]];[postData appendData:[@"&limitvalue=YOUR_VALUE" dataUsingEncoding:NSUTF8StringEncoding]];[postData appendData:[@"&imagewithtag=false" dataUsingEncoding:NSUTF8StringEncoding]];[postData appendData:[@"&htmlsourcecontent=false" dataUsingEncoding:NSUTF8StringEncoding]];
    [request setHTTPBody:postData];
    [request setHTTPMethod:@"POST"];
    NSURLSession *session = [NSURLSession sharedSession];
    NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
      if (error) {
        NSLog(@"%@", error);
      } else {
        NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
        NSError *parseError = nil;
        NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];
        NSLog(@"%@",responseDictionary);
        dispatch_semaphore_signal(sema);
      }
    }];
    [dataTask resume];
    dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
    import requests
    url = "https://api.gugudata.com/news/fetchcontentimages"
    payload = 'appkey=YOUR_APPKEY&url=YOUR_VALUE&limittype=YOUR_VALUE&limitvalue=YOUR_VALUE&imagewithtag=false&htmlsourcecontent=false'
    headers = {
      'Content-Type': 'application/x-www-form-urlencoded'
    }
    response = requests.request("POST", url, headers=headers, data = payload)
    print(response.text)
    require "uri"
    require "net/http"
    url = URI("https://api.gugudata.com/news/fetchcontentimages")
    https = Net::HTTP.new(url.host, url.port);
    https.use_ssl = true
    request = Net::HTTP::Post.new(url)
    request["Content-Type"] = "application/x-www-form-urlencoded"
    request.body = "appkey=YOUR_APPKEY&url=YOUR_VALUE&limittype=YOUR_VALUE&limitvalue=YOUR_VALUE&imagewithtag=false&htmlsourcecontent=false"
    response = https.request(request)
    puts response.read_body
    import Foundation
    var semaphore = DispatchSemaphore (value: 0)
    let parameters = "appkey=YOUR_APPKEY&url=YOUR_VALUE&limittype=YOUR_VALUE&limitvalue=YOUR_VALUE&imagewithtag=false&htmlsourcecontent=false"
    let postData =  parameters.data(using: .utf8)
    var request = URLRequest(url: URL(string: "https://api.gugudata.com/news/fetchcontentimages")!,timeoutInterval: Double.infinity)
    request.addValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")
    request.httpMethod = "POST"
    request.httpBody = postData
    let task = URLSession.shared.dataTask(with: request) { data, response, error in
      guard let data = data else {
        print(String(describing: error))
        return
      }
      print(String(data: data, encoding: .utf8)!)
      semaphore.signal()
    }
    task.resume()
    semaphore.wait()
    /*
     * GuGuData API Request Node.js Demo
     * 咕咕数据 API Node.js 请求 DEMO
     * 咕咕数据,专业的数据提供商,提供全面的数据接口 API,并提供专业全面的数据接口、商业数据分析。
     * 让数据成为您的生产原料。
     * https://www.gugudata.com
     */
    
    /* 咕咕数据 API 请求 DEMO ***开始***/
    // 导入相关类库
    var request = require("request");
    var api_host = "https://api.gugudata.com";
    var api_path = "/news/fetchcontentimages"; // todo: 注意修改请求对应的 API 接口
    // todo: 注意修改构造请求参数
    var data = {
     appkey:'YOUR_APPKEY', url:'YOUR_VALUE', limittype:'YOUR_VALUE', limitvalue:YOUR_VALUE, imagewithtag:false, htmlsourcecontent:false
    };
    var options = {
        'method': "POST",
        'url': api_host + api_path,
        'headers': {
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        form: data
    };
    // 发送网络请求
    var requestGuGuData = request(options, (error, response) => {
        if (error) throw new Error(error);
        console.log("********接口响应返回 JSON 数据********");
        console.log(JSON.parse(response.body));
        requestGuGuData.end();
        console.log("********接口响应结束********");
    });
    /* 咕咕数据 API 请求 DEMO ***结束***/
    <?php
    $curl = curl_init();
    curl_setopt_array($curl, array(
      CURLOPT_URL => "https://api.gugudata.com/news/fetchcontentimages",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_ENCODING => "",
      CURLOPT_MAXREDIRS => 10,
      CURLOPT_TIMEOUT => 0,
      CURLOPT_FOLLOWLOCATION => true,
      CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
      CURLOPT_CUSTOMREQUEST => "POST",
      CURLOPT_POSTFIELDS => "appkey=YOUR_APPKEY&url=YOUR_VALUE&limittype=YOUR_VALUE&limitvalue=YOUR_VALUE&imagewithtag=false&htmlsourcecontent=false",
      CURLOPT_HTTPHEADER => array(
        "Content-Type: application/x-www-form-urlencoded"
      ),
    ));
    $response = curl_exec($curl);
    curl_close($curl);
    echo $response;
  • 常见问题 Q&A
    • Q: 数据请求有缓存吗?

      A: 我们为所有数据请求提供实时响应。对于定期更新的数据,我们在其更新周期内实施缓存策略,以优化性能。

    • Q: 如何保证请求时 key 的安全性?

      A: 我们建议将对 API 的请求操作放置在您的应用程序后端。这样,前端请求只与您的后端服务交互,确保了更高的安全性和易于维护的架构。

    • Q: 接口可以用于哪些开发语言?

      A: 我们的接口支持所有能进行网络请求的开发语言,便于在各类项目中快速整合数据。

    • Q: 接口的性能可以保证吗?

      A: 我们的接口后台使用与商业级项目相同的架构,保证了稳定且高效的性能。您可以通过访问测试接口了解更多性能信息。

  • 服务协议以及服务免责声明

    用户应当充分阅读 服务协议 以及 服务免责声明 ,用户购买与使用咕咕数据 API 服务亦视为接受本协议。

  • 技术支持
    • 技术支持邮箱: support@gugudata.com
    • 微信客服: 客服链接

业务相关接口推荐

稳定提供服务 10 年 网页可读内容抽取
  • 智能提取文章关键元素信息
  • 智能抽取 / 多种元素信息
  • 999元/年限时折扣 499元/年
查看详情 被调用于 8 秒前
50% 折扣
获取公众号文章封面
  • 解析任意公共号文章链接
  • 解析任意文章 / 返回官方地址
  • 399元/年限时折扣 199元/年
查看详情 被调用于 6 秒前
50% 折扣
稳定提供服务 10 年 获取任意链接文章正文
  • 智能分析抓取链接中的正文部分
  • 智能分析正文 / 包含 HTML 标签
  • 1999元/年限时折扣 999元/年
查看详情 被调用于 8 秒前
50% 折扣
幽默笑话大全
  • 提供全网最全的幽默笑话数据
  • 支持按类别获取 / 聚合数据
  • 999元/年限时折扣 299元/年
查看详情 数据更新于 10 小时前
30% 折扣