---
title: URls Detector API
slug: detect-urls
url: https://apyhub.com/sharpapi/service/detect-urls
provider: SharpAPI
categories: [Data Extraction, Developer Tools, SEO]
tags: [url-detection, link-extraction, text-parsing, web-scraping, developer-tools]
auth: api_key
---

# URls Detector API

Extract URLs from a content string and poll for results. Returns each detected link with its full URL and protocol.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/sharpapi/api/v1/content/detect_urls` | What it does Submits content for asynchronous URL detection and returns identifiers you can use to… | 1000 |
| GET | `/sharpapi/api/v1/detect_urls/job/status/:job_id` | What it does Checks the status of an asynchronous URL-detection job by job ID and returns the job r… | 1 |

## About

## What it does
URL Detector finds web links in text and returns them in a structured job result. Send a `content` string, receive a `job_id` and `status_url`, then poll the status endpoint until the job finishes.

When the job succeeds, the result includes a `data` object with `id`, `type`, and `attributes`. Inside `attributes`, you get the job `type`, the final `status`, and a `result` array of detected URLs. Each item in that array includes the full `url` and its `protocol`, so you can separate `https` links from `mailto`, `tel`, `ftp`, and other schemes.

Use URL Detector when you need to pull links out of user-submitted text, support tickets, documents, or logs before saving them, validating them, or turning them into clickable references. It fits well in moderation pipelines, content ingestion jobs, and link audit workflows where you need the exact URLs rather than a broad text analysis.

The API is asynchronous, which makes it suitable for larger inputs and background processing. Check `status` for `queued`, `running`, `failed`, or `success`, then read the detected URLs from `attributes.result` once processing is complete.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/sharpapi/service/detect-urls