> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Gerenciar Bookmarks
> Este guia mostra como adicionar e remover bookmarks usando a X API. Referência para o tier standard da X API v2 sobre quickstart.
export const Button = ({href, children}) => {
return ;
};
Este guia mostra como adicionar e remover bookmarks usando a X API.
**Pré-requisitos**
Antes de começar, você precisará de:
* Uma [conta de desenvolvedor](https://developer.x.com/en/portal/petition/essential/basic-info) com um App aprovado
* User Access Token com o escopo `bookmark.write` (OAuth 2.0 PKCE)
***
## Adicionar um bookmark
Você precisa do ID do usuário autenticado. Você pode encontrá-lo usando o endpoint `/2/users/me` ou o [endpoint de user lookup](/x-api/users/lookup/introduction).
Encontre o ID do Post na URL ao visualizar um Post:
```
https://x.com/XDevelopers/status/1460323737035677698
└── Este é o ID do Post
```
```bash cURL theme={null}
curl -X POST "https://api.x.com/2/users/2244994945/bookmarks" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"tweet_id": "1460323737035677698"}'
```
```python Python SDK theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# Adicionar um bookmark
response = client.bookmarks.create(
user_id="2244994945",
tweet_id="1460323737035677698"
)
print(f"Bookmarked: {response.data.bookmarked}")
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// Adicionar um bookmark
const response = await client.bookmarks.create("2244994945", {
tweetId: "1460323737035677698",
});
console.log(`Bookmarked: ${response.data?.bookmarked}`);
```
```json theme={null}
{
"data": {
"bookmarked": true
}
}
```
***
## Remover um bookmark
Exclua um Post dos seus bookmarks:
```bash cURL theme={null}
curl -X DELETE "https://api.x.com/2/users/2244994945/bookmarks/1460323737035677698" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
```python Python SDK theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# Remover um bookmark
response = client.bookmarks.delete(
user_id="2244994945",
tweet_id="1460323737035677698"
)
print(f"Bookmarked: {response.data.bookmarked}")
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// Remover um bookmark
const response = await client.bookmarks.delete("2244994945", "1460323737035677698");
console.log(`Bookmarked: ${response.data?.bookmarked}`);
```
**Resposta:**
```json theme={null}
{
"data": {
"bookmarked": false
}
}
```
***
## Escopos obrigatórios
Ao usar OAuth 2.0 PKCE, seu access token deve ter estes escopos:
| Escopo | Descrição |
| :--------------- | :---------------------------- |
| `bookmark.write` | Adicionar e remover bookmarks |
| `tweet.read` | Ler dados do Post |
| `users.read` | Ler dados do usuário |
***
## Próximos passos
Obtenha seus Posts marcados como favoritos
Documentação completa do endpoint