/content/item/<item-id>
This endpoint provides a representation of an individual item of guardian.co.uk content. Content can be returned in either XML or JSON.
The representation of individual items of content is identical between the search endpoint and this endpoint. The search endpoint returns a collection
of content items.
All content can be tagged and the tags associated with a piece of content can be found in the tagged-with block.
All content has a standard set of fields, such as title, standfirst, link text etc. Certain types of content contain fields specific to that content type,
for example only an article has a body. If present, these type specific fields can be found in the type-specific block.
Parameters
| format |
Specifies what format to return results in, the supported values are: xml and json. If this is not specified results are returned in xml format. |
| callback |
Specifies a javascript function to be invoked with the results from a query from the JSON API |
Examples
Response structure
Common fields
This block is standard for all content types and contains the following elements. The contents of elements are generally optional and filled in by editors
- type - The content type of the item. See content types list below
- web-url - The URL of the item on guardian.co.uk
- api-url - The URL of the item in the API
- publication - The publication that the content originated in. See publications list below
- headline - The headline of the content item. All content items will have a headline.
- standfirst - An optional one paragraph introduction to the content
- byline - The byline of the contributor(s) of the content. Optional field
- section-name - The section of guardian.co.uk that contains the content.
- trail-text - A paragraph of text promoting the content.
- link-text - Suggested text to place on links to the content
- trail-image - A small image that can be used to promote the content
- publication-date - The date that the content was published on the web. Format: YYYY-MM-DDTHH:MM:SS.
tagged-with block
Contains a collection of the tags that our editors have associated with this content item.
The tag item structure is identical to that returned by the tags endpoint.
type-specific block: article
- body - The body of the article
type-specific block: video
- duration-minutes - The minutes element of the video duration
- duration-seconds - The seconds element of the video duration
type-specific block: audio
- duration-minutes - The minutes element of the audio duration
- duration-seconds - The seconds element of the audio duration
type-specific block: gallery
- picture-count - The number of pictures that can be found in this gallery when viewed on guardian.co.uk
List of publications
The publication attribute of the content item tells which of the GNM publications the piece of content was
originally published in
- guardian.co.uk - The guardian.co.uk website
- The Guardian - The Guardian newspaper
- The Observer - The Observer newspaper
- Guardian Weekly - Guardian Weekly paper publication
- Observer Food Monthly - Observer Food Monthly paper supplement
- Observer Music Monthly - Observer Music Monthly paper supplement
- MediaGuardian - Media Guardian paper supplement
- Society Guardian - Society Guardian paper supplement
Content types
- Article - Textual content from guardian.co.uk. Includes all blogs and site sections.
- Video - Video pages
- Audio - Audio pages / podcasts
- Galleries - Gallery pages containing collections of related images
- Interactive - Interactive pages containing Flash or javascript data based interactive content