BBC API endpoint
Returns a BBC News correspondent's profile from `url`, a canonical `bbc.co.uk/news/correspondents/<slug>` address: name, short `bio` and recent articles with title, URL, section and publication date when the page shows one. `published_at` is `YYYY-MM-DD` when the page gives a full date; items labelled only with a relative time, such as `2 days ago`, come back as written.
/bbc/authorQuery parameter: url is a canonical HTTPS bbc.co.uk/news/correspondents/<slug> URL. Returns the correspondent's name, a short biography, and their recent articles (title, URL, section, and publication date when the page exposes it).
published_at is normalized to YYYY-MM-DD when the page's own full date text can be parsed; very recent articles that the page only labels with a relative time (e.g. "2 days ago") are returned as-is.
| Field | Filled in, of 24 checked | Values in the sample |
|---|---|---|
| title | 24 | |
| url | 24 | bbc.co.uk |
| section | 24 | |
| published_at | 24 | 2013-05-22 to 2022-03-25 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Canonical BBC News correspondent URL | https://www.bbc.co.uk/news/correspondents/jonnydymond | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/bbc/author?url=https%3A%2F%2Fwww.bbc.co.uk%2Fnews%2Fcorrespondents%2Fjonnydymond" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"url": "https://www.bbc.co.uk/news/correspondents/jonnydymond",
"name": "Jonny Dymond",
"bio": "Jonny is the BBC's royal correspondent. He was previously a correspondent in Washington, Brussels and Istanbul.",
"articles": [
{
"title": "The PR missteps that overshadowed a royal tour",
"url": "https://www.bbc.co.uk/news/uk-60870417",
"section": "UK",
"published_at": "2022-03-25"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/bbc.authorResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | bbc.AuthorResponse | No | ||||
| data.articles | array | No | ||||
| data.articles[].published_at | string | No | ||||
| data.articles[].section | string | No | ||||
| data.articles[].title | string | No | ||||
| data.articles[].url | string | No | ||||
| data.bio | string | No | ||||
| data.name | string | No | ||||
| data.url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/bbc/author?url=https%3A%2F%2Fwww.bbc.co.uk%2Fnews%2Fcorrespondents%2Fjonnydymond" \
-H "x-api-key: $CRAWLORA_API_KEY"