Detect Duplicate URLs
seo.detect_duplicate_urls
Overview
Group supplied URL strings that share the same syntactic identity key after named normalization We never open a connection, resolve DNS, or follow a redirect. The answer is a structured fact or policy result you can store. A successful call costs 1 execution credit.
A pair-wise eye check misses the third copy; this groups the whole supplied list.
Reliability
seo.detect_duplicate_urls is stable for identical input. Identical input always produces identical JSON. SEO_INPUT_REQUIRED means a required field is missing or has the wrong shape, so send the published object rather than a guessed map; retrying unchanged will not help. SEO_INPUT_TOO_LARGE means a value exceeds its ceiling, so trim it. SEO_HTML_MALFORMED means the HTML could not be parsed under the offline HTML contract, so fix the markup. SEO_XML_MALFORMED means the XML is not well-formed, so correct it. SEO_XML_DOCTYPE_NOT_ALLOWED means the XML includes a DOCTYPE declaration, so strip the DOCTYPE and resend; we refuse DTDs rather than expanding entities. SEO_JSONLD_MALFORMED means a JSON-LD block is not usable JSON, so correct it. SEO_PROFILE_UNKNOWN means the named profile is not bundled, so send one of the published profile ids. SEO_TOO_MANY_RECORDS means a list exceeded its ceiling, so split the batch. SEO_GRAPH_LIMIT_EXCEEDED means the graph exceeded its node or edge ceiling, so shrink it. SEO_INVALID_URL means a URL string is not a usable RFC 3986 URI, so send an absolute URI. SEO_OBSERVATION_INCOMPLETE means required observation coverage is missing, so add the missing evidence. SEO_INPUT_CONFLICT means two fields that cannot be used together were both supplied, so drop one. Retrying an unchanged request will not help.
Context footprint
Returns a compact structured record. A successful call costs 1 execution credit.
When to use it
When you have a list of URL strings and need groups that collide after syntactic rewrite.
When the list still needs crawling, or you are comparing exactly two URLs — use seo.compare_canonical_urls for a pair.
Scope
Non-goals
- Does not fetch a URL, resolve DNS, or run a browser
- Does not predict ranking, choose a winner, or claim live index status
- Does not compare page bodies or pick a canonical
Properties
Capabilities
Cost & billing
Flat rate per invocation
File handling
How we handle your data
What this means
This skill may receive sensitive content and may return submitted, transformed, extracted, or reformatted content.
Squillify guarantees
- Runs inside Squillify
- This skill runs inside Squillify.
- Payloads are not sent to an external service by this skill.
- Squillify does not permanently store submitted payloads.
- Telemetry records metadata only, not submitted content.
- Submitted payloads are not used for training.
- Submitted payloads are not reviewed by humans.
- This skill does not target sensitive data.
- The response may contain submitted or transformed content.
Your responsibility
Squillify does not determine whether submitted content is sensitive. Your application is responsible for deciding what data it is allowed to submit. Your application is responsible for securing the response.
Input schema
| Field | Type | Required | Description |
|---|---|---|---|
| urls | array | Yes | Required. One to 10,000 URL strings to group. Each entry is parsed independently; we compare strings, not live responses. |
| normalizationProfile | string | No | Named syntactic profile applied to every URL. Omit it and we apply seo.safe.url.normalization@1. |
| includeSingletons | boolean | No | When true, groups of size one are returned. Omit it and only keys that appear more than once are returned. |
Output schema
| Field | Type | Required | Description |
|---|---|---|---|
| profile | string | Yes | Effective normalization profile applied to every URL. |
| groups | array | Yes | Sorted groups. Each object has identityKey, urls (original strings in input order), and count. Singleton groups appear only when includeSingletons is true. |
| uniqueCount | integer | Yes | Number of distinct identity keys among the supplied URLs. |
| duplicateCount | integer | Yes | How many extra copies exist beyond the first occurrence of each duplicated key. |
| suppliedCount | integer | Yes | Number of URL strings you sent. |
| includeSingletons | boolean | Yes | Echo of the includeSingletons flag we applied. |
API contract
POST /v1/executecurl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"seo.detect_duplicate_urls","input":{"urls":["HTTPS://Example.com/a","https://example.com/a"]}}'import { Squillify } from "@squillify/sdk";
const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });
const { output } = await sq.execute("seo.detect_duplicate_urls", {"urls":["HTTPS://Example.com/a","https://example.com/a","https://example.com/b"]});Errors
| Code | HTTP | Retryable | Description |
|---|---|---|---|
| VALIDATION_ERROR | 400 | No | The request payload failed schema validation. |
| UNAUTHORIZED | 401 | No | Missing or invalid API key. |
| SKILL_NOT_ACCESSIBLE | 403 | No | The API key is not granted access to this skill. |
| SKILL_NOT_AVAILABLE_FOR_PLAN | 403 | No | This skill is not included in your current plan. |
| PLAN_ELIGIBILITY_UNAVAILABLE | 503 | Yes | Plan eligibility could not be decided. Retry after backoff. |
| SKILL_NOT_FOUND | 404 | No | The requested skill or version does not exist. |
| TENANT_RATE_LIMITED | 429 | Yes | Request rate limit exceeded. Retry after backoff. |
| QUOTA_EXCEEDED | 429 | Yes | Plan quota exhausted. Retryable once the quota period resets. |
| EXECUTION_TIMEOUT | 504 | Yes | Execution exceeded the allowed time budget. |
| SEO_INVALID_URL | 400 | No | The request payload failed this skill's input validation. |
| SEO_INPUT_TOO_LARGE | 429 | No | A size, quota, rate, or time limit was exceeded. |
| SEO_PROFILE_UNKNOWN | 400 | No | The request payload failed this skill's input validation. |
| SEO_TOO_MANY_RECORDS | 429 | No | A size, quota, rate, or time limit was exceeded. |
Other limits
| Limit | Value |
|---|---|
| Recommended inline bytes | 32 KiB |
Limitations
- Does not fetch a URL, resolve DNS, or run a browser
- Does not predict ranking, choose a winner, or claim live index status
- Does not compare page bodies or pick a canonical
- Choosing a winner in a duplicate cluster
- Checking live content overlap
How to call
POST /v1/execute (requires authentication)
{
"skillKey": "seo.detect_duplicate_urls",
"input": {
"urls": [
"HTTPS://Example.com/a",
"https://example.com/a",
"https://example.com/b"
]
}
}Examples
Primary business path
{
"urls": [
"HTTPS://Example.com/a",
"https://example.com/a",
"https://example.com/b"
]
}{
"groups": [
{
"identityKey": "https://example.com/a",
"urls": [
"HTTPS://Example.com/a",
"https://example.com/a"
],
"count": 2
}
],
"profile": "seo.safe.url.normalization@1",
"suppliedCount": 3,
"includeSingletons": false,
"uniqueCount": 2,
"duplicateCount": 1
}Boundary or option path
{
"urls": [
"https://example.com/a",
"https://example.com/b"
],
"includeSingletons": true
}{
"groups": [
{
"identityKey": "https://example.com/a",
"urls": [
"https://example.com/a"
],
"count": 1
},
{
"identityKey": "https://example.com/b",
"urls": [
"https://example.com/b"
],
"count": 1
}
],
"profile": "seo.safe.url.normalization@1",
"suppliedCount": 2,
"includeSingletons": true,
"uniqueCount": 2,
"duplicateCount": 0
}Recommended use cases
- Group product URLs that differ only by HTTPS vs host case
- Count extra copies after syntactic rewrite
Avoid for
- Choosing a winner in a duplicate cluster
- Checking live content overlap
Related skills
Composable with
Safety & privacy
- Runs without calling any external service.
- Your payloads are never stored permanently.
- Telemetry captures metadata only — never your payload contents.
- We never train models on your payloads.
- No human reviews your payloads.