{"id":14956167,"url":"https://github.com/pinatacloud/pinata","last_synced_at":"2025-09-10T00:24:21.106Z","repository":{"id":250733851,"uuid":"829192000","full_name":"PinataCloud/pinata","owner":"PinataCloud","description":"The new Pinata SDK","archived":false,"fork":false,"pushed_at":"2025-07-01T18:55:12.000Z","size":1817,"stargazers_count":21,"open_issues_count":4,"forks_count":4,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-08-19T12:37:39.228Z","etag":null,"topics":["ipfs","sdk","typescript"],"latest_commit_sha":null,"homepage":"https://docs.pinata.cloud/sdk","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PinataCloud.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-07-16T00:20:58.000Z","updated_at":"2025-08-11T15:36:54.000Z","dependencies_parsed_at":"2024-09-11T20:15:27.897Z","dependency_job_id":"5414e7c1-0882-4bb0-b90f-8066fdd42786","html_url":"https://github.com/PinataCloud/pinata","commit_stats":{"total_commits":175,"total_committers":1,"mean_commits":175.0,"dds":0.0,"last_synced_commit":"16e93feaf322f74a2d998556249fe6bbd9f1e46f"},"previous_names":["pinatacloud/pinata"],"tags_count":62,"template":false,"template_full_name":null,"purl":"pkg:github/PinataCloud/pinata","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PinataCloud%2Fpinata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PinataCloud%2Fpinata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PinataCloud%2Fpinata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PinataCloud%2Fpinata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PinataCloud","download_url":"https://codeload.github.com/PinataCloud/pinata/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PinataCloud%2Fpinata/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274390645,"owners_count":25276406,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-09T02:00:10.223Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ipfs","sdk","typescript"],"created_at":"2024-09-24T13:12:25.599Z","updated_at":"2025-09-10T00:24:21.097Z","avatar_url":"https://github.com/PinataCloud.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pinata\n\n![cover-image](https://docs.mypinata.cloud/ipfs/QmQi9QEuMfsoxVPqhDQdppdyD6HSrUDsaKK5hdTvT1nikw?img-format=webp)\n\nThe new all-in-one Pinata SDK\n\n## Quickstart\n\n[View the full documentation here](https://docs.pinata.cloud/sdk-beta/getting-started)\n\n### 1. Install\n\n```bash\nnpm i pinata\n```\n\nImport and initialize the SDK in your codebase with the following variables\n- [Pinata API Key JWT](https://docs.pinata.cloud/account-management/api-keys)\n- [Pinata Gateway Domain](https://docs.pinata.cloud/gateways/dedicated-ipfs-gateways)\n\n```typescript\nimport { PinataSDK } from \"pinata\";\n\nconst pinata = new PinataSDK({\n  pinataJwt: \"PINATA_JWT\",\n  pinataGateway: \"example-gateway.mypinata.cloud\",\n});\n```\n\n\u003cNote\u003eThe `PINATA_JWT` is a secret key, be sure to initialize the SDK in a secure environment and practice basic variable security practices. If you need to upload from a client environment, consider using signed JWTs\u003c/Note\u003e\n\n### 2. Upload a File\n\n```typescript\nimport { PinataSDK } from \"pinata\";\n\nconst pinata = new PinataSDK({\n  pinataJwt: process.env.PINATA_JWT!,\n  pinataGateway: \"example-gateway.mypinata.cloud\",\n});\n\nasync function main() {\n  try {\n    const file = new File([\"hello\"], \"Testing.txt\", { type: \"text/plain\" });\n    const upload = await pinata.upload.public.file(file);\n    console.log(upload);\n  } catch (error) {\n    console.log(error);\n  }\n}\n\nawait main();\n```\n\nThis will return an object like the following:\n\n```typescript\n{\n  id: \"0195a5c4-242f-7c01-bee8-f34a9e8e804b\",\n  user_id: \"87ef31fe-519b-4ffe-90d9-987771247827\",\n  group_id: null,\n  name: \"hello.txt\",\n  cid: \"bafkreid7qoywk77r7rj3slobqfekdvs57qwuwh5d2z3sqsw52iabe3mqne\",\n  created_at: \"2025-03-17T20:20:50.057Z\",\n  size: 12,\n  number_of_files: 1,\n  mime_type: \"text/plain\",\n  vectorized: false,\n  network: \"public\",\n}\n```\n\n### 3. Retrieve a File\n\nUse the `cid` or from the upload to fetch a file\n\n```typescript\nimport { PinataSDK } from \"pinata\";\n\nconst pinata = new PinataSDK({\n  pinataJwt: process.env.PINATA_JWT!,\n  pinataGateway: \"example-gateway.mypinata.cloud\",\n});\n\nasync function main() {\n  try {\n    const data = await pinata.gateways.public.get(\"bafkreibm6jg3ux5qumhcn2b3flc3tyu6dmlb4xa7u5bf44yegnrjhc4yeq\");\n    console.log(data)\n  } catch (error) {\n    console.log(error);\n  }\n}\n\nmain();\n```\n\n[View the full documentation here](https://docs.pinata.cloud/sdk/getting-started)\n\n## Developing\n\n```bash\ngit clone https://github.com/PinataCloud/pinata\ncd pinata\nnpm install\n```\n\nRun Build\n```bash\nnpm run build\n```\n\nRun Tests\n```bash\nnpm run test\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinatacloud%2Fpinata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpinatacloud%2Fpinata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinatacloud%2Fpinata/lists"}