Get URL links - API Documents - GuGuData | Production-Ready APIs Built for Developers

Extract Links from URL
Extract hyperlinks from a target webpage URL.

Method: GET
Path: /v1/websitetools/url2links
Demo: https://api.gugudata.io/v1/websitetools/url2links/demo
OpenAPI: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json

Request Parameters:

appkey (string, required): Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type.
url (string, required): Target webpage URL.

Response Fields:

result (array, required): Array of extracted links from the webpage
count (integer, required): Number of links extracted
requestParameter (string, required): Request parameters for logging purposes

HTTP Status Codes:

200: Request processed successfully. Some endpoints expose a separate application-level status field in the response body, such as dataStatus.statusCode.
400: Invalid request parameters or request format. Check required fields, data types, and request body format.
401: Missing or unknown application key. Provide a valid appkey with the request.
403: The application key is recognized but access is not allowed. The key may be expired, inactive, or not permitted for the requested API.
429: Request rate or trial usage limit exceeded. Reduce concurrency or retry after the limit window resets.
500: Internal service error. Retry later or contact support if the error persists.
503: Upstream service unavailable. Retry later; the requested upstream dependency is temporarily unavailable.

Business Status Codes:

200 Normal return: Links successfully extracted and returned
400 Parameter error: URL is empty or invalid format
429 Request frequency limited: Cannot exceed 100 requests per second
403 Account in arrears: Payment required to continue using the service
402 APPKEY error: Please check whether the APPKEY passed is obtained from the developer center
500 API response error: External service error during link extraction
503 Service unavailable: External service temporarily unavailable

Key Features:

Extract links from any publicly accessible webpage using advanced browser rendering.
Captures JavaScript-generated links and dynamic content.
Extracts internal links, external links, and resource links.
Automatic URL validation and comprehensive error handling.
Powered by Cloudflare's advanced browser rendering technology.
Perfect for web scraping, SEO analysis, and link building.
Full API support for HTTPS (TLS v1.0 / v1.1 / v1.2 / v1.3).
Fully compatible with Apple ATS.
Nationwide multi-node CDN deployment.
Ultra-fast response, API interface load balancing built with multiple servers.

Details:
https://gugudata.io/details/url2links

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{
  "result": [
    {}
  ],
  "count": 0,
  "requestParameter": "string",
  "DataStatus": {
    "StatusCode": 100,
    "StatusDescription": "OK",
    "ResponseDateTime": "2026-01-01 00:00:00",
    "DataTotalCount": 1
  }
}