apyhub
DATA EXTRACTION

Extract Article Content from Web Page API

What it does

Article Content Extractor pulls readable article data from a web page URL and returns the text and metadata you can use in your app. Send a URL, get back fields like title, author, platform, wordCount, articleBody, readingTime, publicationDate, and publicationName when they are available.

Use the single-page GET endpoint for one article, or the POST endpoint when you need to process multiple URLs in one request. The batch response includes a data array with the extracted records and a count value so you can track how many pages were processed.

This is useful when you need to ingest blog posts into a CMS, index articles for search, summarize source material, or build reading lists from published content. It helps you avoid custom scraping logic for common article pages and gives you structured text instead of raw HTML.

Article Content Extractor is designed for web pages that contain article-style content. It works best when the page exposes standard publishing metadata and readable body text.

▣ ENDPOINT 01 / 02
GET
Extract article content from a web page
http://localhost:8080/namastesumalya/extract-article-content
QUICKSTARTGUIDE

Quickstart

Fetch article metadata and extracted content by passing the article URL as a query parameter.

curl -X GET "http://localhost:8080/namastesumalya/extract-article-content?url=https://example.com/article" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with article details in top-level fields such as url, title, author, platform, wordCount, articleBody, readingTime, publicationDate, and publicationName.

{
  "url": "https://example.com/article",
  "title": "Understanding Modern Content Pipelines",
  "author": "John Doe",
  "platform": "WordPress",
  "wordCount": 850,
  "articleBody": "This article explains how modern content pipelines work, including extraction, transformation, and delivery processes...",
  "readingTime": "4 min",
  "publicationDate": "2026-02-10T00:00:00Z",
  "publicationName": "Example Blog"
}
TRY ITLIVE · 300 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Extracts article content from the web page at the given url and returns structured article metadata and text content.

Query Parameter(s)

AttributeTypeMandatoryDescription
urlStringYesThe web page URL to extract article content from.

Response

Returns a JSON object with article fields including url, title, author, platform, wordCount, articleBody, readingTime, publicationDate, and publicationName.

ParameterTypeMandatoryDescription
urlStringNoThe source page URL.
titleStringNoThe article title.
authorStringNoThe article author.
platformStringNoThe platform detected for the page.
wordCountIntegerNoThe article word count.
articleBodyStringNoThe extracted article body text.
readingTimeStringNoThe estimated reading time.
publicationDateStringNoThe publication date/time.
publicationNameStringNoThe publication name.

Query parameters

Name
Type
Description
urlREQUIRED
string
▣ ENDPOINT 02 / 02
POST
Batch extract article content from multiple web pages
http://localhost:8080/namastesumalya/extract-article-content
QUICKSTARTGUIDE

Quickstart

Send one or more article URLs to extract their content.

curl -X POST "http://localhost:8080/namastesumalya/extract-article-content" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://example.com/article1","https://example.com/article2"]}'

What you'll get back

Returns a JSON object with a data array of extracted article objects and a count integer for how many articles were processed.

{
  "data": [
    {
      "url": "https://example.com/article",
      "title": "Understanding Modern Content Pipelines",
      "author": "John Doe",
      "platform": "WordPress",
      "wordCount": 850,
      "articleBody": "This article explains how modern content pipelines work, including extraction, transformation, and delivery processes...",
      "readingTime": "4 min",
      "publicationDate": "2026-02-10T00:00:00Z",
      "publicationName": "Example Blog"
    }
  ],
  "count": 2
}
TRY ITLIVE · 500 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
urls

About this endpoint

What it does

Extracts article content from multiple web page URLs sent in the request body and returns an array of extracted article records, along with a total count.

Request Body

ParameterTypeMandatoryDescription
urlsString ArrayYesA list of web page URLs to process.

Response

Returns a JSON object with a data array and a count integer field. Each item in data is an object containing the extracted article details for one URL, and count is the total number of returned items.

ParameterTypeMandatoryDescription
dataObject ArrayNoAn array of article objects. Each object may include:<br>- url (String): The source page URL.<br>- title (String): The article title.<br>- author (String): The article author.<br>- platform (String): The publishing platform.<br>- wordCount (Integer): The article word count.<br>- articleBody (String): The extracted article text.<br>- readingTime (String): The estimated reading time.<br>- publicationDate (String): The publication date/time.<br>- publicationName (String): The publication name.
countIntegerNoThe total number of items in data.

Body

Name
Type
Description
bodyREQUIRED
object
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.