# Bitbucket API

**Provider:** Bitbucket
**Category:** developer
**Base URL:** `https://api.bitbucket.org/2.0`
**Auth:** oauth2 — `Authorization: Bearer YOUR_ACCESS_TOKEN`
**Rate Limit:** 1,000 requests/hour (authenticated)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://support.atlassian.com/bitbucket-cloud/

## Description

Code against the Bitbucket API to automate simple tasks, embed Bitbucket data into your own site, build mobile or desktop apps, or even add custom UI add-ons into Bitbucket itself using the Connect framework.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| DELETE | `https://api.bitbucket.org/2.0/addon` | Delete an app |
| PUT | `https://api.bitbucket.org/2.0/addon` | Update an installed app |
| GET | `https://api.bitbucket.org/2.0/addon/linkers` | List linkers for an app |
| GET | `https://api.bitbucket.org/2.0/addon/linkers/{linker_key}` | Get a linker for an app |
| DELETE | `https://api.bitbucket.org/2.0/addon/linkers/{linker_key}/values` | Delete all linker values |
| GET | `https://api.bitbucket.org/2.0/addon/linkers/{linker_key}/values` | List linker values for a linker |
| POST | `https://api.bitbucket.org/2.0/addon/linkers/{linker_key}/values` | Create a linker value |
| PUT | `https://api.bitbucket.org/2.0/addon/linkers/{linker_key}/values` | Update a linker value |

## Authentication

OAuth 2.0 or HTTP Basic Auth (username + app password)

```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

## Sample Request

```bash
curl -X GET 'https://api.bitbucket.org/2.0/addon' \
  -H 'Authorization: YOUR_API_KEY'
```

## Sample Response

```json
{}
```

## Pricing Details

Free: 5 users. Standard: $3/user/mo. Premium: $6/user/mo. Includes CI/CD minutes.

---

*Source: [API Map](https://apimap.dev/apis/bitbucket/) — CC BY 4.0*