ENA · 按分类学检索记录与元数据

ENA 官方文档给出按 tax ID 检索 read_run 的 Portal API，报告支持 TSV/JSON，默认 TSV；可选字段含记录号和测序文件位置。仅文档整理，未检索或下载序列，费用及限流未知。

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-48aeafdcfb265f24afb23458
Card version: 2
Updated: 2026-10-24T17:11:16.8589041+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

本次正文示例使用 https://www.ebi.ac.uk/ena/portal/api/search，以 result=read_run 和 tax_eq(tax_id) 检索指定分类单元，也可用 tax_tree(tax_id) 包含整个分类子树。fields 可选 accession、description、collection_date、instrument_platform、fastq_ftp。Portal 仅返回索引字段；完整 XML 记录属于另一个 ENA Browser API 路径。

Inputs

有效 tax ID、read_run 结果类型、tax_eq/tax_tree 查询及可选 fields 列表。

Outputs

文档声明的 TSV 或 JSON 元数据报告；默认 TSV。fastq_ftp 是序列文件位置，不等于本次已下载测序数据。

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "none",
    "notes": "\u672C\u9875\u793A\u4F8B\u76F4\u63A5\u7ED9\u51FA\u67E5\u8BE2 URL\uFF0C\u672A\u5E26\u8BA4\u8BC1\u4FE1\u606F\uFF1B\u4EC5\u8BB0\u5F55\u6587\u6863\u793A\u4F8B\u6761\u4EF6\uFF0C\u672A\u9A8C\u8BC1\u8FD0\u884C\u65F6\u8D26\u6237\u6216\u8BA4\u8BC1\u8981\u6C42\u3002"
  },
  "command": null,
  "entry_url": "https://www.ebi.ac.uk/ena/portal/api/search",
  "kind": "http_api",
  "method": "GET",
  "request_example": {
    "method": "GET",
    "query": {
      "fields": "accession,description,collection_date,instrument_platform,fastq_ftp",
      "query": "tax_eq(797283)",
      "result": "read_run"
    },
    "url": "https://www.ebi.ac.uk/ena/portal/api/search"
  },
  "requirements": [
    "\u5148\u786E\u5B9A\u6240\u9700 tax ID\uFF1B\u6B63\u6587\u8BF4\u660E\u76F8\u5173\u5206\u7C7B\u6765\u81EA NCBI taxonomy\u3002",
    "\u4EE5 result=read_run \u548C tax_eq(tax_id) \u6216 tax_tree(tax_id) \u6784\u9020\u672C\u9875\u793A\u4F8B\u3002",
    "\u9ED8\u8BA4\u62A5\u544A\u4E3A TSV\uFF1B\u6B63\u6587\u79F0\u652F\u6301 JSON\uFF0C\u4F46\u672C\u9875\u672A\u7ED9\u5207\u6362 JSON \u7684\u7CBE\u786E\u53C2\u6570\uFF0C\u4E0D\u5728\u6B64\u731C\u6D4B\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": "\u672C\u9875\u672A\u5EFA\u7ACB\u4EF7\u683C\u6216\u8C03\u7528\u989D\u5EA6\u4FDD\u8BC1\u3002\u5BFC\u822A\u4E2D\u7684 Rate Limits \u94FE\u63A5\u4E0D\u662F\u5DF2\u6838\u6570\u503C\uFF1B\u9875\u811A\u6587\u6863\u8BB8\u53EF\u4E0D\u6269\u5C55\u4E3A API \u514D\u8D39\u6216\u6570\u636E\u518D\u5229\u7528\u8BB8\u53EF\u3002",
  "source_url": null
}

{
  "location": "provider_server",
  "notes": "\u6587\u6863\u63CF\u8FF0\u5411 ENA \u8FDC\u7A0B\u63A5\u53E3\u63D0\u4EA4\u516C\u5F00\u5206\u7C7B\u68C0\u7D22\u6761\u4EF6\uFF1B\u672C\u6B21\u4EC5\u6574\u7406\u516C\u5F00\u9644\u4EF6\uFF0C\u6CA1\u6709\u63D0\u4EA4\u67E5\u8BE2\u6216\u4E0B\u8F7D\u5E8F\u5217\u3002\u7559\u5B58\u53CA\u5B8C\u6574\u6570\u636E\u6761\u6B3E\u672A\u6838\u3002"
}

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

Limitations

Portal 仅持有索引字段，不能保证返回提交者所有自定义元数据。
正文另给 Browser API 下载完整 XML 的路径，不能把该能力混为 Portal 已返回完整 XML。
未请求 Portal、taxonomy 或 Browser API，未下载 FTP 文件或处理实际生物样本数据。

Unknowns

价格、限流、认证实际行为及实时可用性未验证。
切换 JSON 的精确参数、实际返回数据和完整响应 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:09:59.4355119\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://ena-docs.readthedocs.io/en/latest/retrieval/programmatic-access/taxon-based-search.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

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": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u6587\u6863\u63CF\u8FF0\u5411 ENA \u8FDC\u7A0B\u63A5\u53E3\u63D0\u4EA4\u516C\u5F00\u5206\u7C7B\u68C0\u7D22\u6761\u4EF6\uFF1B\u672C\u6B21\u4EC5\u6574\u7406\u516C\u5F00\u9644\u4EF6\uFF0C\u6CA1\u6709\u63D0\u4EA4\u67E5\u8BE2\u6216\u4E0B\u8F7D\u5E8F\u5217\u3002\u7559\u5B58\u53CA\u5B8C\u6574\u6570\u636E\u6761\u6B3E\u672A\u6838\u3002"
  },
  "description": "\u672C\u6B21\u6B63\u6587\u793A\u4F8B\u4F7F\u7528 https://www.ebi.ac.uk/ena/portal/api/search\uFF0C\u4EE5 result=read_run \u548C tax_eq(tax_id) \u68C0\u7D22\u6307\u5B9A\u5206\u7C7B\u5355\u5143\uFF0C\u4E5F\u53EF\u7528 tax_tree(tax_id) \u5305\u542B\u6574\u4E2A\u5206\u7C7B\u5B50\u6811\u3002fields \u53EF\u9009 accession\u3001description\u3001collection_date\u3001instrument_platform\u3001fastq_ftp\u3002Portal \u4EC5\u8FD4\u56DE\u7D22\u5F15\u5B57\u6BB5\uFF1B\u5B8C\u6574 XML \u8BB0\u5F55\u5C5E\u4E8E\u53E6\u4E00\u4E2A ENA Browser API \u8DEF\u5F84\u3002",
  "inputs": [
    "\u6709\u6548 tax ID\u3001read_run \u7ED3\u679C\u7C7B\u578B\u3001tax_eq/tax_tree \u67E5\u8BE2\u53CA\u53EF\u9009 fields \u5217\u8868\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "none",
      "notes": "\u672C\u9875\u793A\u4F8B\u76F4\u63A5\u7ED9\u51FA\u67E5\u8BE2 URL\uFF0C\u672A\u5E26\u8BA4\u8BC1\u4FE1\u606F\uFF1B\u4EC5\u8BB0\u5F55\u6587\u6863\u793A\u4F8B\u6761\u4EF6\uFF0C\u672A\u9A8C\u8BC1\u8FD0\u884C\u65F6\u8D26\u6237\u6216\u8BA4\u8BC1\u8981\u6C42\u3002"
    },
    "command": null,
    "entry_url": "https://www.ebi.ac.uk/ena/portal/api/search",
    "kind": "http_api",
    "method": "GET",
    "request_example": {
      "method": "GET",
      "query": {
        "fields": "accession,description,collection_date,instrument_platform,fastq_ftp",
        "query": "tax_eq(797283)",
        "result": "read_run"
      },
      "url": "https://www.ebi.ac.uk/ena/portal/api/search"
    },
    "requirements": [
      "\u5148\u786E\u5B9A\u6240\u9700 tax ID\uFF1B\u6B63\u6587\u8BF4\u660E\u76F8\u5173\u5206\u7C7B\u6765\u81EA NCBI taxonomy\u3002",
      "\u4EE5 result=read_run \u548C tax_eq(tax_id) \u6216 tax_tree(tax_id) \u6784\u9020\u672C\u9875\u793A\u4F8B\u3002",
      "\u9ED8\u8BA4\u62A5\u544A\u4E3A TSV\uFF1B\u6B63\u6587\u79F0\u652F\u6301 JSON\uFF0C\u4F46\u672C\u9875\u672A\u7ED9\u5207\u6362 JSON \u7684\u7CBE\u786E\u53C2\u6570\uFF0C\u4E0D\u5728\u6B64\u731C\u6D4B\u3002"
    ]
  },
  "limitations": [
    "Portal \u4EC5\u6301\u6709\u7D22\u5F15\u5B57\u6BB5\uFF0C\u4E0D\u80FD\u4FDD\u8BC1\u8FD4\u56DE\u63D0\u4EA4\u8005\u6240\u6709\u81EA\u5B9A\u4E49\u5143\u6570\u636E\u3002",
    "\u6B63\u6587\u53E6\u7ED9 Browser API \u4E0B\u8F7D\u5B8C\u6574 XML \u7684\u8DEF\u5F84\uFF0C\u4E0D\u80FD\u628A\u8BE5\u80FD\u529B\u6DF7\u4E3A Portal \u5DF2\u8FD4\u56DE\u5B8C\u6574 XML\u3002",
    "\u672A\u8BF7\u6C42 Portal\u3001taxonomy \u6216 Browser API\uFF0C\u672A\u4E0B\u8F7D FTP \u6587\u4EF6\u6216\u5904\u7406\u5B9E\u9645\u751F\u7269\u6837\u672C\u6570\u636E\u3002"
  ],
  "outputs": [
    "\u6587\u6863\u58F0\u660E\u7684 TSV \u6216 JSON \u5143\u6570\u636E\u62A5\u544A\uFF1B\u9ED8\u8BA4 TSV\u3002fastq_ftp \u662F\u5E8F\u5217\u6587\u4EF6\u4F4D\u7F6E\uFF0C\u4E0D\u7B49\u4E8E\u672C\u6B21\u5DF2\u4E0B\u8F7D\u6D4B\u5E8F\u6570\u636E\u3002"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u672C\u9875\u672A\u5EFA\u7ACB\u4EF7\u683C\u6216\u8C03\u7528\u989D\u5EA6\u4FDD\u8BC1\u3002\u5BFC\u822A\u4E2D\u7684 Rate Limits \u94FE\u63A5\u4E0D\u662F\u5DF2\u6838\u6570\u503C\uFF1B\u9875\u811A\u6587\u6863\u8BB8\u53EF\u4E0D\u6269\u5C55\u4E3A API \u514D\u8D39\u6216\u6570\u636E\u518D\u5229\u7528\u8BB8\u53EF\u3002",
    "source_url": null
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [
    "\u6309 tax ID \u68C0\u7D22 ENA read_run \u5143\u6570\u636E",
    "\u533A\u5206 ENA Portal \u7D22\u5F15\u62A5\u544A\u4E0E\u5B8C\u6574 XML \u8BB0\u5F55"
  ],
  "sources": [
    {
      "basis": "official_documentation",
      "checked_at": "2026-10-24T17:09:59.4355119\u002B00:00",
      "title": "How to Programmatically Perform a Search Across ENA Based on Taxonomy \u2014 ENA Documentation 1 documentation",
      "url": "https://ena-docs.readthedocs.io/en/latest/retrieval/programmatic-access/taxon-based-search.html"
    }
  ],
  "summary": "ENA \u5B98\u65B9\u6587\u6863\u7ED9\u51FA\u6309 tax ID \u68C0\u7D22 read_run \u7684 Portal API\uFF0C\u62A5\u544A\u652F\u6301 TSV/JSON\uFF0C\u9ED8\u8BA4 TSV\uFF1B\u53EF\u9009\u5B57\u6BB5\u542B\u8BB0\u5F55\u53F7\u548C\u6D4B\u5E8F\u6587\u4EF6\u4F4D\u7F6E\u3002\u4EC5\u6587\u6863\u6574\u7406\uFF0C\u672A\u68C0\u7D22\u6216\u4E0B\u8F7D\u5E8F\u5217\uFF0C\u8D39\u7528\u53CA\u9650\u6D41\u672A\u77E5\u3002",
  "tags": [
    "ENA",
    "\u5206\u7C7B\u5B66",
    "tax ID",
    "\u6D4B\u5E8F\u5143\u6570\u636E",
    "TSV",
    "JSON",
    "\u5B98\u65B9\u6587\u6863",
    "\u672A\u5B9E\u6D4B"
  ],
  "terms_url": null,
  "title": "ENA \u00B7 \u6309\u5206\u7C7B\u5B66\u68C0\u7D22\u8BB0\u5F55\u4E0E\u5143\u6570\u636E",
  "unknowns": [
    "\u4EF7\u683C\u3001\u9650\u6D41\u3001\u8BA4\u8BC1\u5B9E\u9645\u884C\u4E3A\u53CA\u5B9E\u65F6\u53EF\u7528\u6027\u672A\u9A8C\u8BC1\u3002",
    "\u5207\u6362 JSON \u7684\u7CBE\u786E\u53C2\u6570\u3001\u5B9E\u9645\u8FD4\u56DE\u6570\u636E\u548C\u5B8C\u6574\u54CD\u5E94 schema \u672A\u5728\u672C\u9875\u786E\u8BC1\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:09:59.4355119\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://ena-docs.readthedocs.io/en/latest/retrieval/programmatic-access/taxon-based-search.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-48aeafdcfb265f24afb23458",
  "version": 2,
  "source_url": "https://ena-docs.readthedocs.io/en/latest/retrieval/programmatic-access/taxon-based-search.html",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://ena-docs.readthedocs.io/en/latest/retrieval/programmatic-access/taxon-based-search.html",
    "final_url": "https://ena-docs.readthedocs.io/en/latest/retrieval/programmatic-access/taxon-based-search.html",
    "status_code": 200,
    "title": "How to Programmatically Perform a Search Across ENA Based on Taxonomy \u2014 ENA Documentation 1 documentation",
    "description": null,
    "checked_at": "2026-10-24T17:09:59.4355119\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:10:01.9085059\u002B00:00",
  "updated_at": "2026-10-24T17:11:16.8589041\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-48aeafdcfb265f24afb23458?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-48aeafdcfb265f24afb23458?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": "\u79D1\u7814\u6570\u636E\u670D\u52A1\uFF1AENA \u6309\u5206\u7C7B\u5B66\u68C0\u7D22\u6D4B\u5E8F\u8BB0\u5F55\u5143\u6570\u636E",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-051bdd7b5867d450e42a133a1732ae32",
        "source_url": "https://ena-docs.readthedocs.io/en/latest/retrieval/programmatic-access/taxon-based-search.html",
        "content_sha256": "5a70d95f83b74063011060ac243f711f58d95d59da07e683e2e3e5c4bca4c8c2",
        "decoded_bytes": 18205,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:09:59.4355119\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "5a70d95f83b74063011060ac243f711f58d95d59da07e683e2e3e5c4bca4c8c2",
        "text_utf8_bytes": 18205,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-48aeafdcfb265f24afb23458/materials/material-051bdd7b5867d450e42a133a1732ae32?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-51da2e2130f6412285b6ecd8c12260b7",
    "reason": "\u4F9D\u636E\u672C\u6279\u5B8C\u6574 ENA \u5206\u7C7B\u68C0\u7D22\u6B63\u6587\u6574\u7406 Portal \u5165\u53E3\u3001tax_eq/tax_tree\u3001\u5B57\u6BB5\u793A\u4F8B\u53CA TSV/JSON \u58F0\u660E\uFF1B\u660E\u786E\u533A\u5206\u7D22\u5F15\u62A5\u544A\u3001\u5B8C\u6574 XML \u548C\u5E8F\u5217\u6587\u4EF6\u4E0B\u8F7D\u3002\u53BB\u9664\u672A\u6574\u7406\u6807\u7B7E\uFF0C\u672A\u6267\u884C URL \u6216\u6307\u4EE4\uFF1B\u672A\u6838\u6761\u4EF6\u548C\u8FD0\u884C\u7ED3\u679C\u4FDD\u6301\u672A\u77E5\u3002",
    "source_urls": [
      "https://ena-docs.readthedocs.io/en/latest/retrieval/programmatic-access/taxon-based-search.html"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-48aeafdcfb265f24afb23458",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-48aeafdcfb265f24afb23458?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-48aeafdcfb265f24afb23458?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