Punch API endpoint
Returns a Punch author's name and their most recent articles (the first archive page, about 30) from a canonical `url` (`https://punchng.com/author/<slug>/`). `total_pages` is the number of archive pages. Punch author pages have no biography, photo or social links, so none are returned. An unknown author returns not-found.
/punch/authorQuery parameters:
url (required): a canonical https://punchng.com/author/<slug>/ URL. Punch author slugs are usually the writer's newsroom login, for example tbankolepunchng-com.Punch author pages carry no biography, photo, or social links, so none are returned. total_pages is the number of archive pages the author has. Each article's published_at is RFC 3339 UTC. An unknown author returns not-found.
Example response (truncated):
{"code":200,"data":{"url":"https://punchng.com/author/tbankolepunchng-com/","name":"Taiwo Bankole","total_pages":90,"articles":[{"title":"2027: Adebutu decries neglect of Ogun border communities, promises action","url":"https://punchng.com/2027-adebutu-decries-neglect-of-ogun-border-communities-promises-action","summary":"PDP governorship candidate, Oladipupo Adebutu, has lamented the neglect of Ogun communities...","published_at":"2026-09-24T20:22:00Z"}]}}
| Field | Filled in, of 31 checked | Values in the sample |
|---|---|---|
| title | 31 | median 59 characters |
| url | 31 | punchng.com |
| summary | 31 | median 157 characters |
| published_at | 31 | 2026-10-04 to 2026-10-12 |
| image_url | 31 | cdn.punchng.com and 1 other host |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Canonical Punch author URL | https://punchng.com/author/example-author/ | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/punch/author?url=https%3A%2F%2Fpunchng.com%2Fauthor%2Fexample-author%2F" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"url": "https://punchng.com/author/tbankolepunchng-com/",
"name": "Taiwo Bankole",
"total_pages": 90,
"articles": [
{
"title": "2027: Adebutu decries neglect of Ogun border communities, promises action",
"url": "https://punchng.com/2027-adebutu-decries-neglect-of-ogun-border-communities-promises-action",
"summary": "PDP governorship candidate, Oladipupo Adebutu, has lamented the neglect of Ogun communities...",
"published_at": "2026-09-24T20:22:00Z"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.punchAuthorResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | punch.AuthorResponse | No | ||||
| data.articles | array | No | HeadlineItem record, 7 fields: author, image_url, published_at, summary, title, type, url. Described under Punch top stories API. | |||
| data.name | string | No | ||||
| data.total_pages | integer | No | ||||
| data.url | string | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/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/punch/author?url=https%3A%2F%2Fpunchng.com%2Fauthor%2Fexample-author%2F" \
-H "x-api-key: $CRAWLORA_API_KEY"