DEV Community: GuGuData

英文单词中文释义查询 API 接口

GuGuData — Mon, 09 Mar 2026 07:51:46 +0000

英文单词中文释义查询 API 接口

文本/NLP 英文单词释义与扩展讲解英文词汇解析 / 分页模糊检索文本 / 英文字典

1. 产品功能

覆盖 8000+ 常见英文词条；
支持单词与释义内容双字段模糊检索；
按英文单词去重后分页返回，结果更稳定；
提供例句、词根词缀、记忆方法等扩展信息；
接口默认 HTTPS，兼容 Apple ATS，配合多节点 CDN 提供高可用服务。
全国多节点 CDN 部署；
接口极速响应，多台服务器构建 API 接口负载均衡。
接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/english-words-chinese

接口地址: https://api.gugudata.com/text/english-words-chinese

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

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/text/english-words-chinese?appkey=YOUR_APPKEY&keywords=computer&pageSize=10&pageNumber=1

数据预览: https://www.gugudata.com/preview/english-words-chinese

接口测试: https://api.gugudata.com/text/english-words-chinese/demo

3. 请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	YOUR_APPKEY	付费后获取的 APPKEY
keywords	string	是	computer	关键词，支持对单词和释义内容模糊检索
pagesize	int	否	10	每页条数，取值范围 1~20
pagenumber	int	否	1	页码，从 1 开始

4. 返回参数

参数名	参数类型	备注
DataStatus.StatusCode	int	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	int	去重后的总数据量，一般用于分页计算
DataStatus.RequestParameter	string	请求参数，一般用于调试
Data.Word	string	匹配到的英文单词
Data.Content	string	单词对应的中文释义与扩展讲解内容

How to Extract Readable Content from Webpages with an API

GuGuData — Tue, 27 Jan 2026 07:34:48 +0000

How to Extract Readable Content from Webpages with an API

1. What problem are we solving

Extracting readable content from a webpage is challenging because raw HTML includes ads, navigation bars, comments and other extraneous elements.

Developers often need just the main text of an article for tasks like summarization, analysis or offline storage.

Parsing this content manually is error‑prone and time‑consuming, especially when dealing with many different website structures.

This guide shows how to reliably extract clean, readable content using an API.

2. When you need this solution

Building a reading mode for your application
Creating a content summarization pipeline
Performing natural language processing on article text
Saving readable text for offline access ## 3. How the API solution works Rather than scraping and parsing HTML yourself, a readability API automatically identifies the main content within a webpage. It strips away navigation menus, advertisements and other unrelated elements to return the core article. The API delivers structured metadata such as title, author, language and publication time alongside the clean text. By relying on the API, you can handle different website layouts consistently without constant maintenance. ## 4. Step‑by‑step: Extract readable content using an API Step 1: Provide the webpage URL or HTML you want to extract content from Step 2: Send nd the URL or HTML Step 3: Receive a JSON response containing the article’s metadata and clean text Step 4: Use the extracted content in your application ## 5. API request example Endpoint POST https://api.gugudata.io/v1/websitetools/readability Headers
Content‑Type: application/json
Authorization: Bearer YOUR_APPKEY Body

{  
  "url": "https://example.com/article"  
}

cURL

curl -X POST "https://api.gugudata.io/v1/websitetools/readability" \  
  -H "Content-Type: application/json" \  
  -H "Authorization: Bearer YOUR_APPKEY" \  
  -d '{"url": "https://example.com/article"}'

JavaScript

const fetch = require('node-fetch');  
async function extractReadable() {  
  const response = await fetch('https://api.gugudata.io/v1/websitetools/readability', {  
    method: 'POST',  
    headers: {  
      'Content-Type': 'application/json',  
      'Authorization': 'Bearer YOUR_APPKEY'  
    },  
    body: JSON.stringify({ url: 'https://example.com/article' })  
  });  
  const result = await response.json();  
  console.log(result.data.TextContent);  
}  
extractReadable();

Python

import requests  
def extract_readable():  
    url = 'https://api.gugudata.io/v1/websitetools/readability'  
    headers = {  
        'Content-Type': 'application/json',  
        'Authorization': 'Bearer YOUR_APPKEY'  
    }  
    payload = {  
        'url': 'https://example.com/article'  
    }  
    response = requests.post(url, json=payload, headers=headers)  
    data = response.json()  
    print(data['data']['TextContent'])  
extract_readable()

Example response

{  
  "dataStatus": {  
    "statusCode": 200,  
    "statusDescription": "OK"  
  },  
  "data": {  
    "Title": "Example Article Title",  
    "Byline": "Author Name",  
    "Lang": "en",  
    "Content": "<p>This is the clean HTML of the article...</p>",  
    "TextContent": "This is the clean text of the article...",  
    "Length": 1234,  
    "Excerpt": "This is a short excerpt...",  
    "SiteName": "Example Site",  
    "PublishedTime": "2025-12-01T12:34:56Z"  
  }  
}

6. Why use an API instead of manual scraping

Manually scraping and parsing webpages requires custom logic for every site and ongoing maintenance when layouts change.

An API‑based solution hides this complexity and reliably returns the main content along with useful metadata.

Using the API saves development time and reduces the risk of breaking when websites update their design.

7. Frequently Asked Questions

Can this API extract readable content from dynamic or JavaScript‑rendered pages?

Most static pages are supported, but pages that require JavaScript to render content may not return full results.

Is the extracted content accurate?

The API uses advanced algorithms to identify the main article body and remove noise, providing accurate results in most cases.

Does the API support non‑English websites?

Yes, the readability API can extract content from pages in various languages and will return the language code in the response.

Do I need to send both the HTML and the URL?

No, you can provide either the full HTML of the page or the URL to fetch; the API will process whichever is provided.

8. Next steps

If you want to extract readable content from webpages without writing your own parser, you can try a readability API and integrate it into your workflow in just a few minutes. a POST request to the readability API with your app key a

How to Convert HTML or Webpages to PDF with an API

GuGuData — Tue, 27 Jan 2026 07:27:32 +0000

How to Convert HTML or Webpages to PDF with an API

1. What problem are we solving

Saving a webpage as a PDF is harder than simply printing to paper.

Web pages contain dynamic content, CSS styling and scripts that don't always render correctly when captured manually.

Developers often need a programmatic way to turn HTML or entire URLs into shareable, high-quality PDF documents.

In this guide, you'll learn how to solve this problem using an API.

2. When you need this solution

You may need to convert web content to PDF when:

Generating printable reports from web dashboards
Archiving webpages for compliance or record keeping
Creating PDFs from user-generated HTML forms or invoices
Embedding PDF exports into applications without building your own rendering engine

3. How the API solution works

A HTML-to-PDF API handles the rendering pipeline for you.

You pass either raw HTML or a URL, specify whether the output should be portrait or landscape, and the API converts the page to a PDF using a headless browser.

The service returns a link to the generated PDF along with status metadata.

This abstraction ensures consistent formatting across different pages and eliminates the need to maintain custom PDF generation code.

4. Step-by-step: Convert web content to PDF using an API

Step 1: Decide whether you will convert HTML content or a URL and prepare the content parameter accordingly

Step 2: Send a POST request to the HTML/URL to PDF API endpoint with your appkey, type, content and optional landscape flag

Step 3: Receive a JSON response containing a status object and a permanent link to the generated PDF

Step 4: Download or embed the PDF link into your application

5. API request example

cURL

curl -X POST "https://api.gugudata.io/v1/imagerecognition/html2pdf" \
  -d "appkey=YOUR_APPKEY&type=URL&content=https://example.com&landscape=0"

Example response:

{
  "DataStatus": {
    "StatusCode": 100,
    "StatusDescription": "请求成功。",
    "ResponseDateTime": "2026-01-27T12:00:00Z",
    "DataTotalCount": 1
  },
  "Data": "https://cdn.gugudata.io/pdf/abcd1234.pdf"
}

JavaScript (fetch)

const formData = new URLSearchParams();
formData.append('appkey', 'YOUR_APPKEY');
formData.append('type', 'HTML');
formData.append('content', '<html><body><h1>Hello PDF</h1></body></html>');
formData.append('landscape', '0');

fetch('https://api.gugudata.io/v1/imagerecognition/html2pdf', {
  method: 'POST',
  body: formData
})
  .then(response => response.json())
  .then(data => {
    console.log(data.Data); // URL to the generated PDF
  })
  .catch(error => console.error(error));

Python (requests)

import requests

url = "https://api.gugudata.io/v1/imagerecognition/html2pdf"
payload = {
    "appkey": "YOUR_APPKEY",
    "type": "URL",
    "content": "https://example.com",
    "landscape": "0"
}

response = requests.post(url, data=payload)
data = response.json()
print(data["Data"])

6. Why use an API instead of manual conversion

Manual PDF conversion requires complex rendering engines and constant tuning to handle varied web layouts.

An API abstracts these details and provides reliable results without requiring you to run headless browsers yourself.

This saves development time and ensures consistent PDF output across different types of web content.

7. Frequently Asked Questions

Can this API convert both raw HTML and live web pages?

Yes. Use the type parameter to specify HTML for raw content or URL for a live webpage, and set the content accordingly.

Does the API preserve CSS styles and images?

The service renders the page using a headless browser, so CSS and images that load normally will be reflected in the PDF.

Is the generated PDF link permanent?

The API response includes a permanent link where the generated PDF is stored, allowing you to download or share it later.

Can I control orientation?

You can set landscape to 1 for landscape orientation or leave it at 0 for portrait.

8. Next steps

If you need to generate PDFs from HTML or URLs without building your own rendering infrastructure, try this HTML/URL to PDF API.

With a single POST request you can convert web content into a shareable PDF and integrate it into your workflow quickly.

How to Convert Geographic Coordinates Between WGS84, GCJ02 and BD09 with an API

GuGuData — Tue, 27 Jan 2026 07:25:11 +0000

How to Convert Geographic Coordinates Between WGS84, GCJ02 and BD09 with an API

1. What problem are we solving

Converting geographic coordinates between different reference systems can be error-prone and time-consuming.
Each system (WGS84, GCJ02 or BD09) uses its own datum, and direct arithmetic often yields inaccurate locations.
Developers who build mapping, navigation or location-based services need a reliable way to translate coordinates without having to maintain complex geodesy code.
This guide shows how to perform high-precision conversions using an API so you can focus on building features instead of handling math.

2. When you need this solution

You may need to convert coordinates when:

Integrating GPS data into Chinese map services that expect GCJ02 or BD09
Standardizing data from multiple providers into a single coordinate system
Building a mobile app that uses WGS84 for device location but displays markers on a GCJ02-based map
Migrating datasets between systems for analysis or storage

3. How the API solution works

Instead of implementing transformation formulas yourself, a coordinate conversion API handles the heavy lifting.
You specify the source coordinate system, the target system and the point to convert, and the API uses high-precision algorithms to compute the new coordinates.
The service returns a JSON object containing the original and converted values, along with status information.
Because the API abstracts the conversion logic, it works consistently across WGS84, GCJ02 and BD09 and is easy to integrate into any language.

4. Step-by-step: Convert coordinates using an API

Step 1: Determine the source and target coordinate systems and collect the [longitude,latitude] value you want to convert

Step 2: Send a GET request to the coordinate conversion API endpoint with appkey, from, to and value parameters

Step 3: Parse the JSON response to retrieve the converted coordinate

Step 4: Use the converted coordinate in your map, database or location-based service

5. API request example

cURL

curl -X GET "https://api.gugudata.io/v1/location/coordinateconverter?appkey=YOUR_APPKEY&from=WGS84&to=GCJ02&value=120.54,32.74"

Example response:

{
  "dataStatus": {
    "requestParameter": "appkey=YOUR_APPKEY&from=WGS84&to=GCJ02&value=120.54,32.74",
    "statusCode": 100,
    "statusDescription": "请求成功。",
    "responseDateTime": "2026-01-27T12:00:00Z",
    "dataTotalCount": 1
  },
  "data": {
    "coordinateFrom": "WGS84",
    "coordinateTo": "GCJ02",
    "coordinateSourceValue": "[120.54,32.74]",
    "coordinateDestinationValue": "[120.546789,32.741234]"
  }
}

JavaScript (fetch)

fetch('https://api.gugudata.io/v1/location/coordinateconverter?appkey=YOUR_APPKEY&from=WGS84&to=GCJ02&value=120.54,32.74')
  .then(response => response.json())
  .then(data => {
    const converted = data.data.coordinateDestinationValue;
    console.log(converted);
  })
  .catch(error => {
    console.error(error);
  });

Python (requests)

import requests

url = "https://api.gugudata.io/v1/location/coordinateconverter"
params = {
    "appkey": "YOUR_APPKEY",
    "from": "WGS84",
    "to": "BD09",
    "value": "120.54,32.74"
}

response = requests.get(url, params=params)
data = response.json()
print(data["data"]["coordinateDestinationValue"])

6. Why use an API instead of manual conversion

Manual coordinate conversion requires knowledge of geodesy and constant updates to handle different regional datums.
An API abstracts this complexity and provides consistent, tested results without requiring you to maintain conversion logic.
Using a service also reduces development time and prevents errors that could misplace users on a map.

7. Frequently Asked Questions

Can this API convert between WGS84, GCJ02 and BD09?

Yes. You can specify any of these systems in the from and to parameters, and the API will return the corresponding converted coordinate.

How accurate is the converted coordinate?

The API uses high-precision algorithms to minimize error and is suitable for map applications, GPS navigation and location-based services. The precision is typically within a few meters.

What happens if I exceed the rate limit?

The service recommends limiting requests to 5 queries per second per IP. Exceeding this may trigger rate limiting with an error code indicating too many requests.

Do I need a secure connection?

The API supports HTTPS with TLS v1.0, v1.1, v1.2 and v1.3, and is fully compatible with Apple ATS, so you can safely call it from web and mobile apps.

8. Next steps

If you want to convert geographic coordinates without implementing complex formulas yourself, try a coordinate conversion API.
With a valid appkey you can integrate this service into your workflow in minutes and start translating coordinates between WGS84, GCJ02 and BD09.

Extract Clean Article Content with Gugudata Article Extraction API

GuGuData — Sat, 17 Jan 2026 11:50:49 +0000

Extract Clean Article Content with Gugudata Article Extraction API

In today’s digital world, extracting meaningful content from cluttered web pages is a critical challenge for developers, content aggregators, and data analysts. The Gugudata Article Extraction API is a powerful solution designed to extract clean article content from any webpage URL — automatically removing ads, navigation bars, and unrelated elements to provide structured, readable content.

🚀 Key Features at a Glance

Gugudata’s Article Extraction API uses intelligent parsing algorithms to accurately identify and extract the main content from a given webpage. Key features include:

Extract clean article content from any URL
Automatically remove ads, headers, navigation, footers, and unrelated elements
Retrieve article title, author, publication date, content, and metadata
HTML string content extraction supported via a separate endpoint (/v1/article/extractFromHtml)
Structured JSON output for easy integration and processing
Full HTTPS support (TLS v1.0 to v1.3)
Fully Apple ATS-compatible
CDN-backed with multi-node deployment across regions for ultra-fast response
Load-balanced infrastructure for high availability

📌 API Endpoint Details

HTTP Endpoint

POST https://api.gugudata.io/v1/article/extract

Supports secure HTTPS protocol.

Request Parameters

Name	Type	Required	Description
`appkey`	string	✅ Yes	Your API key from the developer center
`url`	string	✅ Yes	Webpage URL to extract article content from

Submit parameters in application/x-www-form-urlencoded format.

📤 Example cURL Request

curl --location 'https://api.gugudata.io/v1/article/extract' \
--request POST \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'appkey=YOUR_APPKEY' \
--data-urlencode 'url=https://example.com/article-url'

Replace YOUR_APPKEY and the url with your own values to start extracting.

📦 API Response Structure

A successful API call returns a JSON object with structured data:

Field	Type	Description
`DataStatus.StatusCode`	int	API response status code
`DataStatus.StatusDescription`	string	Human-readable status message
`Data.url`	string	Source URL
`Data.title`	string	Extracted article title
`Data.description`	string	Short description or summary
`Data.author`	string	Article author (if available)
`Data.published`	string	Published date/time (format: YYYY-MM-DD HH:MM)
`Data.content`	string	Main article HTML content (cleaned)
`Data.image`	string	Main article image URL
`Data.links`	array	List of hyperlinks inside the article
`Data.favicon`	string	Website favicon URL
`Data.source`	string	Source domain (e.g., cnn.com)
`Data.ttr`	int	Estimated reading time (in minutes)
`Data.type`	string	Content type (e.g., article, news, blog)

📊 API Status Codes

Status Code	Description
`200`	Success – valid response returned
`400`	Parameter error – check request fields
`402`	Invalid APPKEY – please verify your API key
`403`	Account expired or restricted
`429`	Rate limit exceeded (max 5 requests/sec)
`500`	Internal API error – try again later

💡 Ideal Use Cases

Whether you're building a data-driven platform or automating web content extraction, Gugudata’s Article Extraction API fits perfectly into these scenarios:

Content Aggregators: Fetch clean content from multiple sources to build a curated news or blog platform.
News Monitoring & Sentiment Analysis: Extract article text for NLP tasks like opinion mining and topic modeling.
Custom Search Engines: Provide cleaner, more readable search results by removing unnecessary page elements.
Knowledge Management: Archive structured article data for internal knowledge bases or document indexing.
AI Training Data Collection: Prepare article datasets with minimal noise for model training or fine-tuning.

⚙️ Why Choose Gugudata?

🧠 Smart Content Detection: Built-in algorithms intelligently isolate main content from layout and noise.
⚡ Ultra-Fast API: Distributed infrastructure ensures low-latency responses anywhere in the world.
🔐 Secure & Compliant: HTTPS and full Apple ATS compatibility for seamless mobile and web integration.
🌍 Multi-Node CDN Deployment: Guaranteed speed and uptime even under high traffic loads.
🔧 Easy Integration: JSON-based output and language-agnostic HTTP interface.

🧪 Try the Live Demo

Want to test it right now? Use the interactive demo endpoint to see how the API performs with a real URL.

🔗 Related APIs from Gugudata

Explore other high-performance APIs for developers:

HTML/URL to PDF Conversion: Convert full webpages into downloadable PDF files.
Readable Web Content Extraction: Identify key readable areas in a webpage.
Domain DNS Record Lookup: Retrieve DNS information for any domain.
SSL Certificate Info Parser: Extract details from domain SSL certificates.

📬 Get Started Today

Getting started with Gugudata is easy:

Sign up for a developer account.
Get your free trial API key.
Start calling the API in minutes!

📨 Need help? Contact us at support@gugudata.io

Gugudata empowers developers with powerful, fast, and intelligent data APIs — enabling smarter applications and seamless content extraction across the web.

Image Compress API

GuGuData — Tue, 30 Dec 2025 10:59:27 +0000

Image Compress API

The Image Compress API from Gugudata enables developers to efficiently compress and optimize images via API. Whether you're working with user-uploaded files or image URLs, this API provides full control over compression quality, resizing, and format conversion.

Designed for integration into high-performance websites, mobile applications, and content management systems (CMS), this API helps reduce bandwidth usage and improve image loading speeds without compromising on visual quality.

📘 View full API documentation

🔧 Manage your appkey & usage

🔧 Features Overview

Supports both file upload and image URL processing
Customizable compression quality (1–95, default: 85)
Flexible size control: set exact target dimensions or max constraints
Maintains image aspect ratio automatically
Optional format conversion: JPEG, PNG, etc.
Handles large image files (up to 10MB)
High-performance API with load balancing
TLS 1.0–1.3 supported, fully HTTPS and Apple ATS compatible
Distributed CDN across regions for fast response

📌 API Endpoint

URL: https://api.gugudata.io/v1/image/image-compress
Method: POST
Content-Type: multipart/form-data or application/x-www-form-urlencoded
Test the API: Demo here

🧾 Request Parameters

Name	Type	Required	Default	Description
`appkey`	string	Yes	YOUR_APPKEY	Your API key from Gugudata. Required for authentication.
`file`	file	No	N/A	Upload an image file (JPEG, PNG, etc.). Provide either `file` or `image_url`, not both.
`image_url`	string	No	N/A	Public image URL to process. Provide either `image_url` or `file`, not both.
`targetWidth`	integer	No	N/A	Desired width (px). Will maintain aspect ratio.
`targetHeight`	integer	No	N/A	Desired height (px). Will maintain aspect ratio.
`maxWidth`	integer	No	N/A	Maximum allowed width. Image will be resized if larger.
`maxHeight`	integer	No	N/A	Maximum allowed height. Image will be resized if larger.
`quality`	integer	No	85	Compression level (1–95). Higher = better quality.
`format`	string	No	original	Output format (e.g., jpeg, png). Defaults to original format.

📤 Response Format

The API responds with a binary stream of the compressed image.

Content-Type: Based on the image format (e.g., image/jpeg)
Response: Direct binary image data

Make sure your client handles binary image responses correctly.

❗ Error Codes

Code	Message	Description
200	Normal return	Image compressed successfully
400	Parameter error	Invalid or missing parameters; file or URL required
402	APPKEY error	Invalid or unauthorized appkey
403	Account in arrears	Service blocked due to unpaid usage
429	Too many requests	Exceeded 100 requests/second
500	Server error	Internal processing error
503	Service unavailable	External service is currently down

💡 Example Request

curl -X POST "https://api.gugudata.io/v1/image/image-compress" \
  -H "Content-Type: multipart/form-data" \
  -F "appkey=YOUR_APPKEY" \
  -F "file=@your-image.jpg" \
  -F "quality=80" \
  -F "format=jpeg"

Or using a URL:

curl -X POST "https://api.gugudata.io/v1/image/image-compress" \
  -d "appkey=YOUR_APPKEY" \
  -d "image_url=https://example.com/image.png" \
  -d "quality=75" \
  -d "maxWidth=800"

✅ Use Case Scenarios

Website Performance: Compress homepage banners and thumbnails before delivery.
User Uploads: Optimize profile pictures or gallery images in real time.
CMS Integration: Automatically resize and convert images during publishing.
E-Commerce: Generate optimized product images for faster loading.
Mobile Apps: Reduce bandwidth and storage for image-heavy apps.

📊 Developer Resources

🧭 API Details: https://gugudata.io/details/image-compress
🛠 Dashboard / API Key Management: https://gugudata.io/dashboard
📈 API Status: https://www.gugudata.com/status
🌐 Website: https://gugudata.io

The Image Compress API is ideal for developers building performance-oriented platforms with rich media content. With intelligent optimization and high-speed delivery, it streamlines your image pipeline while preserving quality.

图片压缩与尺寸优化 API 接口

GuGuData — Thu, 18 Dec 2025 10:18:40 +0000

图片压缩与尺寸优化 API 接口

图像/转换图片压缩优化，保持长宽比，保证清晰度图片压缩 / 图片优化 / 尺寸调整图片压缩 / 图片处理

1. 产品功能

支持本地上传图片或网络图片 URL，一键完成压缩；
自动保持图片长宽比，可按目标尺寸或最大尺寸进行等比缩放；
针对 JPEG 采用优化压缩（渐进式、优化 Huffman 表等），在保证清晰度的前提下显著减小体积；
支持 PNG 等无损格式的体积优化压缩；
自动限制过大图片的尺寸（默认 1920 像素上限），避免带宽浪费；
接口默认 HTTPS，兼容 Apple ATS，配合多节点 CDN 提供高可用服务。
全国多节点 CDN 部署；
接口极速响应，多台服务器构建 API 接口负载均衡。
接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/image-compress

接口地址: https://api.gugudata.com/ai/image-compress

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

请求方式: POST

请求协议: HTTPS

请求示例: https://api.gugudata.com/ai/image-compress

数据预览: https://www.gugudata.com/preview/image-compress

接口测试: https://api.gugudata.com/ai/image-compress/demo

3. 请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	YOUR_APPKEY	付费后获取的 APPKEY，可通过 Query 参数或 Form 字段 appkey 传递
image_file	file	否		上传的图片文件，支持 JPG / JPEG / PNG / GIF / WEBP / BMP，与 image_url 二选一必填
image_url	string	否		网络图片 URL，与 image_file 二选一必填，需为可直接访问的 HTTP/HTTPS 链接
targetwidth	int	否		目标宽度（像素），与 targetHeight 组合使用时按照最长边等比缩放；不传则不以此为约束
targetheight	int	否		目标高度（像素），与 targetWidth 组合使用时按照最长边等比缩放；不传则不以此为约束
maxwidth	int	否		最大宽度（像素），只限制不超过该宽度并保持长宽比；当未显式传递任何尺寸参数且图片特别大时，服务会自动使用 1920 作为默认上限
maxheight	int	否		最大高度（像素），只限制不超过该高度并保持长宽比；当未显式传递任何尺寸参数且图片特别大时，服务会自动使用 1920 作为默认上限
quality	int	否	85	JPEG 压缩质量，取值范围 1-95，数值越低压缩越厉害，推荐在 60-90 之间；PNG 等无损格式将使用内部优化策略忽略该参数
format	string	否		输出图片格式，可选值：jpeg、png 等；不传则保持原图格式（对于部分不常见格式会自动转换为 JPEG）

4. 返回参数

参数名	参数类型	备注
HTTP Header.Content-Type	string	返回图片的 MIME 类型，例如 image/jpeg、image/png 等
HTTP Header.Content-Disposition	string	文件下载头，包含建议的下载文件名，默认会根据原始文件名和格式自动生成
Body(Binary)	binary	压缩后图片的二进制流内容，可直接保存为图片文件或在浏览器中显示

PDF Full-Text Multilingual AI Summary API

GuGuData — Sat, 13 Dec 2025 09:51:04 +0000

PDF Full-Text Multilingual AI Summary API

The PDF Full-Text Multilingual AI Summary API by GuguData provides developers with an intelligent tool to automatically analyze and summarize the contents of PDF documents. With support for multiple languages, this API is ideal for extracting insights from large documents without manual reading or translation.

Whether you're building document management systems, knowledge bases, or research tools, this API allows you to turn full PDF files into concise, high-quality summaries with just a single API call.

👉 Try the Demo

✨ Key Features

🤖 AI-powered full-text analysis of uploaded PDF documents
🌍 Multilingual support for summaries in English, Chinese, Japanese, Korean, French, German, Spanish, and more
📝 Generates comprehensive summaries that cover main topics and key details
📄 Handles multi-page PDF files and large documents
📌 Automatic content extraction – no need for manual copy-paste or formatting
💡 High-quality summaries with deep context understanding
🔒 HTTPS support including TLS v1.0 to v1.3
🍏 Fully Apple ATS-compatible
🚀 CDN acceleration and multi-server load balancing for ultra-fast response

📡 API Endpoint

URL: https://api.gugudata.io/v1/imagerecognition/pdf-summary
Method: POST
Authentication: Requires appkey (get from your GuguData dashboard)

📥 Request Parameters

Parameter	Type	Required	Description
`appkey`	string	Yes	Your API key from GuguData
`file`	file	Yes	PDF file to be summarized (PDF format only)
`lang`	string	No	Language code for the output summary. Supported: `en`, `zh`, `ja`, `ko`, `fr`, `de`, `es` (default: `en`)

🔁 The API supports multilingual output generation. You can use the lang parameter to customize the language of the summary based on your user's preference.

📤 Response Format

The API returns a JSON object with a concise, AI-generated summary of the PDF content:

{
  "summary": "This document discusses the economic impacts of climate change on global markets..."
}

Field	Type	Description
`summary`	string	AI-generated summary of the document in the requested language

⚠️ Error Codes

Code	Message	Description
200	Normal return	PDF analyzed and summary generated successfully
400	Parameter error	Invalid or missing parameters; unsupported file type
402	APPKEY error	Invalid or missing API key
403	Account in arrears	Account needs activation or payment
429	Too many requests	Exceeded request rate limit (max 100/sec)
500	Internal server error	Issue while processing PDF or generating summary
503	Service unavailable	Temporary service outage

📚 Use Cases

🔍 Knowledge Extraction

Summarize research papers, legal documents, and reports in seconds.

🌐 Multilingual Platforms

Generate summaries in different languages for international users.

🧠 AI-Powered Document Management

Quickly preview document content to improve indexing and retrieval.

🗂️ Enterprise Applications

Enhance internal tools with AI-driven PDF summarization.

📸 API Preview

🧩 Related Tools

Explore more intelligent document and image processing APIs on the GuguData Developer Marketplace.

IP Address Geolocation API

GuGuData — Sat, 13 Dec 2025 09:47:03 +0000

The IP Address Geolocation API provided by GuguData offers a powerful and efficient way to retrieve geographical information for any IP address. Whether you're working with IPv4 or IPv6, this API enables you to quickly identify the user's country, state, city, and coordinates (latitude and longitude).

This is an essential tool for developers who need reliable location data for applications involving fraud detection, content localization, user behavior analysis, or network diagnostics.

👉 Try the Demo

🌐 Key Features

✅ Supports both IPv4 and IPv6 formats
📌 Returns detailed location data: Country, State/Province, City, Latitude, Longitude
⚡ Real-time results with ultra-fast API response
🔒 Full HTTPS support, including TLS v1.0–v1.3 and Apple ATS compatibility
🌍 Globally distributed CDN nodes ensure low latency and high availability
📊 Perfect for:
- Fraud detection and risk analysis
- Content and language localization
- Regional user analytics
- Network performance monitoring

🔧 API Endpoint

Base URL: https://api.gugudata.io/v1/location/ip
Method: GET
Authorization: Requires appkey (available from your GuguData developer dashboard)

📥 Request Parameters

Parameter	Type	Required	Description
`appkey`	string	Yes	Your API key from GuguData
`ip`	string	Yes	The IP address to lookup (IPv4 or IPv6, e.g., `8.8.8.8`, `2001:db8::`)

📤 Response Format

The API returns a structured JSON object. Below are key response fields:

Metadata (under `dataStatus`)

Field	Type	Description
`requestParameter`	string	Echo of the request
`statusCode`	integer	HTTP response code
`status`	string	Status result (e.g., "OK")
`statusDescription`	string	Human-readable status message
`responseDateTime`	string	Timestamp of the response
`dataTotalCount`	integer	Number of results (usually 1)

Geolocation Data (under `data`)

Field	Type	Description
`countryCode`	string	ISO country code (e.g., "US", "CN")
`state`	string	State or province
`city`	string	City name
`latitude`	number	Latitude coordinate
`longitude`	number	Longitude coordinate

⚠️ Error Codes

Code	Meaning	Description
200	Success	Geolocation data retrieved successfully
400	Parameter Error	Invalid IP format or missing parameters
402	Invalid APPKEY	Check if your API key is valid
403	Account in Arrears	Your account needs reactivation
429	Too Many Requests	Rate limited: max 100 requests/sec
500	Internal Server Error	Service failed to process request
503	Service Unavailable	Temporary outage or maintenance

🧩 Use Cases

✅ Fraud Detection

Compare user IP with declared region to detect suspicious behavior.

🌐 Content Localization

Customize site language or layout based on user location.

📈 Marketing & Analytics

Group users by region to tailor campaigns and reports.

🛡️ Access Control

Restrict content availability by country or region.

🖼️ API Preview

📚 Related APIs

Looking for more data APIs? Visit the GuguData API Marketplace for a full list of tools for data analysis, content moderation, and location intelligence.

高考教育信息智能助手 API 接口

GuGuData — Mon, 08 Dec 2025 03:34:24 +0000

高考教育信息智能助手 API 接口

教育/高考高考教育信息智能问答助手智能问答 / 知识库检索 / 多轮对话 AI / 高考 / 高考录取 / 高等教育

1. 产品功能

RAG 智能体，强大的 AI 问答能力，支持高校基础信息查询、招生政策解读、专业介绍与选择建议等；
支持招生政策解读、报考指南与志愿填报建议；
支持多轮对话，通过 session_id 保持对话上下文；
支持知识库检索（RAG），可指定检索范围；
支持流式输出（SSE），实时返回 AI 生成内容；
支持多种请求方式：JSON、Form、Query String；
接口默认 HTTPS，兼容 Apple ATS，配合多节点 CDN 提供高可用服务。
全国多节点 CDN 部署；
接口极速响应，多台服务器构建 API 接口负载均衡。
接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/gaokao-chat

接口地址: https://api.gugudata.com/ai/gaokao/chat

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

请求方式: POST

请求协议: HTTPS

请求示例: https://api.gugudata.com/ai/gaokao/chat

数据预览: https://www.gugudata.com/preview/gaokao-chat

接口测试: https://api.gugudata.com/ai/gaokao/chat/demo

3. 请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	YOUR_APPKEY	付费后获取的 APPKEY，可通过 Query 参数或 JSON body 传入
prompt	string	是	你好，请介绍一下你自己	用户输入的问题，支持通过 JSON body 或 Form 参数传入
session_id	string	否		会话ID，用于多轮对话。首次请求可不传，系统会自动生成并返回；后续请求使用返回的 session_id 可保持对话上下文
streaming	string	否	false	是否启用流式输出（true/false），流式输出采用 SSE (Server-Sent Events) 格式，可通过 Query 参数或 JSON body 传入

4. 返回参数

参数名	参数类型	备注
DataStatus.StatusCode	int	接口返回状态码，100 表示成功
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	int	此条件下的总数据量，一般用于分页计算
Data.text	string	回复的文本内容
Data.session_id	string	会话ID，用于多轮对话。首次请求会自动生成，后续请求使用此 ID 可保持对话上下文
Data.finish_reason	string	完成原因，通常为 'stop' 表示正常完成
Data.request_id	string	请求ID，用于追踪和调试

PDF Full Text Multilingual AI Summary API: Turn Any PDF Into Instant Insights

GuGuData — Tue, 25 Nov 2025 10:14:04 +0000

PDF Full Text Multilingual AI Summary API: Turn Any PDF Into Instant Insights

Long PDF reports, research papers, contracts, manuals and multilingual documents are hard to read and even harder to summarize manually. The PDF Full Text Multilingual AI Summary API from GuGuData helps you convert any PDF into a clean, concise AI generated summary in the language you need with a single HTTP request.

This guide explains what the API does, how it works and how to integrate it into your own products for PDF summarization, document automation and AI knowledge workflows.

https://gugudata.io/details/pdf-summary

What is the PDF Full Text Multilingual AI Summary API

The PDF Full Text Multilingual AI Summary API is a REST API that:

Accepts a PDF file upload

Performs full text parsing and analysis across all pages

Uses an AI model to understand structure, topics and key points

Returns a high quality summary in your target language

Key highlights:

Category: imagerecognition

Endpoint path: /v1/imagerecognition/pdf-summary

HTTP method: POST

Test endpoint: https://api.gugudata.io/v1/imagerecognition/pdf-summary/demo

With this API you can quickly build:

PDF AI summary tools

Knowledge management and research assistants

Enterprise document dashboards

Edtech or LMS content digests

Multilingual document understanding pipelines

Key features of the PDF AI summary API

The API is optimized for real world production workloads and developer integration.

AI capabilities

AI powered full text analysis of PDF documents

Comprehensive summary generation covering main topics and key points

High quality AI generated summaries with context understanding

Automatic extraction and analysis of document content

Support for multi page PDF documents

Multilingual summary support

You can generate summaries in multiple languages by switching a single parameter:

English en

Chinese zh

Japanese ja

Korean ko

French fr

German de

Spanish es

This is especially useful for:

Translating long English research papers into Chinese summaries

Creating English summaries of local language government or legal PDFs

Supporting global users with localized document digests

Production ready infrastructure

The API is built and deployed for high availability:

Full HTTPS support with TLS v1.0, v1.1, v1.2, v1.3

Fully compatible with Apple ATS for iOS and macOS apps

Nationwide multi node CDN deployment

Load balancing across multiple servers for fast responses

This makes it suitable for SaaS products, large scale dashboards and mobile apps where stability and latency matter.

Typical use cases

You can use the PDF Full Text Multilingual AI Summary API in many scenarios:

Research and academic tools
Automatically summarize papers, theses and conference proceedings. Offer short abstracts in multiple languages.

Legal and contract review
Generate high level briefs of contract PDFs so lawyers and business users can focus on the important clauses.

Enterprise document management
Turn internal manuals, reports and policy PDFs into searchable summaries for intranets and knowledge bases.

Education and learning platforms
Provide students with short summaries of long reading materials in their native language.

News and media monitoring
Summarize PDF based reports from think tanks, governments and NGOs and push highlights to dashboards.

Customer support and knowledge centers
Summarize product manuals and technical PDFs to power chatbots, help centers and FAQ content.

Request details

The API uses a simple POST request with multipart form data.

Endpoint

Base: https://api.gugudata.io

Path: /v1/imagerecognition/pdf-summary

Method: POST

Content type: multipart/form-data

Request parameters

Required and optional fields:

appkey

Type: string

Required: yes

Description: Your GuGuData app key, obtained from the developer center after payment and activation.

file

Type: file

Required: yes

Description: The PDF file to summarize. Only PDF format is accepted.

lang

Type: string

Required: no

Default: en

Description: Target language code for the summary, for example en, zh, ja, ko, fr, de, es.

If lang is omitted, the API returns an English summary by default.

Quick start example

Below is a minimal curl example that uploads a PDF and requests a Chinese summary.

curl -X POST "https://api.gugudata.io/v1/imagerecognition/pdf-summary" -H "Accept: application/json" -F "appkey=YOUR_APPKEY" -F "file=@/path/to/your-document.pdf" -F "lang=zh"

Example request for an English summary:

curl -X POST "https://api.gugudata.io/v1/imagerecognition/pdf-summary" -H "Accept: application/json" -F "appkey=YOUR_APPKEY" -F "file=@/path/to/your-document.pdf"

To quickly test without writing code you can also call the demo endpoint:

https://api.gugudata.io/v1/imagerecognition/pdf-summary/demo

Response format

On success the API returns a JSON object containing the AI generated summary.

Successful response structure

summary

Type: string

Description: AI generated summary of the PDF document in the specified language.

Example JSON:

{
"summary": "This PDF presents an in depth analysis of the 2024 global energy transition. It covers policy trends, renewable capacity growth, investment flows and regional case studies. Key findings include..."
}

You can directly display this summary in your UI or feed it to downstream AI workflows like embeddings, semantic search or chatbots.

Error handling and status codes

To build a robust integration you should handle different error codes from the API.

Main error codes:

200 Normal return

The PDF was successfully analyzed and a summary was generated.

400 Parameter error

Required parameters are missing or invalid.

The file is not a valid PDF.

Action: Check appkey, file and lang values before retrying.

402 APPKEY error

The appkey is invalid or does not match the developer center configuration.

Action: Confirm the key from your GuGuData account and update your environment variables.

403 Account in arrears

The account has not been paid or has overdue balance.

Action: Recharge or renew your plan in the billing center.

429 Request frequency limited

The request rate is too high, for example more than 100 requests per second.

Action: Add client side rate limiting or queues before retrying.

500 API response error

Internal error while processing the PDF or generating the AI summary.

Action: Log the error, retry with backoff and contact support if it persists.

503 Service unavailable

External service temporarily unavailable.

Action: Implement retry with exponential backoff and circuit breaker logic.

By correctly interpreting these codes you can provide clear error messages to your users and keep your document pipelines stable.

Pricing and integration considerations

The PDF Full Text Multilingual AI Summary API is a paid service:

Paid usage with appkey authentication

Pricing levels starting from around 99 units for discounted plans

Designed for both low volume indie projects and high volume SaaS workloads

For production systems consider:

Caching summaries for the same document hash to avoid duplicate calls

Using a message queue for large batch PDF processing

Storing both the original PDF and generated summary in your own storage

Logging appkey usage and error codes for monitoring

SEO tips when using PDF AI summaries on your site

If you embed the generated summaries into your website or product, you can improve search visibility by:

Including relevant keywords such as
PDF AI summary, multilingual PDF summarization, PDF summary API, AI document summary, PDF content analysis

Adding the summary as readable HTML text next to your PDF viewer or download link

Using the summary text in meta description fields where appropriate

Building category pages that aggregate AI summaries for related topics or industries

Providing language switchers using the lang parameter so search engines can index localized pages

The more structured and readable your AI generated summaries are, the better they can contribute to organic traffic and user engagement.

Why choose GuGuData for PDF AI summarization

GuGuData has long experience in data APIs and AI services. This PDF Full Text Multilingual AI Summary API benefits from:

Stable infrastructure with multi node CDN and load balancing

Modern TLS support and Apple ATS compatibility for mobile integrations

Clear error codes and documentation for developers

Focus on performance and reliability for real production scenarios

If you are building a tool that needs fast, accurate and multilingual PDF summaries, this API gives you a ready to use backend so you can focus on product and user experience instead of low level document parsing and AI orchestration.

Start using the PDF Full Text Multilingual AI Summary API

Get your appkey from the GuGuData developer center, call the /v1/imagerecognition/pdf-summary endpoint and start turning long PDFs into concise multilingual insights in your own applications.

基于模型的高校录取概率预测 API 接口

GuGuData — Thu, 13 Nov 2025 11:18:42 +0000

基于模型的高校录取概率预测 API 接口

教育/高考融合历年分数线与分段位次特征录取概率模型 AI预测 / 高考志愿 / 录取概率 AI / 高考 / 高考录取 / 高等教育

1. 产品功能

基于 LightGBM 梯度提升框架，融合院校分数线、高校与专业录取分数线、分段位次等多源异构数据；
采用 Isotonic 回归进行预测校准，保证录取概率输出稳定可信；
自动生成冲/稳/保梯度建议，并提供分差最小值与中位数等统计指标；
返回 SHAP 特征贡献明细，透明解释模型决策依据；
支持省份过滤、白名单院校、Top-N 控制等高级筛选能力；
支持 Query 与 JSON 组合入参，便于脚本与后端系统同时调用；
底层 MongoDB 数据按年度更新，同步最新高考年份信息；
接口默认 HTTPS，兼容 Apple ATS，配合多节点 CDN 提供高可用服务。
全国多节点 CDN 部署；
接口极速响应，多台服务器构建 API 接口负载均衡。
接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/admission-predict

接口地址: https://api.gugudata.com/ai/admission/predict?appkey={{appkey}}

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

请求方式: POST

请求协议: HTTPS

请求示例: https://api.gugudata.com/ai/admission/predict?appkey={{appkey}}

数据预览: https://www.gugudata.com/preview/admission-predict

接口测试: https://api.gugudata.com/ai/admission/predict/demo

3. 请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	YOUR_APPKEY	付费后获取的 APPKEY，可通过 Query (?appkey=) 提供
province	string	是	N/A	考生所在省份，与历年分数线数据保持一致
subject_type	string	是	N/A	科类/选科：理科、文科、物理类、历史类、综合等
score	number	是	N/A	考生裸分（0-750）
rank	int	否	N/A	考生全省位次，可为空（为空时结合分段位次推断）
batch	string	否	本科批	报考批次，目前支持普通本科批次
top_n	int	否	50	返回院校数量上限，范围 1-200
include_explanation	bool	否	true	是否返回 SHAP 特征贡献解释
prefer_local	bool	否	false	是否在排序时优先本省院校
college_provinces	array(string)	否	N/A	按院校所在省份过滤，留空则不过滤；Query 方式可多次传值，格式 ["江苏", "上海"]
target_colleges	array(string)	否	N/A	指定院校名单，仅对名单内院校预测

4. 返回参数

参数名	参数类型	备注
DataStatus.StatusCode	int	接口状态码，100 表示成功
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	返回时间
DataStatus.DataTotalCount	int	本次返回院校数量
Data.predictions	array	预测结果列表
Data.predictions[].college_name	string	院校名称
Data.predictions[].admission_probability	float	录取概率 (0-1)
Data.predictions[].recommendation	string	梯度建议：录取概率高 / 需要注意梯度，但成功率较高 / 录取概率低
Data.predictions[].evidence	object	关键信息：recent_3y_min_score、score_gap、province_line_gap、is_985、is_211、is_dual_class、college_rank 等
Data.predictions[].shap_explanation	object	SHAP 解释信息，含 base_probability、predicted_probability、top_features
Data.meta.total_colleges	int	返回院校数量
Data.meta.student_score	float	考生分数
Data.meta.student_province	string	考生省份
Data.meta.local_colleges	int	结果中同省院校数量，无 is_local 字段时为 null
Data.meta.score_diff_min	float	分差绝对值最小值
Data.meta.score_diff_median	float	分差绝对值中位数，用于梯度判断
Data.meta.prefer_local	bool	是否启用本省优先排序
Data.meta.college_provinces	array(string)	请求中用于过滤院校省份的列表
Data.meta.model_version	string	模型版本号
Data.disclaimer	string	免责声明