Services

What services are available in the Content API?

Services are the main channels of content available from PA, with each broken down further by two or more sub-services.

The top level services are:

Name	Code	Create	Ready	Now
News	paservice:news	✓	✓	✓
Sport	paservice:sport	✓	✓	✓
Entertainment	paservice:entertainment	✓	✓	✓
Finance	paservice:finance	✓	✓	✓
Sci-Tech	paservice:sci-tech	✓	✓	X
Lifestyle	paservice:lifestyle	✓	✓	X
Uplifting	paservice:viral	✓	✓	X
Real Life	paservice:real-life	✓	✓	X
Motoring	paservice:motoring	✓	✓	X

News sub-services

Name	Code	Create	Ready	Now
News: UK	paservice:news:uk	✓	✓	✓
News: Scotland	paservice:news:scotland	✓	✓	✓
News: Wales	paservice:news:wales	✓	✓	✓
News: Northern Ireland	paservice:news:northern-ireland	✓	✓	✓
News: Republic of Ireland	paservice:news:ireland	✓	✓	✓
News: World	paservice:news:world	✓	✓	✓

Sport sub-services

Name	Code	Create	Ready	Now
Sport: UK	paservice:sport:uk	✓	✓	✓
Sport: Football	paservice:sport:football	✓	✓	✓
Sport: Racing	paservice:sport:racing	✓	✓	✓
Sport: Match Reports	paservice:sport:match-reports	✓	✓	✓
Sport: Club News	paservice:sport:club-news	✓	✓	✓
Sport: World	paservice:sport:world	✓	✓	✓

Entertainment sub-services

Name	Code	Create	Ready	Now
Entertainment: UK	paservice:entertainment:uk	✓	✓	✓
Entertainment: TV	paservice:entertainment:tv	✓	✓	✓
Entertainment: Soaps	paservice:entertainment:soaps	✓	✓	✓
Entertainment: Movies	paservice:entertainment:movies	✓	✓	✓
Entertainment: Music	paservice:entertainment:music	✓	✓	✓
Entertainment: World	paservice:entertainment:world	✓	✓	✓

Finance sub-services

Name	Code	Create	Ready	Now
Finance: City	paservice:finance:city	✓	✓	✓
Finance: Personal Finance	paservice:finance:personal-finance	✓	✓	✓
Finance: World	paservice:finance:world	✓	✓	✓

Sci-Tech subservices

Name	Code	Create	Ready	Now
Sci-Tech: Science	paservice:sci-tech:science	✓	✓	X
Sci-Tech: Technology	paservice:sci-tech:technology	✓	✓	X

Lifestyle subservices

Name	Code	Create	Ready	Now
Lifestyle: Fashion & Beauty	paservice:lifestyle:fashion-beauty	✓	✓	X
Lifestyle: Food & Drink	paservice:lifestyle:food-drink	✓	✓	X
Lifestyle: Health & Wellbeing	paservice:lifestyle:health-wellbeing	✓	✓	X
Lifestyle: Life	paservice:lifestyle:life	✓	✓	X
Lifestyle: Travel	paservice:lifestyle:travel	✓	✓	X
Lifestyle: TV	paservice:lifestyle:tv	✓	X	X
Lifestyle: Film	paservice:lifestyle:film	✓	X	X
Lifestyle: Music	paservice:lifestyle:music	✓	X	X

Uplifting subservices

Name	Code	Create	Ready	Now
Uplifting: News	paservice:viral:news	✓	✓	X
Uplifting: Sport	paservice:viral:sport	✓	✓	X
Uplifting: Animals	paservice:viral:animals	✓	✓	X

Note: This used to be called viral and the code is a hangover.

Real Life subservices

Name	Code	Create	Ready	Now
Real Life: Body Image	paservice:real-life:body-image	✓	✓	X
Real Life: Crime	paservice:real-life:crime	✓	✓	X
Real Life: Family	paservice:real-life:family	✓	✓	X
Real Life: Health	paservice:real-life:health	✓	✓	X
Real Life: Love & Relationships	paservice:real-life:love-relationships	✓	✓	X
Real Life: Parenting	paservice:real-life:parenting	✓	✓	X
Real Life: Quirky	paservice:real-life:quirky	✓	✓	X
Real Life: Seasonal	paservice:real-life:seasonal	✓	✓	X
Real Life: Sex	paservice:real-life:sex	✓	✓	X
Real Life: Shocks	paservice:real-life:shocks	✓	✓	X

Motoring subservices

Name	Code	Create	Ready	Now
Motoring: Features	paservice:motoring:features	✓	✓	X
Motoring: News	paservice:motoring:news	✓	✓	X
Motoring: Road Tests	paservice:motoring:road-tests	✓	✓	X

Extra services

These services are in addition to other services (usually news) and add extra filtering or categorisation.

Name	Code	Create	Ready	Now
Energy & Environment	paservice:energy-environment	✓	X	X
Energy & Environment: Climate	paservice:energy-environment:climate	✓	X	X
Energy & Environment: Conservation	paservice:energy-environment:conservation	✓	X	X
Energy & Environment: Energy	paservice:energy-environment:energy	✓	X	X
Energy & Environment: Farming	paservice:energy-environment:farming	✓	X	X
Energy & Environment: Green Living	paservice:energy-environment:green-living	✓	X	X
Energy & Environment: Heritage	paservice:energy-environment:heritage	✓	X	X
Energy & Environment: Renewables	paservice:energy-environment:renewables	✓	X	X
Energy & Environment: Sustainability	paservice:energy-environment:sustainability	✓	X	X
Health	paservice:health	✓	X	X
Health: Pharma	paservice:health:pharma	✓	X	X
Health: NHS	paservice:health:nhs	✓	X	X
Health: Social Care	paservice:health:social-care	✓	X	X
Health: Research	paservice:health:research	✓	X	X
Health: Wellbeing	paservice:health:wellbeing	✓	X	X
Health: Mental Health	paservice:health:mental-health	✓	X	X
Law	paservice:law	✓	X	X
Politics	paservice:politics	✓	X	X
Politics: Business & Economy	paservice:politics:business-economy	✓	X	X
Politics: Culture	paservice:politics:culture	✓	X	X
Politics: Defence	paservice:politics:defence	✓	X	X
Politics: Education	paservice:politics:education	✓	X	X
Politics: Environment	paservice:politics:environment	✓	X	X
Politics: Trade	paservice:politics:trade	✓	X	X
Politics: Foreign Affairs	paservice:politics:foreign-affairs	✓	X	X
Politics: Health	paservice:politics:health	✓	X	X
Politics: Home Affairs	paservice:politics:home-affairs	✓	X	X
Politics: Housing	paservice:politics:housing	✓	X	X
Politics: Transport	paservice:politics:transport	✓	X	X
Royal	paservice:royal	✓	X	X
ESG	paservice:esg	✓	X	X
ESG: Environmental	paservice:esg:environmental	✓	X	X
ESG: Social	paservice:esg:social	✓	X	X
ESG: Governance	paservice:esg:governance	✓	X

To see these extra services in action please see the mega menu in Explore Create:

Why can I only see a small number of services?

Content API is built around an entitlement model which basically means when we provision your API key we activate certain services against it (e.g. the News or Sport services). When you make a request to the Service Collection endpoint you will only ever see the services or sub-services you're entitled to access.

If you'd like to expand these services please contact the PA Commercial team on 020 7963 7624.

How do I see just the parent services (e.g. News, Sport, Motoring, Real Life)?

To return just the parent or top-level services you can utilise the query functionality. You can request that all services are returned that do not have subject properties with a profile of paservice.

Making the following request will list all available (and entitled) parent services:

curl \
  -H "Accept: application/json" \
  -H "apikey: <API KEY>" \
  https://content.api.pressassociation.io/v1/service?query=!subject.profile:"paservice"

How do I see what sub-services exist for a service?

A service can have several sub-services, for example the service "Sport" has several sub-services including: Football, Tennis and F1.

Making the following request will list all available (and entitled) sub-services for a service:

curl \
  -H "Accept: application/json" \
  -H "apikey: <API KEY>" \
  https://content.api.pressassociation.io/v1/service?parentSubject=paservice:sport

How I paginate through services?

Please refer to the Pagination section of this documentation.

How do I get return Atom or RSS?

Please refer to the Content Negotiation section of this documentation.

How do I get items for a service?

There are two methods of retrieving items for a service.

The first (and more verbose) way is to query the /item endpoint by providing a subject parameter, for example:

curl \
  -H "Accept: application/json" \
  -H "apikey: <API KEY>" \
  https://content.api.pressassociation.io/v1/item?subject=paservice:sport

The alternative, shortcut version is to simply call the item endpoint of the service resource, for example:

curl \
  -H "Accept: application/json" \
  -H "apikey: <API KEY>" \
  https://content.api.pressassociation.io/v1/service/paservice:sport/item

How do I use partial response to customise the JSON fields that are returned?

Please refer to the Partial Response section of this documentation.

Article metadata

Articles in each service carry a range of metadata to identify the subject matter and, where appropriate, type of story, geographical territory, plus additional categories for sport content.