Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. By signing up you are subscribing to the APIs.io and API Evangelist
newsletters — you can unsubscribe from any issue. See our
Privacy Policy and Terms.
openapi: 3.2.0
info:
title: Media Frame data Pieces API
version: 1.0.0
summary: Tracks how policy ideas move from research institutions (think tanks) into the official record and enforcement, and how each source frames them over time.
description: 'Premium plan. Everything on the Media Frame board as JSON, refreshed every pipeline run: derived metrics, headlines, source links and redline fragments — never full article text. Create a key at https://mediaframe.me/auth/account. See /llms.txt for what is measured and its reliability.'
servers:
- url: https://mediaframe.me
security:
- apiKey: []
tags:
- name: Pieces
paths:
/v1/pieces:
get:
operationId: getPieces
summary: 'Every analysed piece: source, headline, URL, date, themes and frame vector'
parameters:
- name: locale
in: query
required: false
schema:
type: string
enum:
- en
- br
default: en
description: 'Which board: en (mediaframe.me) or br (br.mediaframe.me).'
- name: edition
in: query
required: false
schema:
type: string
enum:
- EU
- UK
- US
- AU
- IN
- SG
- FR
- BR
description: Only pieces whose source is based in this region (#201). EU = EU institutions plus publishers based in a member state; each piece carries its source's `region`.
responses:
'200':
description: 'Every analysed piece: source, headline, URL, date, themes and frame vector.'
content:
application/json:
schema:
type: object
properties:
dataset:
type: string
version:
type: string
locale:
type: string
enum:
- en
- br
as_of:
type: string
run_id:
type: string
description:
type: string
data: {}
'401':
description: Missing, unknown or revoked key.
'403':
description: The key's account is not on the Premium plan.
'429':
description: Daily request limit reached (resets 00:00 UTC).
'503':
description: Not published yet; retry after the next run.
tags:
- Pieces
components:
securitySchemes:
apiKey:
type: apiKey
in: header
name: X-API-Key
externalDocs:
description: Orientation for language models
url: https://mediaframe.me/llms.txt