Docs menu
Investopedia API endpoint
Investopedia section headlines API
Returns the current story list from one Investopedia section, with title, URL, byline, and image. section accepts any slug returned by GET /investopedia/sections.
GETapiKey1 credit/requestInvestopediapublicnews.headlinesResponseDoc
Investopedia/investopedia/headlinesEndpoint facts
- Method
- GET
- API path
- /investopedia/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Investopedia
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of the slugs returned
by investopedia-sections: news,
markets-news, company-news, earnings-reports,
certificates-deposit-news, mortgage-rates, economic-news,
political-news, cryptocurrency-news, live-markets-news,
personal-finance-news, investing, stocks, cryptocurrency, bonds,
etfs, options-and-derivatives-trading, commodities, trading,
financial-technology-and-automated-investing, brokers,
fundamental-analysis, banking, savings-accounts,
certificate-of-deposits, money-market-account, checking-accounts,
personal-finance, retirement-planning, student-loans, personal-loans,
budgeting-and-savings, mortgage, credit-and-debt, taxes, insurance,
financial-literacy-resource-center, economy, government-and-policy,
monetary-policy, fiscal-policy, economics, or
financial-product-reviews. Matching is case-insensitive; any other value
returns 400 without contacting Investopedia.
Returns the section's current story list (typically 17-73 items). News
sections are newest-first; education sections (for example stocks or
taxes) list evergreen guides, explainers, and dictionary terms, whose URLs
can be passed to investopedia-article.
Sampled response
- Request, 14 Oct 2026
- GET /investopedia/headlines?section=markets-news
- Items in items
- 65
- Fields filled in every checked item
- 4
| Field | Filled in, of 65 checked | Values in the sample |
|---|---|---|
| title | 65 | median 73 characters |
| url | 65 | investopedia.com |
| author | 65 | |
| image_url | 65 | investopedia.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | Investopedia section slug, from GET /investopedia/sections Allowed values: news, markets-news, company-news, earnings-reports, certificates-deposit-news, mortgage-rates, economic-news, political-news, cryptocurrency-news, live-markets-news, personal-finance-news, investing, stocks, cryptocurrency, bonds, etfs, options-and-derivatives-trading, commodities, trading, financial-technology-and-automated-investing, brokers, fundamental-analysis, banking, savings-accounts, certificate-of-deposits, money-market-account, checking-accounts, personal-finance, retirement-planning, student-loans, personal-loans, budgeting-and-savings, mortgage, credit-and-debt, taxes, insurance, financial-literacy-resource-center, economy, government-and-policy, monetary-policy, fiscal-policy, economics, financial-product-reviews. | news | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/investopedia/headlines?section=news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"section": "markets-news",
"items": [
{
"title": "Example Markets Headline",
"url": "https://www.investopedia.com/example-markets-headline-12345678",
"author": "Example Writer",
"image_url": "https://www.investopedia.com/thmb/example.jpg"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.HeadlinesResponse | No | ||||
| data.items | array | No | HeadlineItem record, 7 fields: author, image_url, published_at, summary, title, type, url. Described under Investopedia latest news API. | |||
| data.section | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/investopedia/headlines?section=news" \
-H "x-api-key: $CRAWLORA_API_KEY"