docs / agent-source

Source Verification API

base /agent-source/v16 endpoints

post/agent-source/v1/source_url1 credit

Inspect a public URL for source-reliability: reachability, canonical + full redirect chain, title/publisher/published+updated dates, language, official-likelihood, and a stale/archived (wayback) signal.

Parameter		Allowed / range	Description
url	required	—	Public source URL to inspect (scheme optional — https:// is added). Private/loopback/metadata hosts are rejected.
check_archive = true	optional	—	Query the Wayback Machine for the latest snapshot (stale/archived signal). Default true.
official_for	optional	—	If set, also score whether the final URL is OFFICIAL for this curated provider (domain match).

Try in playground →

post/agent-source/v1/official_source2 credits

Resolve the OFFICIAL URL a curated provider publishes for a given need (pricing/docs/changelog/status/legal/model_card) + why it is official (domain match + domain age via whois). Curated whitelist only.

Parameter		Allowed / range	Description
entity	required	—	Provider/entity name (free text accepted: 'OpenAI', 'claude', 'gemini', 'grok'). Resolved against the curated whitelist — see the `providers` action for the supported set.
need_type = docs	optional	pricing · docs · changelog · status · legal · model_card	Which official resource you need. Default 'docs'. Use 'all' to return every known official URL for the entity.
verify = false	optional	—	Also live-check the official URL is reachable (adds a url-resolver inner-call + latency).

Try in playground →

post/agent-source/v1/verify_claim3 credits

Check whether one or more public source URLs support a factual claim — returns supported, contradicted, not_found, or unclear, along with the matching evidence snippet and a confidence level. Uses exact quote and number matching against the live page content. A source-evidence checker, not a general truth oracle.

Parameter		Allowed / range	Description
claim	required	—	The factual claim to check against the source(s). Keep it specific (a number/quote verifies best).
url	required	—	Public source URL to inspect (scheme optional — https:// is added). Private/loopback/metadata hosts are rejected.
urls	optional	—	Up to 5 source URLs (array or comma-list). Combined with `url`; the best-supporting verdict wins.

Try in playground →

post/agent-source/v1/pricing_lookup1 credit

Current developer/LLM pricing for a curated provider, parsed live from the provider's own pricing page/API. Each row: model, input/output per-1M-token USD, source_url, last_seen_at, unit, currency, normalization_notes.

Parameter		Allowed / range	Description
provider	required	openai · anthropic · gemini · xai · openrouter · aws · gcp · azure	Curated provider key (or any alias). Structured pricing is available for: openai, anthropic, gemini, xai, openrouter. aws/gcp/azure return official_source but no structured pricing (compute-SKU pages — see normalization_notes).
model	optional	—	Optional model-name filter (substring, case-insensitive), e.g. 'gpt-4o', 'opus', 'gemini-2.5-flash', 'grok-4'.
limit = 40	optional	1–60	Max model rows to return.

Try in playground →

post/agent-source/v1/pricing_compare3 credits

Compare current pricing across several curated providers (optionally filtered to a model substring) → normalized per-1M-token USD, cheapest-first, each traceable to its source_url + last_seen_at.

Parameter		Allowed / range	Description
providers	required	—	Up to 6 curated providers (array or comma-list) from: openai, anthropic, gemini, xai, openrouter.
model	optional	—	Optional model-name filter (substring, case-insensitive), e.g. 'gpt-4o', 'opus', 'gemini-2.5-flash', 'grok-4'.

Try in playground →

post/agent-source/v1/providersfree

List the curated provider whitelist + each provider's capabilities (which need_types and structured pricing are supported) and parse-surface metadata. The honest denominator for official_source / pricing.

Parameter		Allowed / range	Description
provider	optional	—	Optional: return only this provider's detail.

Try in playground →

Example request · source_url

curl -X POST https://api.reefapi.com/agent-source/v1/source_url \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"url":"https://openai.com/api/pricing/","official_for":"openai"}'

Response shape

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