---
title: "Get Punch section headlines"
method: GET
path: "/punch/headlines"
tags: ["Punch"]
---

# Get Punch section headlines

`GET /punch/headlines`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/punch/headlines`
- Auth: API key in header `x-api-key`

Returns the current stories, about 30, from one Punch topic page. `section` is required and takes a topic slug such as `news`, `politics`, `business`, `sports`, `metro-plus` or `top-stories`; any other value is an invalid-parameter error. Each item has a title and article URL, plus summary, publication time and image URL when the page shows them.

## Query parameters

- `section` 'business' | 'columns' | 'continuation-from-print' | 'diaspora' | 'editorial' | 'education' | 'entertainment' | 'feature' | 'featured' | 'foreign-news' | 'health' | 'healthwise' | 'information-technology' | 'interactive' | 'interview' | 'latest-news' | 'law-digest-2' | 'letters' | 'metro-plus' | 'news' | 'opinion' | 'osun-decides' | 'panorama' | 'politics' | 'punch-lite' | 'sex-relationship' | 'smart-tips' | 'society' | 'special-features' | 'spice' | 'sponsored' | 'sports' | 'technology' | 'top-stories' | 'video' | 'weekend-starter', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PublicnewsHeadlinesResponseDoc
  - `data` NewsplatformHeadlinesResponse
    - `items` NewsplatformHeadlineItem[]
      - `author` string
      - `image_url` string
      - `published_at` string
      - `summary` string
      - `title` string
      - `type` string
      - `url` string
    - `section` string

## Other responses

- `400`: Bad Request
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)