Bestseller
Image Extraction Article Parsing Web Automation

Extract Images from Article URL API

Extract ordered image candidates from an article

What can this API do?

Article-focused image candidates

Collect the hero image and images from the readable article area instead of unrelated page furniture.

Absolute image URLs

Resolve relative and lazy-loaded sources against the final page URL for easier downstream use.

Best srcset candidate

Select the strongest available image candidate from responsive srcset declarations.

Stable order and deduplication

Preserve meaningful article order while removing repeated final image URLs.

Alt text and dimensions

Receive alternative text and declared width or height values when the page provides them.

SEO and media workflows

Build image audits, media inventories, content previews, accessibility checks, and editorial pipelines.

Extract Images from Article URL API
Annual plan
$29$59
Subscribe Annually Try Demo Request
Try it for free!
Sign in to get a trial key and test all APIs.
Sign In
Secure checkout powered by Stripe

API Document

HTTP Protocol:HTTPS

HTTP Method:POST

HTTP Endpoint:https://api.gugudata.io/v1/websitetools/fetchcontentimages

Response Type:application/json; charset=utf-8

DEMO Endpoint:https://api.gugudata.io/v1/websitetools/fetchcontentimages/demo

Live Demo:Try Interactive Demo

Full API Docs:developers.gugudata.io

API Request Parameters

NameTypeIs RequiredDefault ValueRemark
appkeystringtrueYOUR_APPKEYObtained after payment
urlstringtruehttps://gugudata.github.io/gugudata-io/guides/extract-images-from-article-url-api-seo-guide/Complete public HTTP or HTTPS article URL, up to 2048 characters

API Response Parameters

NameTypeRemark
urlstringFinal page URL after redirects
imagesarray<object>Ordered, deduplicated article image candidates
images.srcstringSelected image source value
images.absoluteUrlstringFinal absolute HTTP or HTTPS image URL
images.altstringImage alternative text, or an empty string
images.widthstring | nullHTML width attribute when available
images.heightstring | nullHTML height attribute when available

API Response Status Codes

Status CodeExplanation of Status CodeRemarks
200Request processed successfully.Some endpoints expose a separate application-level status field in the response body, such as `dataStatus.statusCode`.
400Invalid request parameters or request format.Check required fields, data types, and request body format.
401Missing or unknown application key.Provide a valid `appkey` with the request.
403The application key is recognized but access is not allowed.The key may be expired, inactive, or not permitted for the requested API.
422The target response cannot be processed as a readable article.Use an HTML article page with readable body content and a valid redirect chain.
429Request rate or trial usage limit exceeded.Reduce concurrency or retry after the limit window resets.
500Internal service error.Retry later or contact support if the error persists.
502The target website could not be reached successfully.Retry later or verify that the target website is available.
503The extraction service is temporarily unavailable.Retry later or contact support if the error persists.

Remote MCP

AI client access

Use this API through GuGuData Remote MCP

Connect your AI client once, authorize in the browser, and the client can use the GuGuData API tools available to your account. You do not need to paste an appkey into the MCP client.

Endpoint https://mcp.gugudata.io/mcp
Open MCP Guide
Generic MCP configuration
{
  "mcpServers": {
    "gugudata": {
      "url": "https://mcp.gugudata.io/mcp",
      "transportType": "streamable-http"
    }
  }
}

Code Snippets

Run in Apifox Run in Postman Open LLM Page

Related APIs

Useful APIs to extend this workflow.

View all APIs