Consulta de Bookmarks

Este guia mostra como recuperar seus Posts marcados como favoritos usando a X API.

Pré-requisitosAntes de começar, você precisará de:

Uma conta de desenvolvedor com um App aprovado
User Access Token com o escopo bookmark.read (OAuth 2.0 PKCE)

Obtenha seus bookmarks

Obtenha seu ID de usuário

Você precisa do ID do usuário autenticado. Você pode encontrá-lo usando o endpoint /2/users/me ou pelo endpoint de user lookup.

Solicite seus bookmarks

cURL

curl "https://api.x.com/2/users/2244994945/bookmarks?\
tweet.fields=created_at,public_metrics,author_id&\
max_results=10" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Obter Posts marcados como favoritos com paginação
for page in client.bookmarks.get(
    "2244994945",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    max_results=10
):
    for post in page.data:
        print(f"{post.text[:50]}... - Likes: {post.public_metrics.like_count}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Obter Posts marcados como favoritos com paginação
const paginator = client.bookmarks.get("2244994945", {
  tweetFields: ["created_at", "public_metrics", "author_id"],
  maxResults: 10,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.text?.slice(0, 50)}... - Likes: ${post.public_metrics?.like_count}`);
  });
}

Revise a resposta

{
  "data": [
    {
      "id": "1501258597237342208",
      "text": "Have you built a project using the X API you'd like to share with the community? We'd love to hear from you!",
      "created_at": "2024-01-15T10:30:00.000Z",
      "author_id": "2244994945",
      "public_metrics": {
        "retweet_count": 15,
        "reply_count": 8,
        "like_count": 89,
        "quote_count": 3
      }
    },
    {
      "id": "1501258542258348032",
      "text": "This is just one way developer innovation helps make X a better place...",
      "created_at": "2024-01-15T09:15:00.000Z",
      "author_id": "2244994945",
      "public_metrics": {
        "retweet_count": 22,
        "reply_count": 5,
        "like_count": 156,
        "quote_count": 7
      }
    }
  ],
  "meta": {
    "result_count": 2,
    "next_token": "7140dibdnow9c7btw4539n0vybdnx19ylpayqf16fjt4l"
  }
}

Inclua informações do autor

Use expansions para obter dados sobre os autores dos Posts:

cURL

curl "https://api.x.com/2/users/2244994945/bookmarks?\
tweet.fields=created_at,author_id&\
expansions=author_id&\
user.fields=username,verified" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Obter bookmarks com informações do autor
for page in client.bookmarks.get(
    "2244994945",
    tweet_fields=["created_at", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "verified"]
):
    for post in page.data:
        print(f"{post.text[:50]}...")
    # As informações do autor estão em page.includes.users

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Obter bookmarks com informações do autor
const paginator = client.bookmarks.get("2244994945", {
  tweetFields: ["created_at", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "verified"],
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.text?.slice(0, 50)}...`);
  });
  // As informações do autor estão em page.includes?.users
}

Escopos obrigatórios

Ao usar OAuth 2.0 PKCE, seu access token deve ter estes escopos:

Escopo	Descrição
`bookmark.read`	Ler bookmarks
`tweet.read`	Ler dados do Post
`users.read`	Ler dados do usuário (para expansions)

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Consulta de Bookmarks

Obtenha seus bookmarks

Inclua informações do autor

Escopos obrigatórios

Próximos passos

Gerenciar bookmarks

Referência da API

​Obtenha seus bookmarks

​Inclua informações do autor

​Escopos obrigatórios

​Próximos passos

Gerenciar bookmarks

Referência da API

Obtenha seus bookmarks

Inclua informações do autor

Escopos obrigatórios

Próximos passos