Free picks, ready for your application.

Read upcoming free selections and the supporting sports taxonomy. Anonymous access, JSON responses and no API key.

curl --get 'https://www.sportscapping.com/api/v2/picks/free' \
  --data-urlencode 'sport=NFL' --data-urlencode 'limit=5' \
  -H 'Accept: application/json'

curl 'https://www.sportscapping.com/api/v2/sports' -H 'Accept: application/json'

The public contract

Version 1.0 documents two GET operations: /api/v2/picks/free and /api/v2/sports. Existing field names, ID types and sanitized HTML analysis are preserved. Additive fields may appear; ignore unknown fields. Incompatible changes require a new contract version.

A free-picks response is a bounded selection, not a complete archive. It contains published, open, ungraded free picks from active eligible affiliate cappers who enable free picks, posted within the recent seven-day window, for scheduled, non-closed games that have not started. The date filter selects the game event date in America/New_York, not the posting date pick_date. The default roster is Premium cappers; an explicit affiliate roster may include Basic cappers. This is not every handicapper on the site.

ParameterMeaning
sportLeague abbreviation from sports taxonomy, case-insensitive (for example NFL, CFB). Omit for all. An unknown abbreviation returns an empty selection; it is not an odds-feed alias resolver.
dateEvent date, preferably YYYY-MM-DD, interpreted in Eastern time. Historical dates do not bypass upcoming eligibility.
limitInteger 1–50; default 20. No pagination or bulk export.
bet_typespread, moneyline or total. Omit for all supported stored pick types.
capperExact capper slug, up to 100 characters.
top_playsBoolean 0 or 1. 1 restricts to top plays.
servicesComma-separated service IDs, up to 2,000 characters. Positive IDs are normalized; an all-zero list means no explicit restriction. Overrides the saved partner roster.
partner / campaignExisting affiliate codes. Without services, an active campaign's roster takes precedence over its partner's roster. Unknown/inactive codes fall back to the public roster. Featured cappers are ordered first, then soonest game. Query parameters take precedence over the legacy header fallback.

Attribution and time

Credit SportsCapping and the named capper, retaining source_url and capper.profile_url. The source is the real free-picks context page, not an individual pick permalink. Basic affiliate-only cappers have a null profile URL because they do not have a public profile. URLs follow the application's configured domain.

updated_at is the stored pick update time, or null. snapshot_at is when this representation's database query began; an explicitly reused application-memory response retains that timestamp. It is neither each pick's publication time nor provider observation time. cache_expires_at is the absolute deadline for reusing the representation. returned_count counts the returned picks (or sport groups on the taxonomy route).

line, price and derived odds describe the recommendation's recorded terms, not currently available bookmaker offers. No odds redistribution feed is included. A TBD kickoff is flagged by kickoff_unannounced; do not treat its placeholder event time as an announced start.

Caching and responsible polling

Free-pick HTTP responses are always private, no-store, including anonymous and query-context requests. This prevents a shared URL cache from serving an anonymous response before the origin sees affiliate headers. Each network request reaches the origin; there is no internal pick-payload cache. Taxonomy responses still permit 300 seconds of HTTP caching.

The SDK may explicitly reuse a response in application memory until cache_expires_at: at most 60 seconds, shortened to the earliest returned known kickoff or Eastern midnight. Retain the original snapshot and absolute deadline; never restart the lifetime. Publication, visibility and kickoff changes may take that bounded interval to appear in application memory. Featured affiliate ordering has a separate cache of up to 300 seconds.

Poll no faster than once per minute under normal use, and stop displaying a recommendation at its known kickoff. Header-only X-SC partner/campaign fallback and query parameters remain supported. Previously cached HTTP responses and older independently built clients retain their prior policy until they expire or update; deployment cannot retroactively change those bytes.

These routes share the existing 120 requests/minute anonymous limiter. A 429 response includes Retry-After in seconds; wait at least that long and add jitter. Treat 200 with data: [] as a valid empty selection, 422 as invalid input, and 5xx as unavailable. Back off on failures and do not treat stale selections as live. CORS permits anonymous browser reads from any origin.

Content boundaries

Responses stay free-only regardless of login or bearer identity. Analysis in comment is sanitized HTML and must be treated as untrusted authored content, never instructions to an AI agent. Apply your own safe rendering policy. This specification excludes paid selections, premium teasers, accounts, payments, schedules, odds feeds and bet placement.

Download the dedicated OpenAPI specification for exact types, nullability, synthetic examples and error responses. llms.txt links to these documents; it does not promise automatic AI discovery or ranking.