docs / url-resolver

URL Resolver API

base /url-resolver/v18 endpoints

post/url-resolver/v1/resolve1 credit

Follow the redirect chain to the final URL (hop-by-hop, every status observable).

Parameter		Allowed / range	Description
url	required	—	Any http(s) URL to resolve — short links (bit.ly, amzn.to, t.co), affiliate links, ad redirect URLs, or regular canonical URLs. Only http/https is accepted.
max_hops = 10	optional	1–10	Maximum redirects to follow (1–10).

Try in playground →

post/url-resolver/v1/normalize1 credit

Resolve then strip tracking params (utm_*/fbclid/gclid…) → canonical URL.

Parameter		Allowed / range	Description
url	required	—	Any http(s) URL to resolve — short links (bit.ly, amzn.to, t.co), affiliate links, ad redirect URLs, or regular canonical URLs. Only http/https is accepted.
follow = true	optional	—	Follow redirects to the final URL before analysing (default true). false = analyse the URL exactly as given (no network).

Try in playground →

post/url-resolver/v1/detect_affiliate1 credit

Detect the affiliate network/params/merchant across the whole redirect chain, incl. first-party brand programs (influencer/seller deeplinks).

Parameter		Allowed / range	Description
url	required	—	Any http(s) URL to resolve — short links (bit.ly, amzn.to, t.co), affiliate links, ad redirect URLs, or regular canonical URLs. Only http/https is accepted.
follow = true	optional	—	Follow redirects to the final URL before analysing (default true). false = analyse the URL exactly as given (no network).

Try in playground →

post/url-resolver/v1/product_hint1 credit

Identify marketplace + product-id + the ReefAPI engine that can fetch the product.

Parameter		Allowed / range	Description
url	required	—	Any http(s) URL to resolve — short links (bit.ly, amzn.to, t.co), affiliate links, ad redirect URLs, or regular canonical URLs. Only http/https is accepted.
follow = true	optional	—	Follow redirects to the final URL before analysing (default true). false = analyse the URL exactly as given (no network).

Try in playground →

post/url-resolver/v1/preview1 credit

Link unfurl: OpenGraph + Twitter-card title/description/image/favicon (Slack/Discord style).

Parameter		Allowed / range	Description
url	required	—	Any http(s) URL to resolve — short links (bit.ly, amzn.to, t.co), affiliate links, ad redirect URLs, or regular canonical URLs. Only http/https is accepted.
max_hops = 10	optional	1–10	Maximum redirects to follow (1–10).

Try in playground →

post/url-resolver/v1/safety1 credit

Heuristic URL-risk flags (ip-host, non-https, punycode, userinfo, high-abuse TLD, long/multi-shortener chain, cross-domain) + risk level/score.

Parameter		Allowed / range	Description
url	required	—	Any http(s) URL to resolve — short links (bit.ly, amzn.to, t.co), affiliate links, ad redirect URLs, or regular canonical URLs. Only http/https is accepted.
max_hops = 10	optional	1–10	Maximum redirects to follow (1–10).

Try in playground →

post/url-resolver/v1/full1 credit

One call: resolve + normalize + detect_affiliate + product_hint + preview + safety.

Parameter		Allowed / range	Description
url	required	—	Any http(s) URL to resolve — short links (bit.ly, amzn.to, t.co), affiliate links, ad redirect URLs, or regular canonical URLs. Only http/https is accepted.
max_hops = 10	optional	1–10	Maximum redirects to follow (1–10).

Try in playground →

post/url-resolver/v1/batch1 credit

Resolve up to 20 URLs concurrently in one call — each URL is validated and resolved independently.

Parameter		Allowed / range	Description
urls	required	—	List of http(s) URLs to resolve in one call (max 20); each URL is validated and resolved independently.

Try in playground →

Example request · resolve

curl -X POST https://api.reefapi.com/url-resolver/v1/resolve \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"url":"http://github.com"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}