---
title: URL Detector API
slug: detect-urls
url: https://apyverse.com/sharpapi/service/detect-urls
provider: SharpAPI
categories: [Data Extraction, Developer Tools, SEO]
tags: [url-extraction, link-detection, text-parsing, content-analysis, async-jobs]
auth: api_key
---

# URL Detector API

Extract URLs from plain text asynchronously. Returns detected links with their protocol plus job status for queued, running, success, or failed.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/sharpapi/api/v1/content/detect_urls` | What it does Submits a job to detect URLs from the provided content. The response returns a job ide… | 50 |
| GET | `/sharpapi/api/v1/detect_urls/job/status/:job_id` | What it does Checks the status of a previously submitted URL-detection job by job ID and returns th… | 1 |

## About

## What it does
URL Detector finds URLs in plain text and returns them for further processing. Send a block of content in the `content` field, submit the job, then poll the job status endpoint with the returned `job_id`.

When the job completes successfully, the result includes a `result` array of detected URL objects. Each object contains the full `url`, including its scheme or protocol, and the `protocol` value itself. Job status is reported as `queued`, `running`, `success`, or `failed`, so you can build async workflows around large documents or high-volume text feeds.

Use URL Detector when you need to scan user-generated content, emails, support tickets, scraped pages, or logs for links before storage, enrichment, or validation. It is useful anywhere you need to extract URLs without writing your own parser.

The API is straightforward: one request to submit text, one request to check status, and a structured response that gives you the detected links back.

## Usage

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