tech.transparencia.defs

transparencia.pds.transparencia.tech

Documentation

claim object

A factual claim or assertion extracted from content.

Properties

confidence string Optional

Confidence that this is a verifiable factual claim (decimal string 0-1).

maxLength: 16 bytes
text string Required

The claim statement.

maxLength: 2048 bytesmaxGraphemes: 512 graphemes
View raw schema 
{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 2048,
      "description": "The claim statement.",
      "maxGraphemes": 512
    },
    "confidence": {
      "type": "string",
      "maxLength": 16,
      "description": "Confidence that this is a verifiable factual claim (decimal string 0-1)."
    }
  },
  "description": "A factual claim or assertion extracted from content."
}
economicIndicator object

An economic data point mentioned in content.

Properties

direction string Optional

Trend direction if mentioned.

maxLength: 32 bytes
Known values: up, down, stable, unknown
name string Required

Indicator name (e.g., 'PIB', 'inflación', 'tipo de cambio').

maxLength: 256 bytesmaxGraphemes: 64 graphemes
value string Optional

The reported value as a string (e.g., '2.3%', '$17.45').

maxLength: 128 bytes
View raw schema 
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 256,
      "description": "Indicator name (e.g., 'PIB', 'inflación', 'tipo de cambio').",
      "maxGraphemes": 64
    },
    "value": {
      "type": "string",
      "maxLength": 128,
      "description": "The reported value as a string (e.g., '2.3%', '$17.45')."
    },
    "direction": {
      "type": "string",
      "maxLength": 32,
      "description": "Trend direction if mentioned.",
      "knownValues": [
        "up",
        "down",
        "stable",
        "unknown"
      ]
    }
  },
  "description": "An economic data point mentioned in content."
}
location object

A geographic location referenced in content. Coordinates use WGS 84 (EPSG:4326).

Properties

country string Optional

Full country name (e.g. 'México', 'United States').

maxLength: 256 bytesmaxGraphemes: 64 graphemes
countryCode string Optional

ISO 3166-1 alpha-2 country code (e.g. 'MX', 'US').

maxLength: 2 bytes
lat string Required

Latitude as a decimal string (AT Protocol does not support floats). Example: '19.4326'.

maxLength: 32 bytes
lng string Required

Longitude as a decimal string. Example: '-99.1332'.

maxLength: 32 bytes
name string Required

Place name (city, landmark, state, etc.).

maxLength: 512 bytesmaxGraphemes: 128 graphemes
relevance string Optional

How central this location is to the content.

maxLength: 32 bytes
Known values: primary, mentioned
state string Optional

State, province, or administrative region.

maxLength: 256 bytesmaxGraphemes: 64 graphemes
View raw schema 
{
  "type": "object",
  "required": [
    "name",
    "lat",
    "lng"
  ],
  "properties": {
    "lat": {
      "type": "string",
      "maxLength": 32,
      "description": "Latitude as a decimal string (AT Protocol does not support floats). Example: '19.4326'."
    },
    "lng": {
      "type": "string",
      "maxLength": 32,
      "description": "Longitude as a decimal string. Example: '-99.1332'."
    },
    "name": {
      "type": "string",
      "maxLength": 512,
      "description": "Place name (city, landmark, state, etc.).",
      "maxGraphemes": 128
    },
    "state": {
      "type": "string",
      "maxLength": 256,
      "description": "State, province, or administrative region.",
      "maxGraphemes": 64
    },
    "country": {
      "type": "string",
      "maxLength": 256,
      "description": "Full country name (e.g. 'México', 'United States').",
      "maxGraphemes": 64
    },
    "relevance": {
      "type": "string",
      "maxLength": 32,
      "description": "How central this location is to the content.",
      "knownValues": [
        "primary",
        "mentioned"
      ]
    },
    "countryCode": {
      "type": "string",
      "maxLength": 2,
      "description": "ISO 3166-1 alpha-2 country code (e.g. 'MX', 'US')."
    }
  },
  "description": "A geographic location referenced in content. Coordinates use WGS 84 (EPSG:4326)."
}
organization object

An organization, company, or brand mentioned in content.

Properties

entityId string Optional

Persistent identifier for cross-article entity linking (e.g., Wikidata QID like Q478214, LEI, or a canonical slug).

maxLength: 256 bytes
entityIdType string Optional

Identifier system used for entityId, so consumers know how to resolve it.

maxLength: 64 bytes
Known values: wikidata, lei, openfigi, opencorporates, sec-cik, isni, other
name string Required

Organization name (e.g., 'Apple', 'Gobierno de México', 'FIFA').

maxLength: 512 bytesmaxGraphemes: 128 graphemes
relevance string Optional

How central this organization is to the article.

maxLength: 32 bytes
Known values: primary, secondary, mentioned
role string Optional

Role in the story (e.g., 'defendant', 'sponsor', 'regulator').

maxLength: 1024 bytesmaxGraphemes: 256 graphemes
sector string Optional

Industry sector.

maxLength: 256 bytesmaxGraphemes: 64 graphemes
Known values: technology, finance, healthcare, energy, government, media, retail, automotive, real-estate, education, sports, entertainment, food-beverage, telecommunications, manufacturing, non-profit, legal, beauty-fashion, agriculture, transportation, defense, other
sentiment string Optional

How the content portrays this organization.

maxLength: 32 bytes
Known values: positive, negative, neutral, mixed
sentimentReasoning string Optional

Explanation of why this sentiment was assigned.

maxLength: 2048 bytesmaxGraphemes: 512 graphemes
sentimentScore string Optional

Numeric sentiment score as a decimal string. 0.0 = extremely negative, 0.5 = neutral, 1.0 = extremely positive.

maxLength: 16 bytes
ticker string Optional

Stock ticker symbol if publicly traded (e.g., 'AAPL', 'BIMBOA.MX').

maxLength: 32 bytes
View raw schema 
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 512,
      "description": "Organization name (e.g., 'Apple', 'Gobierno de México', 'FIFA').",
      "maxGraphemes": 128
    },
    "role": {
      "type": "string",
      "maxLength": 1024,
      "description": "Role in the story (e.g., 'defendant', 'sponsor', 'regulator').",
      "maxGraphemes": 256
    },
    "sector": {
      "type": "string",
      "maxLength": 256,
      "description": "Industry sector.",
      "knownValues": [
        "technology",
        "finance",
        "healthcare",
        "energy",
        "government",
        "media",
        "retail",
        "automotive",
        "real-estate",
        "education",
        "sports",
        "entertainment",
        "food-beverage",
        "telecommunications",
        "manufacturing",
        "non-profit",
        "legal",
        "beauty-fashion",
        "agriculture",
        "transportation",
        "defense",
        "other"
      ],
      "maxGraphemes": 64
    },
    "ticker": {
      "type": "string",
      "maxLength": 32,
      "description": "Stock ticker symbol if publicly traded (e.g., 'AAPL', 'BIMBOA.MX')."
    },
    "entityId": {
      "type": "string",
      "maxLength": 256,
      "description": "Persistent identifier for cross-article entity linking (e.g., Wikidata QID like Q478214, LEI, or a canonical slug)."
    },
    "relevance": {
      "type": "string",
      "maxLength": 32,
      "description": "How central this organization is to the article.",
      "knownValues": [
        "primary",
        "secondary",
        "mentioned"
      ]
    },
    "sentiment": {
      "type": "string",
      "maxLength": 32,
      "description": "How the content portrays this organization.",
      "knownValues": [
        "positive",
        "negative",
        "neutral",
        "mixed"
      ]
    },
    "entityIdType": {
      "type": "string",
      "maxLength": 64,
      "description": "Identifier system used for entityId, so consumers know how to resolve it.",
      "knownValues": [
        "wikidata",
        "lei",
        "openfigi",
        "opencorporates",
        "sec-cik",
        "isni",
        "other"
      ]
    },
    "sentimentScore": {
      "type": "string",
      "maxLength": 16,
      "description": "Numeric sentiment score as a decimal string. 0.0 = extremely negative, 0.5 = neutral, 1.0 = extremely positive."
    },
    "sentimentReasoning": {
      "type": "string",
      "maxLength": 2048,
      "description": "Explanation of why this sentiment was assigned.",
      "maxGraphemes": 512
    }
  },
  "description": "An organization, company, or brand mentioned in content."
}
person object

A person mentioned in content, with optional role and sentiment analysis.

Properties

entityId string Optional

Persistent identifier for cross-article entity linking (e.g., Wikidata QID like Q615, or a canonical slug).

maxLength: 256 bytes
entityIdType string Optional

Identifier system used for entityId, so consumers know how to resolve it.

maxLength: 64 bytes
Known values: wikidata, isni, orcid, viaf, other
name string Required

Full name of the person.

maxLength: 512 bytesmaxGraphemes: 128 graphemes
relevance string Optional

How central this person is to the article.

maxLength: 32 bytes
Known values: primary, secondary, mentioned
role string Optional

Role, title, or position (e.g., 'Presidente de México').

maxLength: 1024 bytesmaxGraphemes: 256 graphemes
sentiment string Optional

How the content portrays this person.

maxLength: 32 bytes
Known values: positive, negative, neutral, mixed
sentimentReasoning string Optional

Explanation of why this sentiment was assigned.

maxLength: 2048 bytesmaxGraphemes: 512 graphemes
sentimentScore string Optional

Numeric sentiment score as a decimal string. 0.0 = extremely negative, 0.5 = neutral, 1.0 = extremely positive.

maxLength: 16 bytes
View raw schema 
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 512,
      "description": "Full name of the person.",
      "maxGraphemes": 128
    },
    "role": {
      "type": "string",
      "maxLength": 1024,
      "description": "Role, title, or position (e.g., 'Presidente de México').",
      "maxGraphemes": 256
    },
    "entityId": {
      "type": "string",
      "maxLength": 256,
      "description": "Persistent identifier for cross-article entity linking (e.g., Wikidata QID like Q615, or a canonical slug)."
    },
    "relevance": {
      "type": "string",
      "maxLength": 32,
      "description": "How central this person is to the article.",
      "knownValues": [
        "primary",
        "secondary",
        "mentioned"
      ]
    },
    "sentiment": {
      "type": "string",
      "maxLength": 32,
      "description": "How the content portrays this person.",
      "knownValues": [
        "positive",
        "negative",
        "neutral",
        "mixed"
      ]
    },
    "entityIdType": {
      "type": "string",
      "maxLength": 64,
      "description": "Identifier system used for entityId, so consumers know how to resolve it.",
      "knownValues": [
        "wikidata",
        "isni",
        "orcid",
        "viaf",
        "other"
      ]
    },
    "sentimentScore": {
      "type": "string",
      "maxLength": 16,
      "description": "Numeric sentiment score as a decimal string. 0.0 = extremely negative, 0.5 = neutral, 1.0 = extremely positive."
    },
    "sentimentReasoning": {
      "type": "string",
      "maxLength": 2048,
      "description": "Explanation of why this sentiment was assigned.",
      "maxGraphemes": 512
    }
  },
  "description": "A person mentioned in content, with optional role and sentiment analysis."
}
structuredRef object

A typed reference to an external entity (law, stock, product, team, etc.).

Properties

type string Required

What kind of reference this is.

maxLength: 64 bytes
Known values: legislation, regulation, court-case, stock-ticker, index, commodity, product, brand, sports-team, sports-league, sports-event, academic-paper, patent, government-program, treaty, other
url string uri Optional

Optional URL to the referenced entity.

value string Required

The reference value (e.g., 'Ley General de Salud Art. 73', 'AAPL', 'Liga MX').

maxLength: 1024 bytesmaxGraphemes: 256 graphemes
View raw schema 
{
  "type": "object",
  "required": [
    "type",
    "value"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Optional URL to the referenced entity."
    },
    "type": {
      "type": "string",
      "maxLength": 64,
      "description": "What kind of reference this is.",
      "knownValues": [
        "legislation",
        "regulation",
        "court-case",
        "stock-ticker",
        "index",
        "commodity",
        "product",
        "brand",
        "sports-team",
        "sports-league",
        "sports-event",
        "academic-paper",
        "patent",
        "government-program",
        "treaty",
        "other"
      ]
    },
    "value": {
      "type": "string",
      "maxLength": 1024,
      "description": "The reference value (e.g., 'Ley General de Salud Art. 73', 'AAPL', 'Liga MX').",
      "maxGraphemes": 256
    }
  },
  "description": "A typed reference to an external entity (law, stock, product, team, etc.)."
}
timelineEntry object

A chronological event mentioned in content.

Properties

endDate string datetime Optional

End date/time in ISO 8601 format. Only for date ranges (e.g., a presidential term). Omit for point-in-time events.

event string Required

Description of what happened.

maxLength: 1024 bytesmaxGraphemes: 256 graphemes
startDate string datetime Required

Start date/time in ISO 8601 format (e.g., '2026-04-04T00:00:00.000Z'). For approximate dates, use the first day of the period.

View raw schema 
{
  "type": "object",
  "required": [
    "event",
    "startDate"
  ],
  "properties": {
    "event": {
      "type": "string",
      "maxLength": 1024,
      "description": "Description of what happened.",
      "maxGraphemes": 256
    },
    "endDate": {
      "type": "string",
      "format": "datetime",
      "description": "End date/time in ISO 8601 format. Only for date ranges (e.g., a presidential term). Omit for point-in-time events."
    },
    "startDate": {
      "type": "string",
      "format": "datetime",
      "description": "Start date/time in ISO 8601 format (e.g., '2026-04-04T00:00:00.000Z'). For approximate dates, use the first day of the period."
    }
  },
  "description": "A chronological event mentioned in content."
}

Lexicon Garden

@