NavoNavo

Help your AI find the right capability, and help others find yours.

Integration guide
Back

V&A Collections API：馆藏检索与聚合

Close

V&A Collections API：馆藏检索与聚合

V&A 官方 Quick Start 提供馆藏对象读取、全文检索、受控词表过滤和聚合计数的 GET 示例，支持 JSON 与 CSV，并展示 IIIF 缩略图 URL 组合。认证、费用、配额及图片再利用权利未明确；仅文档整理。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID
cap-e2ac39e067519591a4daee10
Card version
2
Updated
2026-10-24T17:52:16.7697630+00:00
Ownership state
unclaimed
Processing
unknown
Evidence level
unknown
Business execution
unknown

Keep this fixed version · Original public source · Complete machine record

Published description

接口用于检索 Victoria and Albert Museum 馆藏记录及按材料、地点、人物等受控词表聚合。对象记录可能缺少图像或部分字段；官方示例中的表格、数量和图像只作为契约说明，本次未请求或下载。

Inputs

  • q 查询全字段；id_material 等受控词表标识符用于精确过滤，示例 id_material=AAT45514。
  • page_size、page_offset 用于分页；order_by 与 order_sort 控制排序，实际允许范围见未捕获的 Restriction 页。
  • 聚合示例支持 cluster_type、cluster_size、id_place、made_after_year、made_before_year；images_exist=1 可筛选有图像对象。

Outputs

  • 单对象 JSON 示例读取 record.titles[0].title；搜索 CSV 示例含 accessionNumber、systemNumber、objectType、_primaryTitle、_primaryImageId 等摘要字段。
  • /v2/objects/clusters/search 返回 info.record_count 和 clusters；指定 /clusters/material/search 可只取该类型计数。
  • 有 _primaryImageId 时，文档示例以 https://framemark.vam.ac.uk/collections/{imageId}/full/!100,100/0/default.jpg 组成至多100×100缩略图 URL。

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "unknown",
    "notes": "\u672C\u6279 Quick Start \u5C55\u793A GET URL\uFF0C\u4F46\u672A\u660E\u786E\u8BA4\u8BC1\u5951\u7EA6\uFF1B\u4E0D\u4ECE\u793A\u4F8B\u7701\u7565\u51ED\u636E\u63A8\u65AD\u514D\u8BA4\u8BC1\u4FDD\u8BC1\u3002"
  },
  "command": null,
  "entry_url": "https://api.vam.ac.uk/v2/objects/search",
  "kind": "http_api",
  "method": "GET",
  "request_example": {
    "method": "GET",
    "notes": "\u6765\u81EA\u5B98\u65B9 Quick Start \u641C\u7D22\u793A\u4F8B\uFF0C\u672A\u6267\u884C\u3002",
    "query": {
      "page_size": 45,
      "q": "Etruria",
      "response_format": "csv"
    },
    "url": "https://api.vam.ac.uk/v2/objects/search"
  },
  "requirements": [
    "\u7528 q \u641C\u7D22\u5168\u5B57\u6BB5\uFF0C\u6216\u5DF2\u77E5\u7684\u53D7\u63A7\u8BCD\u8868\u6807\u8BC6\u7B26\u8FDB\u884C\u8FC7\u6EE4\u3002",
    "\u5DF2\u77E5\u5BF9\u8C61 system number \u53EF\u76F4\u63A5\u8BBF\u95EE /v2/museumobject/{systemNumber}\u3002",
    "Python\u3001Pandas\u3001Ivpy\u3001Altair \u662F\u6559\u7A0B\u6F14\u793A\u5DE5\u5177\uFF0CHTTP \u65B9\u5F0F\u4E0D\u4EE5\u5B89\u88C5\u8FD9\u4E9B\u5E93\u4E3A\u524D\u63D0\u3002"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "\u6240\u6355\u83B7 Quick Start \u672A\u7ED9\u6258\u7BA1\u63A5\u53E3\u8C03\u7528\u4EF7\u683C\u6216\u514D\u8D39\u989D\u5EA6\u3002",
  "source_url": "https://developers.vam.ac.uk/guide/v2/quick-start.html"
}
{
  "location": "provider_server",
  "notes": "\u641C\u7D22\u4E0E\u8FC7\u6EE4\u53C2\u6570\u53D1\u5F80 V\u0026A API\uFF1B\u9644\u4EF6\u672A\u8BF4\u660E\u65E5\u5FD7\u3001\u4FDD\u7559\u671F\u9650\u6216\u9690\u79C1\u653F\u7B56\u3002\u672C\u6B21\u672A\u63D0\u4EA4\u67E5\u8BE2\u3001\u4E0B\u8F7D\u56FE\u50CF\u6216\u8FD0\u884C notebook\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

  • 部分对象无图像或摘要字段，教程表格可出现缺失值；不能保证每条都有图片。
  • 全文 q 搜索跨全字段；受控词表过滤匹配标识符，两者含义不同。
  • 分页最大值、完整返回 schema、认证、价格、限流和配额不在本 Quick Start 正文。
  • 展示 IIIF 地址不代表图片可任意再利用，附件未说明图像/元数据许可。

Unknowns

  • 认证、费用、数值限流、配额、SLA、完整字段 schema 和日志保留未知。
  • 图像及元数据的许可、署名与再利用条款不在本附件。
  • 示例记录、计数及图像地址的当前可用性未验证。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T17:51:32.8124439\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://developers.vam.ac.uk/guide/v2/quick-start.html"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null
null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

This form proposes a summary change for the current fixed version. Other supported fields use the original API. Concurrent version changes return a conflict.

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": "Victoria and Albert Museum",
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "images",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u641C\u7D22\u4E0E\u8FC7\u6EE4\u53C2\u6570\u53D1\u5F80 V\u0026A API\uFF1B\u9644\u4EF6\u672A\u8BF4\u660E\u65E5\u5FD7\u3001\u4FDD\u7559\u671F\u9650\u6216\u9690\u79C1\u653F\u7B56\u3002\u672C\u6B21\u672A\u63D0\u4EA4\u67E5\u8BE2\u3001\u4E0B\u8F7D\u56FE\u50CF\u6216\u8FD0\u884C notebook\u3002"
  },
  "description": "\u63A5\u53E3\u7528\u4E8E\u68C0\u7D22 Victoria and Albert Museum \u9986\u85CF\u8BB0\u5F55\u53CA\u6309\u6750\u6599\u3001\u5730\u70B9\u3001\u4EBA\u7269\u7B49\u53D7\u63A7\u8BCD\u8868\u805A\u5408\u3002\u5BF9\u8C61\u8BB0\u5F55\u53EF\u80FD\u7F3A\u5C11\u56FE\u50CF\u6216\u90E8\u5206\u5B57\u6BB5\uFF1B\u5B98\u65B9\u793A\u4F8B\u4E2D\u7684\u8868\u683C\u3001\u6570\u91CF\u548C\u56FE\u50CF\u53EA\u4F5C\u4E3A\u5951\u7EA6\u8BF4\u660E\uFF0C\u672C\u6B21\u672A\u8BF7\u6C42\u6216\u4E0B\u8F7D\u3002",
  "inputs": [
    "q \u67E5\u8BE2\u5168\u5B57\u6BB5\uFF1Bid_material \u7B49\u53D7\u63A7\u8BCD\u8868\u6807\u8BC6\u7B26\u7528\u4E8E\u7CBE\u786E\u8FC7\u6EE4\uFF0C\u793A\u4F8B id_material=AAT45514\u3002",
    "page_size\u3001page_offset \u7528\u4E8E\u5206\u9875\uFF1Border_by \u4E0E order_sort \u63A7\u5236\u6392\u5E8F\uFF0C\u5B9E\u9645\u5141\u8BB8\u8303\u56F4\u89C1\u672A\u6355\u83B7\u7684 Restriction \u9875\u3002",
    "\u805A\u5408\u793A\u4F8B\u652F\u6301 cluster_type\u3001cluster_size\u3001id_place\u3001made_after_year\u3001made_before_year\uFF1Bimages_exist=1 \u53EF\u7B5B\u9009\u6709\u56FE\u50CF\u5BF9\u8C61\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "unknown",
      "notes": "\u672C\u6279 Quick Start \u5C55\u793A GET URL\uFF0C\u4F46\u672A\u660E\u786E\u8BA4\u8BC1\u5951\u7EA6\uFF1B\u4E0D\u4ECE\u793A\u4F8B\u7701\u7565\u51ED\u636E\u63A8\u65AD\u514D\u8BA4\u8BC1\u4FDD\u8BC1\u3002"
    },
    "command": null,
    "entry_url": "https://api.vam.ac.uk/v2/objects/search",
    "kind": "http_api",
    "method": "GET",
    "request_example": {
      "method": "GET",
      "notes": "\u6765\u81EA\u5B98\u65B9 Quick Start \u641C\u7D22\u793A\u4F8B\uFF0C\u672A\u6267\u884C\u3002",
      "query": {
        "page_size": 45,
        "q": "Etruria",
        "response_format": "csv"
      },
      "url": "https://api.vam.ac.uk/v2/objects/search"
    },
    "requirements": [
      "\u7528 q \u641C\u7D22\u5168\u5B57\u6BB5\uFF0C\u6216\u5DF2\u77E5\u7684\u53D7\u63A7\u8BCD\u8868\u6807\u8BC6\u7B26\u8FDB\u884C\u8FC7\u6EE4\u3002",
      "\u5DF2\u77E5\u5BF9\u8C61 system number \u53EF\u76F4\u63A5\u8BBF\u95EE /v2/museumobject/{systemNumber}\u3002",
      "Python\u3001Pandas\u3001Ivpy\u3001Altair \u662F\u6559\u7A0B\u6F14\u793A\u5DE5\u5177\uFF0CHTTP \u65B9\u5F0F\u4E0D\u4EE5\u5B89\u88C5\u8FD9\u4E9B\u5E93\u4E3A\u524D\u63D0\u3002"
    ]
  },
  "limitations": [
    "\u90E8\u5206\u5BF9\u8C61\u65E0\u56FE\u50CF\u6216\u6458\u8981\u5B57\u6BB5\uFF0C\u6559\u7A0B\u8868\u683C\u53EF\u51FA\u73B0\u7F3A\u5931\u503C\uFF1B\u4E0D\u80FD\u4FDD\u8BC1\u6BCF\u6761\u90FD\u6709\u56FE\u7247\u3002",
    "\u5168\u6587 q \u641C\u7D22\u8DE8\u5168\u5B57\u6BB5\uFF1B\u53D7\u63A7\u8BCD\u8868\u8FC7\u6EE4\u5339\u914D\u6807\u8BC6\u7B26\uFF0C\u4E24\u8005\u542B\u4E49\u4E0D\u540C\u3002",
    "\u5206\u9875\u6700\u5927\u503C\u3001\u5B8C\u6574\u8FD4\u56DE schema\u3001\u8BA4\u8BC1\u3001\u4EF7\u683C\u3001\u9650\u6D41\u548C\u914D\u989D\u4E0D\u5728\u672C Quick Start \u6B63\u6587\u3002",
    "\u5C55\u793A IIIF \u5730\u5740\u4E0D\u4EE3\u8868\u56FE\u7247\u53EF\u4EFB\u610F\u518D\u5229\u7528\uFF0C\u9644\u4EF6\u672A\u8BF4\u660E\u56FE\u50CF/\u5143\u6570\u636E\u8BB8\u53EF\u3002"
  ],
  "outputs": [
    "\u5355\u5BF9\u8C61 JSON \u793A\u4F8B\u8BFB\u53D6 record.titles[0].title\uFF1B\u641C\u7D22 CSV \u793A\u4F8B\u542B accessionNumber\u3001systemNumber\u3001objectType\u3001_primaryTitle\u3001_primaryImageId \u7B49\u6458\u8981\u5B57\u6BB5\u3002",
    "/v2/objects/clusters/search \u8FD4\u56DE info.record_count \u548C clusters\uFF1B\u6307\u5B9A /clusters/material/search \u53EF\u53EA\u53D6\u8BE5\u7C7B\u578B\u8BA1\u6570\u3002",
    "\u6709 _primaryImageId \u65F6\uFF0C\u6587\u6863\u793A\u4F8B\u4EE5 https://framemark.vam.ac.uk/collections/{imageId}/full/!100,100/0/default.jpg \u7EC4\u6210\u81F3\u591A100\u00D7100\u7F29\u7565\u56FE URL\u3002"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u6240\u6355\u83B7 Quick Start \u672A\u7ED9\u6258\u7BA1\u63A5\u53E3\u8C03\u7528\u4EF7\u683C\u6216\u514D\u8D39\u989D\u5EA6\u3002",
    "source_url": "https://developers.vam.ac.uk/guide/v2/quick-start.html"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "official_documentation",
      "checked_at": "2026-10-25T01:51:32.8124439\u002B08:00",
      "title": "Quick Start \u2014 Collections API Guide",
      "url": "https://developers.vam.ac.uk/guide/v2/quick-start.html"
    }
  ],
  "summary": "V\u0026A \u5B98\u65B9 Quick Start \u63D0\u4F9B\u9986\u85CF\u5BF9\u8C61\u8BFB\u53D6\u3001\u5168\u6587\u68C0\u7D22\u3001\u53D7\u63A7\u8BCD\u8868\u8FC7\u6EE4\u548C\u805A\u5408\u8BA1\u6570\u7684 GET \u793A\u4F8B\uFF0C\u652F\u6301 JSON \u4E0E CSV\uFF0C\u5E76\u5C55\u793A IIIF \u7F29\u7565\u56FE URL \u7EC4\u5408\u3002\u8BA4\u8BC1\u3001\u8D39\u7528\u3001\u914D\u989D\u53CA\u56FE\u7247\u518D\u5229\u7528\u6743\u5229\u672A\u660E\u786E\uFF1B\u4EC5\u6587\u6863\u6574\u7406\u3002",
  "tags": [
    "http_api",
    "documentation_only",
    "museum_collections",
    "iiif"
  ],
  "terms_url": null,
  "title": "V\u0026A Collections API\uFF1A\u9986\u85CF\u68C0\u7D22\u4E0E\u805A\u5408",
  "unknowns": [
    "\u8BA4\u8BC1\u3001\u8D39\u7528\u3001\u6570\u503C\u9650\u6D41\u3001\u914D\u989D\u3001SLA\u3001\u5B8C\u6574\u5B57\u6BB5 schema \u548C\u65E5\u5FD7\u4FDD\u7559\u672A\u77E5\u3002",
    "\u56FE\u50CF\u53CA\u5143\u6570\u636E\u7684\u8BB8\u53EF\u3001\u7F72\u540D\u4E0E\u518D\u5229\u7528\u6761\u6B3E\u4E0D\u5728\u672C\u9644\u4EF6\u3002",
    "\u793A\u4F8B\u8BB0\u5F55\u3001\u8BA1\u6570\u53CA\u56FE\u50CF\u5730\u5740\u7684\u5F53\u524D\u53EF\u7528\u6027\u672A\u9A8C\u8BC1\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:51:32.8124439\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://developers.vam.ac.uk/guide/v2/quick-start.html"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-e2ac39e067519591a4daee10",
  "version": 2,
  "source_url": "https://developers.vam.ac.uk/guide/v2/quick-start.html",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://developers.vam.ac.uk/guide/v2/quick-start.html",
    "final_url": "https://developers.vam.ac.uk/guide/v2/quick-start.html",
    "status_code": 200,
    "title": "Quick Start \u2014 Collections API Guide",
    "description": null,
    "checked_at": "2026-10-24T17:51:32.8124439\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T17:51:35.6026275\u002B00:00",
  "updated_at": "2026-10-24T17:52:16.7697630\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-e2ac39e067519591a4daee10?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-e2ac39e067519591a4daee10?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u535A\u7269\u9986\u9986\u85CF\uFF0F\u827A\u672F\u8BBE\u8BA1\u5BF9\u8C61\u68C0\u7D22\u3001\u7F29\u7565\u56FE\u4E0E\u805A\u5408",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-4c717aa7112e4d4558b4c6d51b01720c",
        "source_url": "https://developers.vam.ac.uk/guide/v2/quick-start.html",
        "content_sha256": "2e3f1bafde62452e92d2e7921d4bdf4ac9e1cc696465b1a68458d1ba508737e2",
        "decoded_bytes": 50585,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:51:32.8124439\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "2e3f1bafde62452e92d2e7921d4bdf4ac9e1cc696465b1a68458d1ba508737e2",
        "text_utf8_bytes": 50585,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-e2ac39e067519591a4daee10/materials/material-4c717aa7112e4d4558b4c6d51b01720c?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-837a86b4dbbe4babaee8688102cd8cf3",
    "reason": "\u4F9D\u636E\u672C\u6279 V\u0026A Quick Start \u7684\u5B8C\u6574 GET \u793A\u4F8B\u3001\u5BF9\u8C61\u6807\u9898\u8BFB\u53D6\u3001\u641C\u7D22/\u8BCD\u8868\u8FC7\u6EE4\u3001CSV \u5B57\u6BB5\u3001\u805A\u5408\u4E0E IIIF \u6A21\u677F\u6574\u7406\uFF0C\u79FB\u9664\u672A\u6574\u7406\u6807\u7B7E\u3002\u4EC5 documentation_only\uFF1B\u4E0D\u6267\u884C\u6559\u7A0B\u4EE3\u7801\uFF0C\u4E0D\u8C03\u7528 API \u6216\u4E0B\u8F7D\u56FE\u50CF\uFF0C\u8BA4\u8BC1/\u8D39\u7528/\u8BB8\u53EF\u4FDD\u6301\u672A\u77E5\u3002",
    "source_urls": [
      "https://developers.vam.ac.uk/guide/v2/quick-start.html"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-e2ac39e067519591a4daee10",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-e2ac39e067519591a4daee10?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-e2ac39e067519591a4daee10?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure

Copy for your AI

Copy this text manually if clipboard access is unavailable. Copying does not register, install or connect anything.