URL Parser docs

Authentication

API key (header: X-SEEKER-Key)

Send your key on every request. Do not put keys in client-side code or public repos. Rotate keys from the dashboard if a secret is exposed.

X-SEEKER-Key: YOUR_API_KEY

Rate limits

Default catalog limit: 60 req/min. Plan-specific limits apply after you subscribe. When throttled, expect 429 with a retryable response — back off and retry with jitter.

• URL Parser: 60 req/min

Errors

Errors return JSON with a machine-readable code and message. Common platform codes:

• 401 — missing or invalid API key
• 403 — key valid but not entitled for this API or plan
• 404 — resource or path not found
• 429 — rate limit exceeded; retry later
• 5xx — upstream or platform failure; retry with backoff

Endpoint-specific errors are listed under each endpoint below.

Versioning

Current documented version: v1. Prefer pinning the version path shown in examples. Breaking changes ship under a new version; check the changelog for platform updates.

URL Parser

Parse a URL into structured components.

Parameters

• urlquerystringrequired

  Absolute URL to parse

• X-SEEKER-Keyheaderstringrequired

  Your API Seeker key

Example code

curl -s "https://urlparser.apiseeker.com/v1/parse" \
  -H "X-SEEKER-Key: YOUR_API_KEY"

Response example

{
  "success": true,
  "data": {
    "href": "https://apiseeker.com/tools?x=1#top",
    "protocol": "https:",
    "host": "apiseeker.com",
    "pathname": "/tools",
    "searchParams": {
      "x": "1"
    },
    "hash": "#top"
  },
  "request_id": "req_example"
}

Errors

• 400 — Invalid or missing parameters
• 401 — Missing or invalid API key
• 429 — Rate limit exceeded