The Motley Fool API Documentation

First request

Endpoint

GET /motleyfool/sections

Cost

1 credit/request

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

How to use The Motley Fool endpoints

The Motley Fool is The Motley Fool's investing newsroom, separated from its research, statistics, and investor-education products. A live /motleyfool/sections response on 2026-10-14 contained 10 section records; refresh it before scheduling because publisher feeds change. Use the closed newsroom section values returned by discovery to filter headlines, and keep research/statistics and education pages outside that enum. Open a canonical news story URL for the public article response and use the author URL to inspect a writer's profile/archive rather than searching arbitrary bylines. The newsroom taxonomy intentionally excludes the separate research and seven education pages. Article body availability is bounded by what the public page returns; no paywall bypass or inference of subscriber text is supported. Use the endpoint cards for this integration's accepted inputs.

1. Step 1

   Use the closed newsroom section values

   A live /motleyfool/sections response on 2026-10-14 contained 10 section records; refresh it before scheduling because publisher feeds change. Use the closed newsroom section values returned by discovery to filter headlines, and keep research/statistics and education pages outside that enum. Open a canonical news story URL for the public article response and use the author URL to inspect a writer's profile/archive rather than searching arbitrary bylines.

2. Step 2

   Keep research and education pages outside the enum

   Keep news, investing education, and paid research products distinct. The exposed section taxonomy belongs to news content; do not route a research-service or stock-analysis URL through a news article endpoint unless it matches the documented article form.

3. Step 3

   Filter headlines with discovered values only

   Keep news, investing education, and paid research products distinct. The exposed section taxonomy belongs to news content; do not route a research-service or stock-analysis URL through a news article endpoint unless it matches the documented article form. Pass only a value returned by /motleyfool/sections and accepted by /motleyfool/headlines; preserve the selected desk with its results.

4. Step 4

   Open canonical news story URLs

   The newsroom taxonomy intentionally excludes the separate research and seven education pages. Article body availability is bounded by what the public page returns; no paywall bypass or inference of subscriber text is supported. Keep teaser, truncation, premium, or access fields beside the canonical URL so downstream users can see what the publisher actually returned.

5. Step 5

   Look up contributors by profile

   Use the closed newsroom section values returned by discovery to filter headlines, and keep research/statistics and education pages outside that enum. Open a canonical news story URL for the public article response and use the author URL to inspect a writer's profile/archive rather than searching arbitrary bylines. The newsroom taxonomy intentionally excludes the separate research and seven education pages. Article body availability is bounded by what the public page returns; no paywall bypass or inference of subscriber text is supported.

Other Media & Streaming APIs