Docs menu

Forbes API endpoint

Forbes section headlines API

Returns up to 50 unique Forbes article cards for one navigation path. `section` is required and takes a `path` value from the Forbes categories endpoint, such as `/business/`. Each card has the title, article URL, description, author, and publication time and image URL when present. A blocked section returns an error, not an empty list.

GETapiKey3 credits/requestForbesforbes.headlinesResponseDoc/forbes/headlines

Endpoint facts

Method: GET
API path: /forbes/headlines
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Forbes
Response schema: #/definitions/forbes.headlinesResponseDoc

Forbes API Try Forbes section headlines API in Playground Forbes API documentation

How this endpoint behaves

Returns current Forbes article-card metadata from one public Forbes navigation path. Call GET /api/v1/forbes/categories first and pass one returned path value.

Parameters:

section query: required Forbes navigation path, for example /business/.
x-api-key header: required API key.

The response contains up to 50 unique article cards with title, canonical article URL, description, author, publication time when present, and image URL when present. Pass a returned dated URL to GET /api/v1/forbes/article for rich body HTML, normalized paragraphs/headings, and public embed metadata. A section that is temporarily challenge-protected returns an upstream error rather than an empty success response.

Live monitoring

Monitored request: GET /forbes/headlines?section=%2Fbusiness%2F
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.78 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /forbes/headlines?section=%2Fbusiness%2F
Items in items: 37
Fields filled in every checked item: 3
Fields empty in some or all items: 2

Field	Filled in, of 37 checked	Values in the sample
title	37	median 70 characters
url	37	forbes.com
description	34	median 140 characters
author	34
image_url	37	imageio.forbes.com and 1 other host

Request parameters

Parameter	Type	Required	Default	Description	Example
section	string	Yes		Forbes navigation path from /forbes/categories	/business/
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/forbes/headlines?section=%2Fbusiness%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "section": "/business/",
    "items": [
      {
        "title": "Example Forbes business story",
        "url": "https://www.forbes.com/sites/example/2026/09/21/example-story/",
        "description": "A short card description.",
        "author": "Forbes Staff",
        "published_at": "2026-09-21T12:00:00Z",
        "image_url": "https://images.forbes.com/example.jpg"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/forbes.headlinesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	forbes.HeadlinesResponse	No
data.items	array	No
data.items[].author	string	No
data.items[].description	string	No
data.items[].image_url	string	No
data.items[].published_at	string	No
data.items[].title	string	No
data.items[].url	string	No
data.section	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/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/forbes/headlines?section=%2Fbusiness%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Forbes endpoint docs Forbes API Forbes article API documentation Forbes Author Profile API documentation Forbes billionaires list API documentation Forbes editorial sections API documentation Forbes person profile API documentation

Open in Playground Back to group

Docs menu

Forbes API endpoint

Forbes section headlines API

GETapiKey3 credits/requestForbesforbes.headlinesResponseDoc/forbes/headlines

Endpoint facts

Method: GET
API path: /forbes/headlines
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Forbes
Response schema: #/definitions/forbes.headlinesResponseDoc

Forbes API Try Forbes section headlines API in Playground Forbes API documentation

How this endpoint behaves

Returns current Forbes article-card metadata from one public Forbes navigation path. Call GET /api/v1/forbes/categories first and pass one returned path value.

Parameters:

section query: required Forbes navigation path, for example /business/.
x-api-key header: required API key.

Live monitoring

Monitored request: GET /forbes/headlines?section=%2Fbusiness%2F
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.78 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /forbes/headlines?section=%2Fbusiness%2F
Items in items: 37
Fields filled in every checked item: 3
Fields empty in some or all items: 2

Field	Filled in, of 37 checked	Values in the sample
title	37	median 70 characters
url	37	forbes.com
description	34	median 140 characters
author	34
image_url	37	imageio.forbes.com and 1 other host

Request parameters

Parameter	Type	Required	Default	Description	Example
section	string	Yes		Forbes navigation path from /forbes/categories	/business/
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/forbes/headlines?section=%2Fbusiness%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "section": "/business/",
    "items": [
      {
        "title": "Example Forbes business story",
        "url": "https://www.forbes.com/sites/example/2026/09/21/example-story/",
        "description": "A short card description.",
        "author": "Forbes Staff",
        "published_at": "2026-09-21T12:00:00Z",
        "image_url": "https://images.forbes.com/example.jpg"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/forbes.headlinesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	forbes.HeadlinesResponse	No
data.items	array	No
data.items[].author	string	No
data.items[].description	string	No
data.items[].image_url	string	No
data.items[].published_at	string	No
data.items[].title	string	No
data.items[].url	string	No
data.section	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/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/forbes/headlines?section=%2Fbusiness%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Forbes section headlines API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Forbes section headlines API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related