{"uid":"cap_jfiO_D0IrEwuq_mYF6NRs","slug":"grist-tools-archive-extract-file-fb348201","name":"grist.tools Archive Extract File","description":"One endpoint does one thing, always the same way, for a fraction of a cent. Payment is verified before the handler runs and settled only after it succeeds, so a rejected or failed call is never a charged call.","url":"https://grist.tools/v1/archive-extract-file?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["url","entry"],"properties":{"url":{"type":"string","description":"Absolute http(s) URL of the archive (at most 25 MB, also the cap on an inflated tar.gz), up to 2048 characters; redirects are followed and the format (zip, tar or gzip-compressed tar) is decided from the magic bytes, not the extension."},"entry":{"type":"string","description":"Exact entry path to extract, 1 to 4096 characters, matched case-sensitively against the names archive-inspect lists; directories, links, encrypted entries and entries over 25 MB are refused."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BoaSfppo5ssow-bU-t07Y","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a remote archive (ZIP, TAR, or gzipped TAR) and returns the raw bytes of a single named entry from within it","exampleAgentPrompt":"Pull out just the file 'data/config.json' from the zip archive at https://releases.example.com/package-v2.1.zip and show me its contents.","exampleUseCases":[{"title":"Extract config from release archive","prompt":"There's a release tarball at https://github.com/example/repo/releases/download/v1.4.0/release.tar.gz — can you pull out just the file 'release/config/settings.yaml' from it?"},{"title":"Retrieve CSV from zipped dataset","prompt":"I need the file 'data/sales_2023_q4.csv' from the zip archive at https://datasets.example.com/sales-archive.zip — can you extract just that one file for me?"},{"title":"Read changelog from remote package","prompt":"Grab the 'CHANGELOG.md' entry from the tar.gz at https://cdn.example.com/myapp-3.0.0.tar.gz and show me what's in it."}],"resultDescription":"The raw file contents of the requested archive entry, returned as bytes. The response is the actual file data — not base64 or JSON-wrapped — for the exact named entry within the remote archive.","failureModes":["Archive URL is unreachable or returns a non-200 response","Archive exceeds 25 MB size limit","Entry path does not exist in the archive (case-sensitive match failure)","Entry is a directory, symlink, or hard link rather than a plain file","Entry itself exceeds 25 MB","Archive is encrypted or password-protected","URL is longer than 2048 characters or entry path longer than 4096 characters","Archive format is not ZIP, TAR, or gzip-compressed TAR","Payment verification fails before handler runs"],"whenToPreferThis":"Choose this endpoint when you need to retrieve a single known file from a remote archive without downloading and unpacking the entire archive locally. It is ideal for picking one artifact out of a release tarball, reading a specific file from a zipped dataset, or fetching a config or source file embedded in a compressed bundle. Prefer it over general HTTP fetch tools when the target content is buried inside a compressed archive rather than directly accessible via URL.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T05:31:14.706Z","isFirstParty":false,"canonicalSlug":"grist-tools-archive-extract-file-fb348201"}