Import from Pinboard

Move your entire Pinboard library into Batata in under a minute. Tags, timestamps, and the public/private flag all carry over.

Get your Pinboard export

1. Sign in to Pinboard and go to pinboard.in/settings/backup.
2. Click JSON to download a file like pinboard_export.json.

Upload to Batata

1. Open Settings.
2. Find the Data section and click Import JSON.
3. Select your Pinboard JSON file.
4. A confirmation alert shows how many bookmarks were imported.

What carries over

• URL (href field)
• Title (descriptionfield in Pinboard's schema)
• Notes (extended field)
• Tags — space-separated tags become individual tags
• Original timestamp — preserved as the save date in Batata
• Private flag — Pinboard's shared: no maps to Batata's private flag

Dedup

If a URL already exists in your account, the import skips it. You'll see “skipped: N” in the success message.

Free tier limits

What happens after import

Imported bookmarks land with archive_status = pending. A background worker then processes them in batches:

• Fetches the page and archives the text
• Generates AI summaries
• Suggests auto-tags
• Embeds the content for semantic search and Ask

Processing takes a few minutes for hundreds of bookmarks. Pages that fail to fetch (login-walls, bot blocks, dead links) are marked archive failed and stay in your library with title and tags intact.

Importing a different file format

Batata only supports Pinboard's JSON format right now. If you have a different export (Raindrop, Instapaper, browser bookmarks), reach out via the contact form — adapters are a high priority.

Quick reference: Pinboard JSON schema

[
  {
    "href": "https://example.com",
    "description": "Title shown in Pinboard",
    "extended": "Optional notes",
    "tags": "tag1 tag2 tag3",
    "time": "2024-01-15T10:30:00Z",
    "shared": "no",
    "toread": "no"
  }
]