Yardbarker API Documentation

First request

Endpoint

GET /yardbarker/sections

Cost

1 credit/request

curl "https://api.crawlora.net/api/v1/yardbarker/sections" \
  -H "x-api-key: $CRAWLORA_API_KEY"

How to use Yardbarker endpoints

Yardbarker is a sports and entertainment publisher owned by Better Collective, combining in-house reporting with independent sports publishers and editorial/algorithmic curation. A live /yardbarker/sections response on 2026-10-14 contained 589 directory records; refresh it before scheduling because publisher feeds change. Refresh the typed directory before building recurring section jobs: its sport, team, school, and topic slugs are the only values accepted by /headlines. That route accepts a section only, with no page, limit, date, or feed-window input, so treat results as a recent snapshot rather than a pageable archive. Keep homepage top-story cards separate from section RSS summaries, which omit long-form content:encoded. Follow canonical returned story URLs with /article and canonical contributor-profile URLs with /author; retain the original section so syndicated and in-house voices stay attributable. The article route validates canonical Yardbarker story URLs and returns paragraphs available on the public anonymous page; it does not bypass access limits. The author route accepts a canonical profile URL, not a free-text byline search, and returns recent linked stories without biography text or pagination. Headline summaries are not full article bodies, and the directory can change over time. Use the endpoint cards for this integration's accepted inputs.

1. Step 1

   Refresh the typed directory before scheduling

   A live /yardbarker/sections response on 2026-10-14 contained 589 directory records; refresh it before scheduling because publisher feeds change. Refresh the typed directory before building recurring section jobs: its sport, team, school, and topic slugs are the only values accepted by /headlines. That route accepts a section only, with no page, limit, date, or feed-window input, so treat results as a recent snapshot rather than a pageable archive. Keep homepage top-story cards separate from section RSS summaries, which omit long-form content:encoded. Follow canonical returned story URLs with /article and canonical contributor-profile URLs with /author; retain the original section so syndicated and in-house voices stay attributable.

2. Step 2

   Call /headlines with a section only

   Yardbarker says its editors and recommendation algorithms surface work from its newsroom and hundreds of independent sports publishers; Better Collective has owned the company since 2024. Its live-verified directory contains typed sports hubs, team pages, school pages, and topics. Discover current values first and pass only an exact returned slug to /headlines. That route accepts a section only; it has no page, limit, date, or feed-window parameter. /news is a separate homepage snapshot, while section headlines contain short RSS summaries and omit the long content:encoded body. The author route accepts a canonical profile URL—not a free-text byline search—and returns linked recent stories, not biography text or paginated history.

3. Step 3

   Discover sport, team, school and topic slugs

   Yardbarker says its editors and recommendation algorithms surface work from its newsroom and hundreds of independent sports publishers; Better Collective has owned the company since 2024. Its live-verified directory contains typed sports hubs, team pages, school pages, and topics. Discover current values first and pass only an exact returned slug to /headlines. That route accepts a section only; it has no page, limit, date, or feed-window parameter. /news is a separate homepage snapshot, while section headlines contain short RSS summaries and omit the long content:encoded body. The author route accepts a canonical profile URL—not a free-text byline search—and returns linked recent stories, not biography text or paginated history. Pass only a value returned by /yardbarker/sections and accepted by /yardbarker/headlines; preserve the selected desk with its results.

4. Step 4

   Validate canonical Yardbarker story URLs

   The article route validates canonical Yardbarker story URLs and returns paragraphs available on the public anonymous page; it does not bypass access limits. The author route accepts a canonical profile URL, not a free-text byline search, and returns recent linked stories without biography text or pagination. Headline summaries are not full article bodies, and the directory can change over time. Keep teaser, truncation, premium, or access fields beside the canonical URL so downstream users can see what the publisher actually returned.

5. Step 5

   Use canonical profile URLs

   Refresh the typed directory before building recurring section jobs: its sport, team, school, and topic slugs are the only values accepted by /headlines. That route accepts a section only, with no page, limit, date, or feed-window input, so treat results as a recent snapshot rather than a pageable archive. Keep homepage top-story cards separate from section RSS summaries, which omit long-form content:encoded. Follow canonical returned story URLs with /article and canonical contributor-profile URLs with /author; retain the original section so syndicated and in-house voices stay attributable. The article route validates canonical Yardbarker story URLs and returns paragraphs available on the public anonymous page; it does not bypass access limits. The author route accepts a canonical profile URL, not a free-text byline search, and returns recent linked stories without biography text or pagination. Headline summaries are not full article bodies, and the directory can change over time.

Other Media & Streaming APIs