apyhub
DATA EXTRACTION · SEO

Extract Metadata From URL API

What it does

URL Metadata Extractor pulls metadata from web pages for one URL or many URLs in a single request. Send a page address, or submit an array of urls in the batch endpoint, and use the returned metadata in indexing, link previews, content catalogues, or SEO workflows.

Use it when you need to inspect page-level information without building your own scraper. The batch endpoint accepts a JSON body with a required urls array of strings, which is useful for processing a list of articles, product pages, or landing pages at once. The GET endpoint is also available for single-URL extraction.

Because the endpoint schemas do not expose a fixed response shape, this catalog page only guarantees metadata extraction as the outcome. That makes the service suitable for systems that can consume variable page metadata and only need a consistent extraction step in front of downstream parsing, enrichment, or storage.

If you are building crawlers, bookmark previews, internal search, or SEO audits, URL Metadata Extractor gives you a simple way to collect metadata from live pages before you decide how to store or transform it.

▣ ENDPOINT 01 / 02
GET
Extract Metadata From a URL
http://localhost:8080/namastesumalya/extract-metadata-from-url-api
QUICKSTARTGUIDE

Quickstart

Fetch metadata for a webpage by passing its url as a query parameter.

curl -X GET "http://localhost:8080/namastesumalya/extract-metadata-from-url-api?url=https://apyhub.com" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with these top-level string fields: url, title, author, platform, reading_time, publication_date, and publication_name.

{
  "url": "https://apyhub.com/article",
  "title": "Understanding AI in Modern Applications",
  "author": "John Doe",
  "platform": "Medium",
  "reading_time": "4 min",
  "publication_date": "2025-02-10T00:00:00Z",
  "publication_name": "Medium"
}
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 metadata from the URL you provide and returns the discovered page/article fields in a JSON object.

Query Parameter(s)

AttributeTypeMandatoryDescription
urlStringYesThe URL to extract metadata from.

Response

Returns a JSON object containing metadata fields about the supplied URL. The response wrapper includes the url string plus optional string fields for title, author, platform, reading_time, publication_date, and publication_name.

ParameterTypeMandatoryDescription
urlStringNoThe URL that metadata was extracted from.
titleStringNoThe page or article title.
authorStringNoThe content author.
platformStringNoThe publishing platform.
reading_timeStringNoThe estimated reading time.
publication_dateStringNoThe publication date/time as a string.
publication_nameStringNoThe name of the publication.

Query parameters

Name
Type
Description
urlREQUIRED
string
▣ ENDPOINT 02 / 02
POST
Batch Extract Metadata From Multiple URLs
http://localhost:8080/namastesumalya/extract-metadata-from-url-api
QUICKSTARTGUIDE

Quickstart

Send a list of URLs to extract metadata from multiple pages in one request.

curl -X POST "http://localhost:8080/namastesumalya/extract-metadata-from-url-api" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://apyhub.com","https://apify.com"]}'

What you'll get back

Returns a JSON object with a data array. Each item is an object that may include url, title, author, platform, reading_time, publication_date, and publication_name.

{
  "data": [
    {
      "url": "https://example.com/article",
      "title": "Understanding AI in Modern Applications",
      "author": "John Doe",
      "platform": "Medium",
      "reading_time": "4 min",
      "publication_date": "2025-02-10T00:00:00Z",
      "publication_name": "Medium"
    }
  ]
}
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 metadata for multiple URLs in a single request and returns an array of metadata objects for the submitted URLs.

Request Body

ParameterTypeMandatoryDescription
urlsString ArrayYesList of URLs to extract metadata from.

Response

Returns a JSON object with a data array field. Each item in data is an object containing metadata for one URL, with fields for the source URL and extracted page details.

ParameterTypeMandatoryDescription
dataObject ArrayNoArray of metadata objects.
data[].urlStringNoThe URL that was processed.
data[].titleStringNoThe extracted page title.
data[].authorStringNoThe extracted author name.
data[].platformStringNoThe platform or site name.
data[].reading_timeStringNoThe extracted reading time.
data[].publication_dateStringNoThe publication date.
data[].publication_nameStringNoThe publication name.

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.