Skip to content
GET/links

List every link on a page

Returns every anchor on the page, deduplicated, resolved to absolute URLs, with its visible link text and whether it points at the same origin.

Capped at 500 links per response; the counts reflect the full total.

$0.0015 per call60 req/minFree allowance applies

Request

curl -X GET "https://www.twotic.dev/v1/web-extract/links" \
  -H "Authorization: Bearer $TWOTIC_KEY"

Parameters

query parameters

NameTypeRequiredDescription
urlstringrequiredThe absolute URL to read links from.e.g. https://example.com

Response

200The links found on the page.
{
  "url": "https://example.com",
  "count": 42,
  "links": [
    {
      "url": "https://example.com/pricing",
      "text": "Pricing",
      "internal": true
    },
    {
      "url": "https://github.com/example",
      "text": "GitHub",
      "internal": false
    }
  ],
  "external": 11,
  "internal": 31
}

As an agent tool

Connect https://www.twotic.dev/api/mcp/web-extract and this endpoint is exposed as the tool web-extract_links.

Return every outbound link on a web page, deduplicated and resolved to absolute URLs, each labelled internal or external. Choose this when you need a page's link graph — crawling, broken-link auditing, or finding where a page points — rather than its readable content. Requires `url`. Use the extract tool instead if you need the article text.