Skip to main content
Glama

Read a Graunt packet

fetch
Read-only

Read one Graunt catalog packet by id. Returns its title, description, price and whether an account is needed, its seller-declared rights, and its public URL. A free packet that needs no account also returns its files: small text files (CSV, JSON, Markdown, text and similar) in the text, and a short-lived download link for each listed file in metadata.files (at most 100 per fetch; files_not_listed counts the rest). A video listing also returns metadata.video: its subjects, measured hours, the price and what it comes to per hour, and the seller's declarations.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "id": "<id>"
    },
    "name": "fetch"
  }
}

Input Schema

NameRequiredDescriptionDefault
idYesThe packet listing id.

Output Schema

NameRequiredDescriptionDefault
idYes
urlYes
textYes
titleYes
metadataYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changed
    • addedOutput schema / properties / metadata / properties / price_cents / description
      Added value: +"Integer cents; null when the listing shows no price."
    • changedOutput schema / properties / metadata / properties / price_cents / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedOutput schema / properties / metadata / properties / video / properties / package / properties / calculated_price_per_hour_cents / description
      Previous value: -"price_cents divided by the measured hours, rounded to the cent. A figure for comparing listings; nothing is charged by the hour."New value: +"price_cents divided by the measured hours, rounded to the cent. A figure for comparing listings; nothing is charged by the hour. Null when the listing shows no price."
    • changedOutput schema / properties / metadata / properties / video / properties / package / properties / calculated_price_per_hour_cents / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedOutput schema / properties / metadata / properties / video / properties / package / properties / price_cents / description
      Previous value: -"The listing price: what checkout charges for the whole listing before any sales tax."New value: +"The listing price: what checkout charges for the whole listing before any sales tax. Null when the listing shows no price."
    • changedOutput schema / properties / metadata / properties / video / properties / package / properties / price_cents / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
  2. Changed2 schema fields changed
    • changedOutput schema / properties / metadata / properties / seller_terms / description
      Previous value: -"Present only when the seller attached additional terms a buyer accepts before buying: their title, current version, SHA-256 and the URL of their text."New value: +"Present only when the seller attached a document a buyer accepts before buying: their own license (kind SELLER_LICENSE, the license for the sale in place of the Marketplace License) or their additional terms. Its title, current version, SHA-256 and the URL of its text."
    • changedOutput schema / properties / metadata / properties / seller_terms / properties / kind / enum
      Previous value: -[
      -  "ADDITIONAL_TERMS"
      -]New value: +[
      +  "ADDITIONAL_TERMS",
      +  "SELLER_LICENSE"
      +]
  3. Changed1 schema field changed
    • addedOutput schema / properties / metadata / properties / commercial_use
      Added value: +{
      +  "description": "Present when the seller gave commercial use a price of its own: that price (price_cents, or price_per_hour_cents on a listing stored with a rate per hour) and each choice the listing sells with the whole listing's price at it. price_cents above buys AI use; the buyer picks another choice at checkout.",
      +  "properties": {
      +    "choices": {
      +      "items": {
      +        "properties": {
      +          "label": {
      +            "type": "string"
      +          },
      +          "license_uses": {
      +            "enum": [
      +              "AI",
      +              "COMMERCIAL",
      +              "AI_AND_COMMERCIAL"
      +            ],
      +            "type": "string"
      +          },
      +          "price_cents": {
      +            "type": "integer"
      +          },
      +          "price_per_hour_cents": {
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "license_uses",
      +          "label",
      +          "price_cents"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "price_cents": {
      +      "type": "integer"
      +    },
      +    "price_per_hour_cents": {
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "choices"
      +  ],
      +  "type": "object"
      +}
  4. Changed1 schema field changed
    • addedOutput schema / properties / metadata / properties / video / properties / media_kind / enum
      Added value: +[
      +  "VIDEO",
      +  "AUDIO"
      +]
  5. Changed2 schema fields changed
    • changedOutput schema / properties / metadata / properties / video / description
      Previous value: -"Present only on a video listing: subjects, the hours Graunt measured, the per-hour price with its volume tiers, and the seller's declarations (people on camera, releases, sublicense), kept apart."New value: +"Present only on a video listing: subjects, the hours Graunt measured, the price and what it comes to per hour, and the seller's declarations (people on camera, releases, sublicense), kept apart."
    • removedOutput schema / properties / metadata / properties / video / properties / package / properties / categories
      Removed value: -{
      -  "description": "Present when some of the listing's categories can be bought at their share of its price. Every category is listed with its measured hours. An order of one or more categories is priced on their combined seconds, the listing price times their share of the measured seconds, rounded down to the cent once; every category together is the whole listing at price_cents. An order under the smallest paid order is refused.",
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "eligible_duration_seconds": {
      -        "description": "This category's seconds of video, exact; its price is computed from them.",
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "hours": {
      -        "description": "The same length in hours, rounded to one decimal place. For an exact amount, use eligible_duration_seconds.",
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "price_cents": {
      -        "description": "This category bought on its own, as checkout prices it. Null when that is under the smallest paid order: the category is then bought only with other categories.",
      -        "minimum": 0,
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "subject": {
      -        "enum": [
      -          "PEOPLE_TALKING",
      -          "PEOPLE_IN_ACTION",
      -          "PEOPLE_HANDLING_OBJECTS",
      -          "HOW_TO_AND_TASKS",
      -          "SPORTS_AND_FITNESS",
      -          "MUSIC_AND_PERFORMANCE",
      -          "ANIMALS",
      -          "NATURE",
      -          "CITIES_AND_BUILDINGS",
      -          "DRIVING_AND_TRANSPORTATION",
      -          "INDUSTRY_AND_WORK_SITES",
      -          "FOOD_AND_COOKING",
      -          "PRODUCTS_AND_RETAIL",
      -          "ANIMATION",
      -          "VIDEO_GAMES"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "subject",
      -      "eligible_duration_seconds",
      -      "hours",
      -      "price_cents"
      -    ],
      -    "type": "object"
      -  },
      -  "maxItems": 15,
      -  "minItems": 2,
      -  "type": "array"
      -}
  6. Changed1 schema field changed
    • addedOutput schema / properties / metadata / properties / seller_terms
      Added value: +{
      +  "description": "Present only when the seller attached additional terms a buyer accepts before buying: their title, current version, SHA-256 and the URL of their text.",
      +  "properties": {
      +    "content_sha256": {
      +      "type": "string"
      +    },
      +    "kind": {
      +      "enum": [
      +        "ADDITIONAL_TERMS"
      +      ],
      +      "type": "string"
      +    },
      +    "title": {
      +      "type": "string"
      +    },
      +    "url": {
      +      "type": "string"
      +    },
      +    "version": {
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "title",
      +    "content_sha256",
      +    "url"
      +  ],
      +  "type": "object"
      +}
  7. Changed1 schema field changed
    • removedOutput schema / properties / metadata / properties / video / properties / media_kind / enum
      Removed value: -[
      -  "VIDEO"
      -]
  8. Changed3 schema fields changed
    • addedOutput schema / properties / metadata / properties / video / properties / package
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "A paid video listing with measured hours: its one price, and what that comes to per hour. Null on a listing stored with a rate per hour (see per_hour), a free listing, or one with no measured hours.",
      +  "properties": {
      +    "calculated_price_per_hour_cents": {
      +      "description": "price_cents divided by the measured hours, rounded to the cent. A figure for comparing listings; nothing is charged by the hour.",
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "categories": {
      +      "description": "Present when some of the listing's categories can be bought at their share of its price. Every category is listed with its measured hours. An order of one or more categories is priced on their combined seconds, the listing price times their share of the measured seconds, rounded down to the cent once; every category together is the whole listing at price_cents. An order under the smallest paid order is refused.",
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "eligible_duration_seconds": {
      +            "description": "This category's seconds of video, exact; its price is computed from them.",
      +            "minimum": 1,
      +            "type": "integer"
      +          },
      +          "hours": {
      +            "description": "The same length in hours, rounded to one decimal place. For an exact amount, use eligible_duration_seconds.",
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "price_cents": {
      +            "description": "This category bought on its own, as checkout prices it. Null when that is under the smallest paid order: the category is then bought only with other categories.",
      +            "minimum": 0,
      +            "type": [
      +              "integer",
      +              "null"
      +            ]
      +          },
      +          "subject": {
      +            "enum": [
      +              "PEOPLE_TALKING",
      +              "PEOPLE_IN_ACTION",
      +              "PEOPLE_HANDLING_OBJECTS",
      +              "HOW_TO_AND_TASKS",
      +              "SPORTS_AND_FITNESS",
      +              "MUSIC_AND_PERFORMANCE",
      +              "ANIMALS",
      +              "NATURE",
      +              "CITIES_AND_BUILDINGS",
      +              "DRIVING_AND_TRANSPORTATION",
      +              "INDUSTRY_AND_WORK_SITES",
      +              "FOOD_AND_COOKING",
      +              "PRODUCTS_AND_RETAIL",
      +              "ANIMATION",
      +              "VIDEO_GAMES"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "subject",
      +          "eligible_duration_seconds",
      +          "hours",
      +          "price_cents"
      +        ],
      +        "type": "object"
      +      },
      +      "maxItems": 15,
      +      "minItems": 2,
      +      "type": "array"
      +    },
      +    "currency": {
      +      "const": "usd"
      +    },
      +    "price_cents": {
      +      "description": "The listing price: what checkout charges for the whole listing before any sales tax.",
      +      "minimum": 1,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "price_cents",
      +    "currency",
      +    "calculated_price_per_hour_cents"
      +  ],
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / metadata / properties / video / properties / per_hour / description
      Previous value: -"The per-hour price, or null when the listing has a flat price. The seller sets the rate. The volume tier is applied automatically from the hours in the order; there is no code and nothing to request. All amounts are integer cents."New value: +"Null unless the listing is stored with a rate per hour; a video listing otherwise has one price (see package). On a listing with a rate the price is its measured hours at that rate, less the volume tier the hours in the order reach, applied automatically: there is no code and nothing to request. All amounts are integer cents."
    • changedOutput schema / properties / metadata / properties / video / required
      Previous value: -[
      -  "media_kind",
      -  "subjects",
      -  "camera_views",
      -  "measured",
      -  "per_hour",
      -  "seller_declared",
      -  "barred_uses"
      -]New value: +[
      +  "media_kind",
      +  "subjects",
      +  "camera_views",
      +  "measured",
      +  "per_hour",
      +  "package",
      +  "seller_declared",
      +  "barred_uses"
      +]
  9. Changed1 schema field changed
    • changedOutput schema / properties / metadata / properties / samples / properties / detail_fields / items / enum
      Previous value: -[
      -  "preview",
      -  "content_excerpt",
      -  "preview_clips"
      -]New value: +[
      +  "preview",
      +  "content_excerpt",
      +  "preview_clips",
      +  "preview_images"
      +]
  10. Changed1 schema field changed
    • changedOutput schema / properties / metadata / properties / files / description
      Previous value: -"Present when the packet downloads without an account: one entry per listed file (at most 100; files_not_listed counts the rest). inline says how much of the file the text shows (up to 200 KB of text in all); download_url works until download_expires_at. Images, audio and video carry no link here and download from the packet's public URL."New value: +"Present when the packet downloads without an account: one entry per listed file (at most 100; files_not_listed counts the rest). inline says how much of the file the text shows (up to 200 KB of text in all); download_url works until download_expires_at."
  11. Changed2 schema fields changed
    • changedOutput schema / properties / metadata / properties / seller_hosted / properties / clip_facts / description
      Previous value: -"Where the set's media facts, its lengths included, come from: GRAUNT_EVERY_FILE when Graunt read every file; SELLER_MANIFEST when they are the seller's manifest, with spec_check saying how many files Graunt read at random against it."New value: +"Where the set's media facts, its lengths included, come from: GRAUNT_EVERY_FILE when Graunt read every file; SELLER_MANIFEST when they are the seller's manifest, with spec_check saying how many files Graunt read at random against it. LISTING_DECLARED when the seller described the set in place of a file list: the figures are the seller's."
    • changedOutput schema / properties / metadata / properties / seller_hosted / properties / clip_facts / enum
      Previous value: -[
      -  "GRAUNT_EVERY_FILE",
      -  "SELLER_MANIFEST"
      -]New value: +[
      +  "GRAUNT_EVERY_FILE",
      +  "SELLER_MANIFEST",
      +  "LISTING_DECLARED"
      +]
  12. Changed4 schema fields changed
    • addedOutput schema / properties / metadata / properties / exclusivity
      Added value: +{
      +  "description": "Present while the seller offers this listing exclusively and it is on sale. One buyer holds it for the months given; for that Exclusivity Period it is sold to no one else, and the seller licenses it, or any copy, excerpt or edit of it, to no one else for the uses that buyer bought. Buyers who already hold it keep what they bought. Add it by sending exclusive with these months and price_cents when you buy.",
      +  "properties": {
      +    "holders": {
      +      "description": "How many accounts already hold the listing and keep what they bought, by way, with no names. Never the seller, and in a quote never the buyer asking.",
      +      "properties": {
      +        "own_it_outright": {
      +          "description": "Accounts that bought the listing outright.",
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "paying_now": {
      +          "description": "Accounts whose payment for the listing is already under way.",
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "subscription": {
      +          "description": "Accounts with a subscription to the listing that is still billing.",
      +          "minimum": 0,
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "own_it_outright",
      +        "subscription",
      +        "paying_now"
      +      ],
      +      "type": "object"
      +    },
      +    "licenses_elsewhere": {
      +      "description": "Licenses of this data outside Graunt, still running, that the seller declares.",
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "mode": {
      +      "description": "OPTION: the listing also sells without exclusivity. ONLY: it is sold only exclusively.",
      +      "enum": [
      +        "OPTION",
      +        "ONLY"
      +      ],
      +      "type": "string"
      +    },
      +    "months": {
      +      "description": "Whole months the buyer holds the listing exclusively, from the sale.",
      +      "maximum": 60,
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    "price_cents": {
      +      "description": "What exclusivity adds to the listing's own price, in cents, as the seller set it.",
      +      "minimum": 50,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "mode",
      +    "months",
      +    "price_cents",
      +    "holders",
      +    "licenses_elsewhere"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / metadata / properties / not_on_sale
      Added value: +{
      +  "description": "Present with on_sale: why the listing can't be bought now, in a sentence to show a buyer.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / metadata / properties / on_sale
      Added value: +{
      +  "const": false,
      +  "description": "Present, and false, while the listing is held for one buyer: sold to that buyer exclusively, or sharing files with a listing that is. Absent while it is on sale."
      +}
    • addedOutput schema / properties / metadata / properties / sold_exclusively_until
      Added value: +{
      +  "description": "Present on the listing sold exclusively: when its Exclusivity Period ends and it is on sale again. Never the buyer or the price.",
      +  "format": "date-time",
      +  "type": "string"
      +}
  13. Changed5 schema fields changed
    • changedOutput schema / properties / metadata / properties / delivery_methods / items / properties / method / enum
      Previous value: -[
      -  "KEY_ACCESS",
      -  "DOWNLOAD"
      -]New value: +[
      +  "KEY_ACCESS",
      +  "DOWNLOAD",
      +  "SHIPPED_DRIVE",
      +  "NETWORK_TRANSFER"
      +]
    • changedOutput schema / properties / metadata / properties / delivery_methods / items / properties / source / enum
      Previous value: -[
      -  "GRAUNT",
      -  "S3",
      -  "S3_COMPATIBLE"
      -]New value: +[
      +  "GRAUNT",
      +  "S3",
      +  "S3_COMPATIBLE",
      +  "OFF_PLATFORM"
      +]
    • changedOutput schema / properties / metadata / properties / seller_hosted / properties / delivery_modes / description
      Previous value: -"How the buyer can receive the files. LINKS: a download link per file."New value: +"How the buyer can receive the files. LINKS: a download link per file. SEALED: a copy the seller sends, on drives with a tracking number or encrypted over a network."
    • changedOutput schema / properties / metadata / properties / seller_hosted / properties / delivery_modes / items / enum
      Previous value: -[
      -  "LINKS"
      -]New value: +[
      +  "LINKS",
      +  "SEALED"
      +]
    • addedOutput schema / properties / metadata / properties / seller_hosted / properties / drives
      Added value: +{
      +  "description": "The drives the set ships on, bought at checkout: the drive size, the seller's price per drive with shipping included, and the drives the whole set fills. Null when the set ships none.",
      +  "properties": {
      +    "drive_count": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "drive_size_tb": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "price_per_drive_cents": {
      +      "minimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
  14. Changed1 schema field changed
    • changedOutput schema / properties / metadata / properties / seller_hosted / properties / total_duration_seconds / description
      Previous value: -"Seconds of the set's video clips (files with a length, a width and a height) when it has any; a set with no clips counts every file with a length, its audio."New value: +"Seconds of the set's video clips (files with a length, a width and a height) when it has any; a set with no clips counts every file with a length, its audio. Files with the same SHA-256 count once; a file with no SHA-256 counts as itself."
  15. Changed1 schema field changed
    • addedOutput schema / properties / metadata / properties / permissions
      Added value: +{
      +  "description": "The listing's permissions (Marketplace License section 3), in order: code, label, the seller's answer and its label, whether that answer is the License's default (the one AI buyers want), and the License's sentence for it. Rows that do not apply to the listing are left out.",
      +  "items": {
      +    "properties": {
      +      "answer": {
      +        "enum": [
      +          "YES",
      +          "NO",
      +          "EDITORIAL",
      +          "PROMOTIONAL",
      +          "COMMERCIAL",
      +          "NOT_PERMITTED",
      +          "PERMITTED",
      +          "NOT_NEEDED",
      +          "PREFERRED",
      +          "REQUIRED",
      +          "NONE",
      +          "LISTED",
      +          "PERPETUAL",
      +          "DAYS",
      +          "WORLDWIDE",
      +          "COUNTRIES"
      +        ],
      +        "type": "string"
      +      },
      +      "answer_label": {
      +        "type": "string"
      +      },
      +      "clause": {
      +        "type": "string"
      +      },
      +      "code": {
      +        "enum": [
      +          "TRAIN_MODELS",
      +          "SHOW_PUBLICLY",
      +          "SUBLICENSE_ONE_CLIENT",
      +          "CREDIT_SELLER",
      +          "SYNTHETIC_DATA",
      +          "RETRIEVAL_EXCERPTS",
      +          "RELEASE_WEIGHTS",
      +          "USE_AUDIO",
      +          "CLIENT_AFFILIATES",
      +          "LEAVE_OUT",
      +          "TERM",
      +          "TERRITORY"
      +        ],
      +        "type": "string"
      +      },
      +      "label": {
      +        "type": "string"
      +      },
      +      "standard": {
      +        "type": "boolean"
      +      },
      +      "values": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "code",
      +      "label",
      +      "answer",
      +      "answer_label",
      +      "standard",
      +      "clause"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  16. Changed4 schema fields changed
    • addedOutput schema / properties / metadata / properties / seller_credentials_summary
      Added value: +{
      +  "description": "The seller's credentials (trade licenses, certifications, registrations, memberships) as counts: declared is every credential the seller declares, checked is how many of those an operator checked against a registry, and kinds lists the kinds among them. A seller declaration that Graunt records, never a Graunt finding, a score or a ranking input.",
      +  "properties": {
      +    "checked": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "declared": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "kinds": {
      +      "items": {
      +        "enum": [
      +          "TRADE_LICENSE",
      +          "CERTIFICATION",
      +          "BUSINESS_REGISTRATION",
      +          "MEMBERSHIP",
      +          "EDUCATION",
      +          "OTHER"
      +        ],
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "declared",
      +    "checked",
      +    "kinds"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / metadata / properties / video / properties / seller_declared / properties / attestations / properties / countries_filmed
      Added value: +{
      +  "description": "The countries the footage was filmed in, as ISO 3166-1 alpha-2 codes.",
      +  "items": {
      +    "enum": [
      +      "AD",
      +      "AE",
      +      "AF",
      +      "AG",
      +      "AI",
      +      "AL",
      +      "AM",
      +      "AO",
      +      "AQ",
      +      "AR",
      +      "AS",
      +      "AT",
      +      "AU",
      +      "AW",
      +      "AX",
      +      "AZ",
      +      "BA",
      +      "BB",
      +      "BD",
      +      "BE",
      +      "BF",
      +      "BG",
      +      "BH",
      +      "BI",
      +      "BJ",
      +      "BL",
      +      "BM",
      +      "BN",
      +      "BO",
      +      "BQ",
      +      "BR",
      +      "BS",
      +      "BT",
      +      "BV",
      +      "BW",
      +      "BY",
      +      "BZ",
      +      "CA",
      +      "CC",
      +      "CD",
      +      "CF",
      +      "CG",
      +      "CH",
      +      "CI",
      +      "CK",
      +      "CL",
      +      "CM",
      +      "CN",
      +      "CO",
      +      "CR",
      +      "CU",
      +      "CV",
      +      "CW",
      +      "CX",
      +      "CY",
      +      "CZ",
      +      "DE",
      +      "DJ",
      +      "DK",
      +      "DM",
      +      "DO",
      +      "DZ",
      +      "EC",
      +      "EE",
      +      "EG",
      +      "EH",
      +      "ER",
      +      "ES",
      +      "ET",
      +      "FI",
      +      "FJ",
      +      "FK",
      +      "FM",
      +      "FO",
      +      "FR",
      +      "GA",
      +      "GB",
      +      "GD",
      +      "GE",
      +      "GF",
      +      "GG",
      +      "GH",
      +      "GI",
      +      "GL",
      +      "GM",
      +      "GN",
      +      "GP",
      +      "GQ",
      +      "GR",
      +      "GS",
      +      "GT",
      +      "GU",
      +      "GW",
      +      "GY",
      +      "HK",
      +      "HM",
      +      "HN",
      +      "HR",
      +      "HT",
      +      "HU",
      +      "ID",
      +      "IE",
      +      "IL",
      +      "IM",
      +      "IN",
      +      "IO",
      +      "IQ",
      +      "IR",
      +      "IS",
      +      "IT",
      +      "JE",
      +      "JM",
      +      "JO",
      +      "JP",
      +      "KE",
      +      "KG",
      +      "KH",
      +      "KI",
      +      "KM",
      +      "KN",
      +      "KP",
      +      "KR",
      +      "KW",
      +      "KY",
      +      "KZ",
      +      "LA",
      +      "LB",
      +      "LC",
      +      "LI",
      +      "LK",
      +      "LR",
      +      "LS",
      +      "LT",
      +      "LU",
      +      "LV",
      +      "LY",
      +      "MA",
      +      "MC",
      +      "MD",
      +      "ME",
      +      "MF",
      +      "MG",
      +      "MH",
      +      "MK",
      +      "ML",
      +      "MM",
      +      "MN",
      +      "MO",
      +      "MP",
      +      "MQ",
      +      "MR",
      +      "MS",
      +      "MT",
      +      "MU",
      +      "MV",
      +      "MW",
      +      "MX",
      +      "MY",
      +      "MZ",
      +      "NA",
      +      "NC",
      +      "NE",
      +      "NF",
      +      "NG",
      +      "NI",
      +      "NL",
      +      "NO",
      +      "NP",
      +      "NR",
      +      "NU",
      +      "NZ",
      +      "OM",
      +      "PA",
      +      "PE",
      +      "PF",
      +      "PG",
      +      "PH",
      +      "PK",
      +      "PL",
      +      "PM",
      +      "PN",
      +      "PR",
      +      "PS",
      +      "PT",
      +      "PW",
      +      "PY",
      +      "QA",
      +      "RE",
      +      "RO",
      +      "RS",
      +      "RU",
      +      "RW",
      +      "SA",
      +      "SB",
      +      "SC",
      +      "SD",
      +      "SE",
      +      "SG",
      +      "SH",
      +      "SI",
      +      "SJ",
      +      "SK",
      +      "SL",
      +      "SM",
      +      "SN",
      +      "SO",
      +      "SR",
      +      "SS",
      +      "ST",
      +      "SV",
      +      "SX",
      +      "SY",
      +      "SZ",
      +      "TC",
      +      "TD",
      +      "TF",
      +      "TG",
      +      "TH",
      +      "TJ",
      +      "TK",
      +      "TL",
      +      "TM",
      +      "TN",
      +      "TO",
      +      "TR",
      +      "TT",
      +      "TV",
      +      "TW",
      +      "TZ",
      +      "UA",
      +      "UG",
      +      "UM",
      +      "US",
      +      "UY",
      +      "UZ",
      +      "VA",
      +      "VC",
      +      "VE",
      +      "VG",
      +      "VI",
      +      "VN",
      +      "VU",
      +      "WF",
      +      "WS",
      +      "YE",
      +      "YT",
      +      "ZA",
      +      "ZM",
      +      "ZW"
      +    ],
      +    "type": "string"
      +  },
      +  "maxItems": 60,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedOutput schema / properties / metadata / properties / video / properties / seller_declared / properties / attestations / properties / faces_and_plates_blurred
      Added value: +{
      +  "description": "Whether the faces and license plates shown are blurred: NONE_SHOWN, BLURRED, PARTLY_BLURRED or NOT_BLURRED.",
      +  "enum": [
      +    "NONE_SHOWN",
      +    "BLURRED",
      +    "PARTLY_BLURRED",
      +    "NOT_BLURRED"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / metadata / properties / video / properties / seller_declared / properties / attestations / properties / location_metadata
      Added value: +{
      +  "description": "Whether the files' metadata carries GPS or other location data, which reaches the buyer with the files: NONE, PRESENT or NOT_CHECKED.",
      +  "enum": [
      +    "NONE",
      +    "PRESENT",
      +    "NOT_CHECKED"
      +  ],
      +  "type": "string"
      +}
  17. Changed6 schema fields changed
    • addedOutput schema / properties / metadata / properties / seller_hosted / properties / clip_facts
      Added value: +{
      +  "description": "Where the set's media facts, its lengths included, come from: GRAUNT_EVERY_FILE when Graunt read every file; SELLER_MANIFEST when they are the seller's manifest, with spec_check saying how many files Graunt read at random against it.",
      +  "enum": [
      +    "GRAUNT_EVERY_FILE",
      +    "SELLER_MANIFEST"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / properties / metadata / properties / seller_hosted / required
      Previous value: -[
      -  "delivered_from",
      -  "file_count",
      -  "total_bytes",
      -  "total_duration_seconds",
      -  "media",
      -  "delivery_modes",
      -  "samples",
      -  "samples_url",
      -  "access_period_days",
      -  "spec_check"
      -]New value: +[
      +  "delivered_from",
      +  "file_count",
      +  "total_bytes",
      +  "total_duration_seconds",
      +  "media",
      +  "delivery_modes",
      +  "samples",
      +  "samples_url",
      +  "access_period_days",
      +  "spec_check",
      +  "clip_facts"
      +]
    • changedOutput schema / properties / metadata / properties / video / properties / measured / properties / hours / description
      Previous value: -"The same length in hours, to one decimal place."New value: +"The same length in hours, rounded to one decimal place, so footage under three minutes reads 0. For an exact amount, use eligible_duration_seconds."
    • addedOutput schema / properties / metadata / properties / video / properties / per_hour / properties / categories / items / properties / eligible_duration_seconds / description
      Added value: +"This category's seconds of video, exact; its price is computed from them."
    • addedOutput schema / properties / metadata / properties / video / properties / per_hour / properties / categories / items / properties / hours / description
      Added value: +"The same length in hours, rounded to one decimal place. For an exact amount, use eligible_duration_seconds."
    • changedOutput schema / properties / metadata / properties / video / properties / seller_declared / properties / sublicense / description
      Previous value: -"ONE_CLIENT_PREAUTHORIZED: the buyer may pass the data through to one client, named privately at purchase in sublicense_client, for that client's use within the license; the buyer makes no use of it for itself. The license itself stays non-transferable."New value: +"ONE_CLIENT_PREAUTHORIZED (every listing created under Marketplace License 2.1, and every older listing whose seller has agreed to it): the buyer may pass the data through to one client, named privately at purchase in sublicense_client, for that client's use within the license; the buyer makes no use of it for itself. The license itself stays non-transferable."
  18. Changed2 schema fields changed
    • changedOutput schema / properties / metadata / properties / delivery_methods / items / properties / source / enum
      Previous value: -[
      -  "GRAUNT",
      -  "S3"
      -]New value: +[
      +  "GRAUNT",
      +  "S3",
      +  "S3_COMPATIBLE"
      +]
    • changedOutput schema / properties / metadata / properties / seller_hosted / properties / total_duration_seconds / description
      Previous value: -"Seconds of audio and video in the set."New value: +"Seconds of the set's video clips (files with a length, a width and a height) when it has any; a set with no clips counts every file with a length, its audio."
  19. Changed1 schema field changed
    • addedOutput schema / properties / metadata / properties / samples
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "What anyone may look at before buying, with the sentence shown beside every sample. files: sample files Graunt holds, each with the API path that answers with a link of at most 5 minutes. detail_fields: the listing detail's other sample fields, by name. Absent when the listing has no samples.",
      +  "properties": {
      +    "detail_fields": {
      +      "items": {
      +        "enum": [
      +          "preview",
      +          "content_excerpt",
      +          "preview_clips"
      +        ],
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "files": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "bytes": {
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "content_path": {
      +            "type": "string"
      +          },
      +          "content_type": {
      +            "type": "string"
      +          },
      +          "id": {
      +            "format": "uuid",
      +            "type": "string"
      +          },
      +          "kind": {
      +            "enum": [
      +              "IMAGE",
      +              "VIDEO",
      +              "AUDIO",
      +              "TEXT",
      +              "FILE"
      +            ],
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "bytes",
      +          "content_type",
      +          "kind",
      +          "content_path"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "notice": {
      +      "enum": [
      +        "Samples are for evaluating this listing. The license to use the data comes with the purchase."
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "notice",
      +    "files",
      +    "detail_fields"
      +  ],
      +  "type": "object"
      +}
  20. Changed1 schema field changed
    • addedOutput schema / properties / metadata / properties / video / properties / per_hour / properties / categories
      Added value: +{
      +  "description": "Present when the listing can be bought by category: each category's measured hours and its price bought on its own, at the listing's rate with the tier its own hours reach. An order of several categories is priced on their combined hours; every category is the whole listing at price_cents.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "eligible_duration_seconds": {
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "hours": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "price_cents": {
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "subject": {
      +        "enum": [
      +          "PEOPLE_TALKING",
      +          "PEOPLE_IN_ACTION",
      +          "PEOPLE_HANDLING_OBJECTS",
      +          "HOW_TO_AND_TASKS",
      +          "SPORTS_AND_FITNESS",
      +          "MUSIC_AND_PERFORMANCE",
      +          "ANIMALS",
      +          "NATURE",
      +          "CITIES_AND_BUILDINGS",
      +          "DRIVING_AND_TRANSPORTATION",
      +          "INDUSTRY_AND_WORK_SITES",
      +          "FOOD_AND_COOKING",
      +          "PRODUCTS_AND_RETAIL",
      +          "ANIMATION",
      +          "VIDEO_GAMES"
      +        ],
      +        "type": "string"
      +      },
      +      "tier_applied": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "discount_bps": {
      +            "description": "Discount in basis points (1000 = 10%).",
      +            "maximum": 9000,
      +            "minimum": 1,
      +            "type": "integer"
      +          },
      +          "min_hours": {
      +            "description": "Hours in the order from which the tier applies.",
      +            "minimum": 1,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "min_hours",
      +          "discount_bps"
      +        ],
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "subject",
      +      "eligible_duration_seconds",
      +      "hours",
      +      "tier_applied",
      +      "price_cents"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 15,
      +  "minItems": 2,
      +  "type": "array"
      +}
  21. Changed1 schema field changed
    • addedOutput schema / properties / metadata / properties / delivery_methods
      Added value: +{
      +  "description": "How the files reach a buyer, one row per way: the method and the source the files come from (GRAUNT: storage Graunt holds).",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "method": {
      +        "enum": [
      +          "KEY_ACCESS",
      +          "DOWNLOAD"
      +        ],
      +        "type": "string"
      +      },
      +      "source": {
      +        "enum": [
      +          "GRAUNT",
      +          "S3"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "method",
      +      "source"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  22. Changed2 schema fields changed
    • changedOutput schema / properties / metadata / properties / video / properties / seller_declared / properties / attestations / properties / identifiable_minors / description
      Previous value: -"Whether anyone under 16 can be identified in the content."New value: +"Whether anyone under 18 can be identified in the content."
    • addedOutput schema / properties / metadata / properties / video / properties / seller_declared / properties / attestations / properties / identifiable_minors_age
      Added value: +{
      +  "const": 18,
      +  "description": "The age identifiable_minors was answered against: 18. A false identifiable_minors counts only with it.",
      +  "type": "integer"
      +}
  23. Changed1 schema field changed
    • addedOutput schema / properties / metadata / properties / seller_hosted
      Added value: +{
      +  "description": "Present only on a listing whose files are delivered from the seller's storage after purchase: file count, bytes, media facts, delivery modes and samples. Never a link to a file.",
      +  "properties": {
      +    "access_period_days": {
      +      "description": "Days the buyer can get the files once they are available; the buyer copies the set within them.",
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "delivered_from": {
      +      "enum": [
      +        "seller_storage"
      +      ],
      +      "type": "string"
      +    },
      +    "delivery_modes": {
      +      "description": "How the buyer can receive the files. LINKS: a download link per file.",
      +      "items": {
      +        "enum": [
      +          "LINKS"
      +        ],
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "file_count": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "media": {
      +      "description": "Null when the set holds no audio or video. Frame rates are frames per second; clip lengths are whole seconds.",
      +      "properties": {
      +        "files_with_audio": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "max_clip_seconds": {
      +          "minimum": 0,
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "max_fps": {
      +          "minimum": 0,
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "max_height": {
      +          "minimum": 0,
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "max_width": {
      +          "minimum": 0,
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "media_files": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "min_clip_seconds": {
      +          "minimum": 0,
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "min_fps": {
      +          "minimum": 0,
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "min_height": {
      +          "minimum": 0,
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "min_width": {
      +          "minimum": 0,
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "video_codecs": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "video_files": {
      +          "minimum": 0,
      +          "type": "integer"
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "samples": {
      +      "description": "Sample files a buyer can look at before buying.",
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "samples_url": {
      +      "description": "The public route that lists the samples.",
      +      "type": "string"
      +    },
      +    "spec_check": {
      +      "description": "Files Graunt read at random from the full set and compared with the manifest's media facts, and how many matched. Null when none were read.",
      +      "properties": {
      +        "checked": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "matched": {
      +          "minimum": 0,
      +          "type": "integer"
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "total_bytes": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "total_duration_seconds": {
      +      "description": "Seconds of audio and video in the set.",
      +      "minimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "delivered_from",
      +    "file_count",
      +    "total_bytes",
      +    "total_duration_seconds",
      +    "media",
      +    "delivery_modes",
      +    "samples",
      +    "samples_url",
      +    "access_period_days",
      +    "spec_check"
      +  ],
      +  "type": "object"
      +}
  24. Changed1 schema field changed
    • changedOutput schema / properties / metadata / properties / video / properties / per_hour / properties / price_cents / description
      Previous value: -"The listing price, subtotal_cents minus discount_cents: what checkout charges before the processing fee."New value: +"The listing price, subtotal_cents minus discount_cents: what checkout charges before any sales tax."
  25. Changed2 schema fields changed
    • addedOutput schema / properties / metadata / properties / ai_generation
      Added value: +{
      +  "description": "The seller's AI-generation declaration: extent NONE (not AI-generated), PARTIAL (with share_percent and description) or FULL. A seller declaration, not a Graunt finding; absent when the seller has not declared.",
      +  "properties": {
      +    "description": {
      +      "type": "string"
      +    },
      +    "extent": {
      +      "enum": [
      +        "NONE",
      +        "PARTIAL",
      +        "FULL"
      +      ],
      +      "type": "string"
      +    },
      +    "share_percent": {
      +      "maximum": 99,
      +      "minimum": 1,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "extent"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / metadata / properties / video
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Present only on a video listing: subjects, the hours Graunt measured, the per-hour price with its volume tiers, and the seller's declarations (people on camera, releases, sublicense), kept apart.",
      +  "properties": {
      +    "barred_uses": {
      +      "description": "Uses no license permits for this footage, whatever else the listing allows. Present when the footage shows people.",
      +      "items": {
      +        "enum": [
      +          "person_likeness_use",
      +          "voice_clone",
      +          "deepfake_use",
      +          "biometric_identification"
      +        ],
      +        "type": "string"
      +      },
      +      "maxItems": 4,
      +      "type": "array"
      +    },
      +    "camera_views": {
      +      "description": "How the footage was shot, from the closed camera-view list; empty when none was given. Filter with camera_view on GET /v1/listings.",
      +      "items": {
      +        "enum": [
      +          "FIRST_PERSON",
      +          "AERIAL_OR_DRONE",
      +          "VEHICLE_OR_DASHCAM",
      +          "FIXED_CAMERA",
      +          "OTHER"
      +        ],
      +        "type": "string"
      +      },
      +      "maxItems": 5,
      +      "type": "array"
      +    },
      +    "measured": {
      +      "additionalProperties": false,
      +      "description": "What Graunt measured from the files; null when it measured none.",
      +      "properties": {
      +        "eligible_duration_seconds": {
      +          "description": "Seconds of video a buyer of the whole listing receives and pays for.",
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "hours": {
      +          "description": "The same length in hours, to one decimal place.",
      +          "minimum": 0,
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "eligible_duration_seconds",
      +        "hours"
      +      ],
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "media_kind": {
      +      "enum": [
      +        "VIDEO"
      +      ],
      +      "type": "string"
      +    },
      +    "per_hour": {
      +      "additionalProperties": false,
      +      "description": "The per-hour price, or null when the listing has a flat price. The seller sets the rate. The volume tier is applied automatically from the hours in the order; there is no code and nothing to request. All amounts are integer cents.",
      +      "properties": {
      +        "currency": {
      +          "const": "usd"
      +        },
      +        "discount_cents": {
      +          "description": "floor(subtotal_cents × the applied tier's discount_bps / 10000).",
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "price_cents": {
      +          "description": "The listing price, subtotal_cents minus discount_cents: what checkout charges before the processing fee.",
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "price_per_hour_cents": {
      +          "description": "The seller's rate.",
      +          "minimum": 1,
      +          "type": "integer"
      +        },
      +        "rate_class": {
      +          "enum": [
      +            "BASIC",
      +            "STANDARD",
      +            "PREMIUM",
      +            "NATIVE_1080P",
      +            "NATIVE_4K",
      +            "ARCHIVAL"
      +          ],
      +          "type": "string"
      +        },
      +        "subtotal_cents": {
      +          "description": "floor(eligible_duration_seconds × price_per_hour_cents / 3600).",
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "tier_applied": {
      +          "additionalProperties": false,
      +          "description": "The tier this listing's hours reach; null when they reach none.",
      +          "properties": {
      +            "discount_bps": {
      +              "description": "Discount in basis points (1000 = 10%).",
      +              "maximum": 9000,
      +              "minimum": 1,
      +              "type": "integer"
      +            },
      +            "min_hours": {
      +              "description": "Hours in the order from which the tier applies.",
      +              "minimum": 1,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "min_hours",
      +            "discount_bps"
      +          ],
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        },
      +        "volume_tiers": {
      +          "description": "This listing's volume schedule, lowest tier first: a term of the listing, recorded in every purchase. The seller funds each discount.",
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "discount_bps": {
      +                "description": "Discount in basis points (1000 = 10%).",
      +                "maximum": 9000,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "min_hours": {
      +                "description": "Hours in the order from which the tier applies.",
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "min_hours",
      +              "discount_bps"
      +            ],
      +            "type": "object"
      +          },
      +          "maxItems": 5,
      +          "type": "array"
      +        }
      +      },
      +      "required": [
      +        "rate_class",
      +        "price_per_hour_cents",
      +        "currency",
      +        "volume_tiers",
      +        "tier_applied",
      +        "subtotal_cents",
      +        "discount_cents",
      +        "price_cents"
      +      ],
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "seller_declared": {
      +      "additionalProperties": false,
      +      "description": "The seller's declarations, kept apart from what Graunt measured. Never Graunt's findings.",
      +      "properties": {
      +        "attestations": {
      +          "additionalProperties": false,
      +          "description": "What the seller declares about the material, recorded as the seller declared it. Graunt does not compute these.",
      +          "properties": {
      +            "event_or_venue_rights_status": {
      +              "description": "Events and venues.",
      +              "enum": [
      +                "NOT_APPLICABLE",
      +                "SELLER_ATTESTED",
      +                "EVIDENCE_ON_FILE",
      +                "INCOMPLETE"
      +              ],
      +              "type": "string"
      +            },
      +            "guardian_releases_on_file": {
      +              "description": "Whether the releases on file include a parent's or guardian's release for each minor shown.",
      +              "type": "boolean"
      +            },
      +            "identifiable_minors": {
      +              "description": "Whether anyone under 16 can be identified in the content.",
      +              "type": "boolean"
      +            },
      +            "music_audio_rights_status": {
      +              "description": "Music and audio.",
      +              "enum": [
      +                "NOT_APPLICABLE",
      +                "SELLER_ATTESTED",
      +                "EVIDENCE_ON_FILE",
      +                "INCOMPLETE"
      +              ],
      +              "type": "string"
      +            },
      +            "native_resolution": {
      +              "description": "The lowest native resolution in the listing.",
      +              "enum": [
      +                "SD",
      +                "HD_720P",
      +                "FHD_1080P",
      +                "QHD_1440P",
      +                "UHD_4K",
      +                "UHD_8K"
      +              ],
      +              "type": "string"
      +            },
      +            "people_on_camera": {
      +              "description": "How people appear: SUBJECT (the footage is about them) or INCIDENTAL (in passing, in a crowd).",
      +              "enum": [
      +                "INCIDENTAL",
      +                "SUBJECT"
      +              ],
      +              "type": "string"
      +            },
      +            "person_release_status": {
      +              "description": "Releases from the people shown. INCOMPLETE is allowed only when people appear incidentally.",
      +              "enum": [
      +                "NOT_APPLICABLE",
      +                "SELLER_ATTESTED",
      +                "EVIDENCE_ON_FILE",
      +                "INCOMPLETE"
      +              ],
      +              "type": "string"
      +            },
      +            "property_release_status": {
      +              "description": "Private property shown.",
      +              "enum": [
      +                "NOT_APPLICABLE",
      +                "SELLER_ATTESTED",
      +                "EVIDENCE_ON_FILE",
      +                "INCOMPLETE"
      +              ],
      +              "type": "string"
      +            },
      +            "third_party_ip_status": {
      +              "description": "Third-party marks and designs.",
      +              "enum": [
      +                "NOT_APPLICABLE",
      +                "SELLER_ATTESTED",
      +                "EVIDENCE_ON_FILE",
      +                "INCOMPLETE"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        },
      +        "depicts_person": {
      +          "description": "Whether the seller says people appear in the footage.",
      +          "type": "boolean"
      +        },
      +        "sublicense": {
      +          "description": "ONE_CLIENT_PREAUTHORIZED: the buyer may pass the data through to one client, named privately at purchase in sublicense_client, for that client's use within the license; the buyer makes no use of it for itself. The license itself stays non-transferable.",
      +          "enum": [
      +            "NONE",
      +            "ONE_CLIENT_PREAUTHORIZED"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "depicts_person",
      +        "sublicense",
      +        "attestations"
      +      ],
      +      "type": "object"
      +    },
      +    "subjects": {
      +      "description": "What the footage shows, from the closed video-subject list. Filter with video_subject on GET /v1/listings.",
      +      "items": {
      +        "enum": [
      +          "PEOPLE_TALKING",
      +          "PEOPLE_IN_ACTION",
      +          "PEOPLE_HANDLING_OBJECTS",
      +          "HOW_TO_AND_TASKS",
      +          "SPORTS_AND_FITNESS",
      +          "MUSIC_AND_PERFORMANCE",
      +          "ANIMALS",
      +          "NATURE",
      +          "CITIES_AND_BUILDINGS",
      +          "DRIVING_AND_TRANSPORTATION",
      +          "INDUSTRY_AND_WORK_SITES",
      +          "FOOD_AND_COOKING",
      +          "PRODUCTS_AND_RETAIL",
      +          "ANIMATION",
      +          "VIDEO_GAMES"
      +        ],
      +        "type": "string"
      +      },
      +      "maxItems": 15,
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "media_kind",
      +    "subjects",
      +    "camera_views",
      +    "measured",
      +    "per_hour",
      +    "seller_declared",
      +    "barred_uses"
      +  ],
      +  "type": "object"
      +}
  26. Changed3 schema fields changed
    • addedOutput schema / properties / metadata / properties / files
      Added value: +{
      +  "description": "Present when the packet downloads without an account: one entry per listed file (at most 100; files_not_listed counts the rest). inline says how much of the file the text shows (up to 200 KB of text in all); download_url works until download_expires_at. Images, audio and video carry no link here and download from the packet's public URL.",
      +  "items": {
      +    "properties": {
      +      "download_expires_at": {
      +        "type": "string"
      +      },
      +      "download_url": {
      +        "type": "string"
      +      },
      +      "format": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "inline": {
      +        "enum": [
      +          "FULL",
      +          "PARTIAL",
      +          "NONE"
      +        ],
      +        "type": "string"
      +      },
      +      "inline_bytes": {
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "size_bytes": {
      +        "minimum": 0,
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "name",
      +      "format",
      +      "size_bytes",
      +      "inline",
      +      "inline_bytes"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / metadata / properties / files_not_listed
      Added value: +{
      +  "description": "Present when the packet has more files than one fetch lists (100): how many more there are. They download from the packet's public URL.",
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / metadata / properties / files_note
      Added value: +{
      +  "description": "Why the files could not be returned right now (for example a rate limit), in plain words.",
      +  "type": "string"
      +}
  27. Changed3 schema fields changed
    • addedOutput schema / properties / metadata / properties
      Added value: +{
      +  "acquisition_mode": {
      +    "type": "string"
      +  },
      +  "asset_class": {
      +    "type": "string"
      +  },
      +  "category": {
      +    "type": "string"
      +  },
      +  "currency": {
      +    "enum": [
      +      "usd"
      +    ],
      +    "type": "string"
      +  },
      +  "free_access_grant_url": {
      +    "description": "Present only when the packet can be taken with no account: POST it for a short-lived grant, then GET the download_url in its response.",
      +    "type": "string"
      +  },
      +  "payment_required": {
      +    "type": "boolean"
      +  },
      +  "price_cents": {
      +    "minimum": 0,
      +    "type": "integer"
      +  },
      +  "publisher": {
      +    "type": "string"
      +  },
      +  "registration_required": {
      +    "type": "boolean"
      +  },
      +  "rights_passport_summary": {
      +    "properties": {
      +      "citation_required": {
      +        "type": "boolean"
      +      },
      +      "license_family": {
      +        "type": "string"
      +      },
      +      "no_redistribute": {
      +        "type": "boolean"
      +      },
      +      "no_train": {
      +        "type": "boolean"
      +      },
      +      "personal_data_sensitive": {
      +        "type": "boolean"
      +      },
      +      "redistribution_allowed": {
      +        "type": "boolean"
      +      },
      +      "training_allowed": {
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "license_family",
      +      "training_allowed",
      +      "redistribution_allowed",
      +      "citation_required",
      +      "no_train",
      +      "no_redistribute",
      +      "personal_data_sensitive"
      +    ],
      +    "type": "object"
      +  }
      +}
    • addedOutput schema / properties / metadata / required
      Added value: +[
      +  "price_cents",
      +  "currency",
      +  "acquisition_mode",
      +  "registration_required",
      +  "payment_required",
      +  "rights_passport_summary"
      +]
    • changedOutput schema / required
      Previous value: -[
      -  "id",
      -  "title",
      -  "text",
      -  "url"
      -]New value: +[
      +  "id",
      +  "title",
      +  "text",
      +  "url",
      +  "metadata"
      +]
  28. First observed

TDQS

A3.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the readOnly/openWorld annotations, it discloses behavior an agent could not otherwise anticipate: files are only returned for free, no-account packets, file downloads are short-lived links, listing is capped at 100 with files_not_listed counting the remainder, and video listings add computed per-hour pricing. These are exactly the operational traits that affect planning.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in the first sentence and the remaining sentences each add a distinct conditional behavior. It is somewhat dense, and the enumeration of text file types (CSV, JSON, Markdown, text and similar) is filler given that an output schema exists.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The behavioral coverage is strong, but with an output schema present the description spends most of its length restating return fields rather than covering what the schema cannot — notably how to obtain a valid id or what errors look like for an unknown id.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Only one parameter, and the schema already documents it at 100% coverage ("The packet listing id"). The description repeats "by id" but adds no format, source, or validation detail beyond the schema, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

"Read one Graunt catalog packet by id" gives a specific verb (read), a specific resource (catalog packet), and a cardinality/scope (one, by id) that separates it from the search-family siblings. It does not explicitly name an alternative tool, so it stops short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied rather than stated: an agent can infer this is the by-id lookup to run after finding a listing via search, but the description never says so, nor when not to use it. The conditional branches (free packet needing no account, video listings) clarify outcomes rather than tool selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources