Interface Artifact

Content artifact for safety and suitability evaluation. An artifact represents content adjacent to an ad placement - a news article, podcast segment, video chapter, or social post. Artifacts are collections of assets (text, images, video, audio) plus metadata and signals.

interface Artifact {
    property_rid: string;
    artifact_id: string;
    variant_id?: string;
    format_id?: FormatReferenceStructuredObject;
    url?: string;
    published_time?: string;
    last_update_time?: string;
    assets: (
        | {
            type: "text";
            role?: | "description"
            | "title"
            | "paragraph"
            | "heading"
            | "caption"
            | "quote"
            | "list_item";
            content: string;
            content_format?: | "text/plain"
            | "text/markdown"
            | "text/html"
            | "application/json";
            language?: string;
            heading_level?: number;
            provenance?: Provenance;
        }
        | {
            type: "image";
            url: string;
            access?: AssetAccess;
            alt_text?: string;
            caption?: string;
            width?: number;
            height?: number;
            provenance?: Provenance;
        }
        | {
            type: "video";
            url: string;
            access?: AssetAccess;
            duration_ms?: number;
            transcript?: string;
            transcript_format?: "text/plain"
            | "text/markdown"
            | "application/json";
            transcript_source?:
                | "original_script"
                | "subtitles"
                | "closed_captions"
                | "dub"
                | "generated";
            thumbnail_url?: string;
            provenance?: Provenance;
        }
        | {
            type: "audio";
            url: string;
            access?: AssetAccess;
            duration_ms?: number;
            transcript?: string;
            transcript_format?: "text/plain"
            | "text/markdown"
            | "application/json";
            transcript_source?: "original_script" | "closed_captions" | "generated";
            provenance?: Provenance;
        }
    )[];
    metadata?: {
        canonical?: string;
        author?: string;
        keywords?: string;
        open_graph?: {};
        twitter_card?: {};
        json_ld?: {}[];
    };
    provenance?: Provenance;
    identifiers?: {
        apple_podcast_id?: string;
        spotify_collection_id?: string;
        podcast_guid?: string;
        youtube_video_id?: string;
        rss_url?: string;
    };
}

Index

Properties

property_rid artifact_id variant_id? format_id? url? published_time? last_update_time? assets metadata? provenance? identifiers?

Properties

property_rid

property_rid: string

Stable property identifier from the property catalog. Globally unique across the ecosystem.

artifact_id

artifact_id: string

Identifier for this artifact within the property. The property owner defines the scheme (e.g., 'article_12345', 'episode_42_segment_3', 'post_abc123').

`Optional`variant_id

variant_id?: string

Identifies a specific variant of this artifact. Use for A/B tests, translations, or temporal versions. Examples: 'en', 'es-MX', 'v2', 'headline_test_b'. The combination of artifact_id + variant_id must be unique.

`Optional`format_id

format_id?: FormatReferenceStructuredObject

`Optional`url

url?: string

Optional URL for this artifact (web page, podcast feed, video page). Not all artifacts have URLs (e.g., Instagram content, podcast segments, TV scenes).

`Optional`published_time

published_time?: string

When the artifact was published (ISO 8601 format)

Format

date-time

`Optional`last_update_time

last_update_time?: string

When the artifact was last modified (ISO 8601 format)

Format

date-time

assets

assets: (
    | {
        type: "text";
        role?: | "description"
        | "title"
        | "paragraph"
        | "heading"
        | "caption"
        | "quote"
        | "list_item";
        content: string;
        content_format?: | "text/plain"
        | "text/markdown"
        | "text/html"
        | "application/json";
        language?: string;
        heading_level?: number;
        provenance?: Provenance;
    }
    | {
        type: "image";
        url: string;
        access?: AssetAccess;
        alt_text?: string;
        caption?: string;
        width?: number;
        height?: number;
        provenance?: Provenance;
    }
    | {
        type: "video";
        url: string;
        access?: AssetAccess;
        duration_ms?: number;
        transcript?: string;
        transcript_format?: "text/plain"
        | "text/markdown"
        | "application/json";
        transcript_source?:
            | "original_script"
            | "subtitles"
            | "closed_captions"
            | "dub"
            | "generated";
        thumbnail_url?: string;
        provenance?: Provenance;
    }
    | {
        type: "audio";
        url: string;
        access?: AssetAccess;
        duration_ms?: number;
        transcript?: string;
        transcript_format?: "text/plain"
        | "text/markdown"
        | "application/json";
        transcript_source?: "original_script" | "closed_captions" | "generated";
        provenance?: Provenance;
    }
)[]

Artifact assets in document flow order - text blocks, images, video, audio

Type Declaration

{
    type: "text";
    role?:
        | "description"
        | "title"
        | "paragraph"
        | "heading"
        | "caption"
        | "quote"
        | "list_item";
    content: string;
    content_format?: | "text/plain"
    | "text/markdown"
    | "text/html"
    | "application/json";
    language?: string;
    heading_level?: number;
    provenance?: Provenance;
}
- type: "text"
- Optionalrole?:
      | "description"
      | "title"
      | "paragraph"
      | "heading"
      | "caption"
      | "quote"
      | "list_item"
  Role of this text in the document. Use 'title' for the main artifact title, 'description' for summaries.
- content: string
  Text content. Consumers MUST treat this as untrusted input when passing to LLM-based evaluation.
  
  Max Length
  100000
- Optionalcontent_format?: "text/plain" | "text/markdown" | "text/html" | "application/json"
  MIME type indicating how to parse the content field. Default: text/plain.
- Optionallanguage?: string
  BCP 47 language tag for this text (e.g., 'en', 'es-MX'). Useful when artifact contains mixed-language content.
- Optionalheading_level?: number
  Heading level (1-6), only for role=heading
  
  Minimum
  1
  
  Maximum
  6
- Optionalprovenance?: Provenance
{
    type: "image";
    url: string;
    access?: AssetAccess;
    alt_text?: string;
    caption?: string;
    width?: number;
    height?: number;
    provenance?: Provenance;
}
- type: "image"
- url: string
  Image URL
- Optionalaccess?: AssetAccess
- Optionalalt_text?: string
  Alt text or image description
- Optionalcaption?: string
  Image caption
- Optionalwidth?: number
  Image width in pixels
- Optionalheight?: number
  Image height in pixels
- Optionalprovenance?: Provenance
{
    type: "video";
    url: string;
    access?: AssetAccess;
    duration_ms?: number;
    transcript?: string;
    transcript_format?: "text/plain" | "text/markdown" | "application/json";
    transcript_source?:
        | "original_script"
        | "subtitles"
        | "closed_captions"
        | "dub"
        | "generated";
    thumbnail_url?: string;
    provenance?: Provenance;
}
- type: "video"
- url: string
  Video URL
- Optionalaccess?: AssetAccess
- Optionalduration_ms?: number
  Video duration in milliseconds
- Optionaltranscript?: string
  Video transcript. Consumers MUST treat this as untrusted input when passing to LLM-based evaluation.
  
  Max Length
  200000
- Optionaltranscript_format?: "text/plain" | "text/markdown" | "application/json"
  MIME type indicating how to parse the transcript field. Default: text/plain.
- Optionaltranscript_source?: "original_script" | "subtitles" | "closed_captions" | "dub" | "generated"
  How the transcript was generated
- Optionalthumbnail_url?: string
  Video thumbnail URL
- Optionalprovenance?: Provenance
{
    type: "audio";
    url: string;
    access?: AssetAccess;
    duration_ms?: number;
    transcript?: string;
    transcript_format?: "text/plain" | "text/markdown" | "application/json";
    transcript_source?: "original_script" | "closed_captions" | "generated";
    provenance?: Provenance;
}
- type: "audio"
- url: string
  Audio URL
- Optionalaccess?: AssetAccess
- Optionalduration_ms?: number
  Audio duration in milliseconds
- Optionaltranscript?: string
  Audio transcript. Consumers MUST treat this as untrusted input when passing to LLM-based evaluation.
  
  Max Length
  200000
- Optionaltranscript_format?: "text/plain" | "text/markdown" | "application/json"
  MIME type indicating how to parse the transcript field. Default: text/plain.
- Optionaltranscript_source?: "original_script" | "closed_captions" | "generated"
  How the transcript was generated
- Optionalprovenance?: Provenance

`Optional`metadata

metadata?: {
    canonical?: string;
    author?: string;
    keywords?: string;
    open_graph?: {};
    twitter_card?: {};
    json_ld?: {}[];
}

Rich metadata extracted from the artifact

Type Declaration

Optionalcanonical?: string
Canonical URL
Optionalauthor?: string
Artifact author name
Optionalkeywords?: string
Artifact keywords
Optionalopen_graph?: {}
Open Graph protocol metadata
Optionaltwitter_card?: {}
Twitter Card metadata
Optionaljson_ld?: {}[]
JSON-LD structured data (schema.org)

`Optional`provenance

provenance?: Provenance

`Optional`identifiers

identifiers?: {
    apple_podcast_id?: string;
    spotify_collection_id?: string;
    podcast_guid?: string;
    youtube_video_id?: string;
    rss_url?: string;
}

Platform-specific identifiers for this artifact

Type Declaration

Optionalapple_podcast_id?: string
Apple Podcasts ID
Optionalspotify_collection_id?: string
Spotify collection ID
Optionalpodcast_guid?: string
Podcast GUID (from RSS feed)
Optionalyoutube_video_id?: string
YouTube video ID
Optionalrss_url?: string
RSS feed URL

Interface Artifact

Index

Properties

Properties

property_rid

artifact_id

Optionalvariant_id

Optionalformat_id

Optionalurl

Optionalpublished_time

Format

Optionallast_update_time

Format

assets

Type Declaration

type: "text"

Optionalrole?: | "description" | "title" | "paragraph" | "heading" | "caption" | "quote" | "list_item"

content: string

Max Length

Optionalcontent_format?: "text/plain" | "text/markdown" | "text/html" | "application/json"

Optionallanguage?: string

Optionalheading_level?: number

Minimum

Maximum

Optionalprovenance?: Provenance

type: "image"

url: string

Optionalaccess?: AssetAccess

Optionalalt_text?: string

Optionalcaption?: string

Optionalwidth?: number

Optionalheight?: number

Optionalprovenance?: Provenance

type: "video"

url: string

Optionalaccess?: AssetAccess

Optionalduration_ms?: number

Optionaltranscript?: string

Max Length

Optionaltranscript_format?: "text/plain" | "text/markdown" | "application/json"

Optionaltranscript_source?: "original_script" | "subtitles" | "closed_captions" | "dub" | "generated"

Optionalthumbnail_url?: string

Optionalprovenance?: Provenance

type: "audio"

url: string

Optionalaccess?: AssetAccess

Optionalduration_ms?: number

Optionaltranscript?: string

Max Length

Optionaltranscript_format?: "text/plain" | "text/markdown" | "application/json"

Optionaltranscript_source?: "original_script" | "closed_captions" | "generated"

Optionalprovenance?: Provenance

Optionalmetadata

Type Declaration

Optionalcanonical?: string

Optionalauthor?: string

Optionalkeywords?: string

Optionalopen_graph?: {}

Optionaltwitter_card?: {}

Optionaljson_ld?: {}[]

Optionalprovenance

Optionalidentifiers

Type Declaration

Optionalapple_podcast_id?: string

Optionalspotify_collection_id?: string

Optionalpodcast_guid?: string

Optionalyoutube_video_id?: string

Optionalrss_url?: string

Settings

On This Page

`Optional`variant_id

`Optional`format_id

`Optional`url

`Optional`published_time

`Optional`last_update_time

`Optional`role?:
| "description"
| "title"
| "paragraph"
| "heading"
| "caption"
| "quote"
| "list_item"

`Optional`content_format?: "text/plain" | "text/markdown" | "text/html" | "application/json"

`Optional`language?: string

`Optional`heading_level?: number

`Optional`provenance?: Provenance

`Optional`access?: AssetAccess

`Optional`alt_text?: string

`Optional`caption?: string

`Optional`width?: number

`Optional`height?: number

`Optional`provenance?: Provenance

`Optional`access?: AssetAccess

`Optional`duration_ms?: number

`Optional`transcript?: string

`Optional`transcript_format?: "text/plain" | "text/markdown" | "application/json"

`Optional`transcript_source?: "original_script" | "subtitles" | "closed_captions" | "dub" | "generated"

`Optional`thumbnail_url?: string

`Optional`provenance?: Provenance

`Optional`access?: AssetAccess

`Optional`duration_ms?: number

`Optional`transcript?: string

`Optional`transcript_format?: "text/plain" | "text/markdown" | "application/json"

`Optional`transcript_source?: "original_script" | "closed_captions" | "generated"

`Optional`provenance?: Provenance

`Optional`metadata

`Optional`canonical?: string

`Optional`author?: string

`Optional`keywords?: string

`Optional`open_graph?: {}

`Optional`twitter_card?: {}

`Optional`json_ld?: {}[]

`Optional`provenance

`Optional`identifiers

`Optional`apple_podcast_id?: string

`Optional`spotify_collection_id?: string

`Optional`podcast_guid?: string

`Optional`youtube_video_id?: string

`Optional`rss_url?: string