{"uid":"cap_BjlN0rZCmbiDfw_0G4iw0","slug":"2s-io-url-map-link-sitemap-extractor-1f6c3406","name":"2s.io URL Map — Link & Sitemap Extractor","description":"Discover the URLs a page or sitemap points at in a single fetch. Point it at an XML sitemap or sitemap-index and it returns the <loc> URLs; point it at an HTML page and it returns the <a href> links — auto-detected. URLs are resolved to absolute, de-duplicated, fragment-stripped, and http(s)-only. `limit` (1-2000, default 200) caps the count; `sameHostOnly` keeps only links on the same host. Single SSRF-guarded fetch, no JavaScript, stateless — NOT a recursive crawler: to go deeper, call map again on a child sitemap or a discovered page. Returns { url, finalUrl, source: \"sitemap\"|\"links\", count, capped, urls }.","url":"https://2s.io/api/url/map","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["url"],"properties":{"url":{"type":"string"},"limit":{"type":"integer","default":200,"maximum":2000,"minimum":1},"sameHostOnly":{"type":"boolean","default":false}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"url":"https://www.wikipedia.org/","limit":100,"sameHostOnly":false}}},"response":{"data":{"url":"https://www.wikipedia.org/","urls":["https://en.wikipedia.org/","https://ja.wikipedia.org/","https://de.wikipedia.org/","https://ru.wikipedia.org/","https://fr.wikipedia.org/","https://es.wikipedia.org/","https://zh.wikipedia.org/","https://it.wikipedia.org/","https://pl.wikipedia.org/","https://pt.wikipedia.org/","https://ar.wikipedia.org/","https://fa.wikipedia.org/","https://arz.wikipedia.org/","https://nl.wikipedia.org/","https://ceb.wikipedia.org/","https://sv.wikipedia.org/","https://uk.wikipedia.org/","https://vi.wikipedia.org/","https://war.wikipedia.org/","https://af.wikipedia.org/","https://sq.wikipedia.org/","https://ast.wikipedia.org/","https://az.wikipedia.org/","https://bg.wikipedia.org/","https://zh-min-nan.wikipedia.org/","https://bn.wikipedia.org/","https://be.wikipedia.org/","https://ca.wikipedia.org/","https://cs.wikipedia.org/","https://cy.wikipedia.org/","https://da.wikipedia.org/","https://et.wikipedia.org/","https://el.wikipedia.org/","https://eo.wikipedia.org/","https://eu.wikipedia.org/","https://gl.wikipedia.org/","https://ko.wikipedia.org/","https://ha.wikipedia.org/","https://hy.wikipedia.org/","https://hi.wikipedia.org/","https://hr.wikipedia.org/","https://id.wikipedia.org/","https://he.wikipedia.org/","https://ka.wikipedia.org/","https://lld.wikipedia.org/","https://la.wikipedia.org/","https://lv.wikipedia.org/","https://lt.wikipedia.org/","https://hu.wikipedia.org/","https://mk.wikipedia.org/","https://mg.wikipedia.org/","https://mr.wikipedia.org/","https://ms.wikipedia.org/","https://min.wikipedia.org/","https://my.wikipedia.org/","https://no.wikipedia.org/","https://nn.wikipedia.org/","https://ce.wikipedia.org/","https://uz.wikipedia.org/","https://kk.wikipedia.org/","https://ro.wikipedia.org/","https://simple.wikipedia.org/","https://sk.wikipedia.org/","https://sl.wikipedia.org/","https://sr.wikipedia.org/","https://sh.wikipedia.org/","https://fi.wikipedia.org/","https://sw.wikipedia.org/","https://ta.wikipedia.org/","https://tt.wikipedia.org/","https://te.wikipedia.org/","https://th.wikipedia.org/","https://tg.wikipedia.org/","https://azb.wikipedia.org/","https://tr.wikipedia.org/","https://ur.wikipedia.org/","https://zh-yue.wikipedia.org/","https://ace.wikipedia.org/","https://als.wikipedia.org/","https://am.wikipedia.org/","https://an.wikipedia.org/","https://hyw.wikipedia.org/","https://gor.wikipedia.org/","https://ban.wikipedia.org/","https://bjn.wikipedia.org/","https://map-bms.wikipedia.org/","https://ba.wikipedia.org/","https://be-tarask.wikipedia.org/","https://bcl.wikipedia.org/","https://bpy.wikipedia.org/","https://bar.wikipedia.org/","https://bs.wikipedia.org/","https://br.wikipedia.org/","https://cv.wikipedia.org/","https://dag.wikipedia.org/","https://ary.wikipedia.org/","https://nv.wikipedia.org/","https://eml.wikipedia.org/","https://hif.wikipedia.org/","https://fo.wikipedia.org/"],"count":100,"capped":true,"source":"links","finalUrl":"https://www.wikipedia.org/"},"meta":{"cost":{"usd":0.00108,"tier":0},"caller":"x402","version":null,"endpoint":"url.map","settlement":{"txHash":"0x26804d4c16bbf7724b3f21261e255eda7a9ec3cd8cd82e3aeadcff1dce1bcdf5","network":"eip155:8453","success":true}}}},"exampleRequest":{"url":"https://www.wikipedia.org/","limit":100,"sameHostOnly":false},"tags":["x402"],"displayCostAmount":"0.00108","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.00108/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0027","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0027","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bFlVFYa5QhOA6Qgsa9i8o","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0027","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a URL (HTML page or XML sitemap/sitemap-index) and returns all discovered links or <loc> URLs, resolved to absolute, deduplicated, and filtered to http(s) only.","exampleAgentPrompt":"Can you fetch https://example.com/sitemap.xml and give me the list of all URLs it contains — up to 500 of them, same host only?","exampleUseCases":null,"resultDescription":"Returns a JSON object with: the input url, finalUrl (after any redirects), source ('sitemap' or 'links'), count of URLs found, capped boolean indicating if limit was hit, and urls array of absolute deduplicated http(s) URLs.","failureModes":["SSRF guard blocks private/internal IP ranges — returns error for localhost or RFC1918 addresses","URL unreachable or times out — returns fetch error","Non-HTML, non-XML content type — may return empty urls array","limit out of range (< 1 or > 2000) — validation error","Missing required url param — returns 400 bad request","Redirects to disallowed resource — blocked by SSRF guard"],"whenToPreferThis":"Use this endpoint when you need a single-hop extraction of all links from an HTML page or all <loc> URLs from an XML sitemap or sitemap-index, with auto-detection of the content type. Prefer this over a full crawler when you want a fast, stateless, non-recursive snapshot of outbound links or sitemap entries. Ideal for seeding a crawl queue, auditing a sitemap, or discovering pages for further processing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:24:58.073Z","isFirstParty":false}