> ## 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.
# Post Counts Recentes
> Este guia mostra como obter Post counts (volume) para os últimos 7 dias. Referência para o tier standard da X API v2 sobre quickstart.
export const Button = ({href, children}) => {
return ;
};
Este guia mostra como obter Post counts (volume) para os últimos 7 dias.
**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
* O Bearer Token do seu App
***
## Obter Post counts recentes
Use a mesma sintaxe de query do recent search. Por exemplo, para contar Posts de @XDevelopers:
```
from:XDevelopers
```
```bash cURL theme={null}
curl "https://api.x.com/2/tweets/counts/recent?\
query=from%3AXDevelopers&\
granularity=day" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_BEARER_TOKEN")
# Obter Post counts recentes
response = client.posts.count_recent(
query="from:XDevelopers",
granularity="day"
)
for bucket in response.data:
print(f"{bucket.start}: {bucket.tweet_count} Posts")
print(f"Total: {response.meta.total_tweet_count}")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// Obter Post counts recentes
const response = await client.posts.countRecent({
query: "from:XDevelopers",
granularity: "day",
});
response.data?.forEach((bucket) => {
console.log(`${bucket.start}: ${bucket.tweet_count} Posts`);
});
console.log(`Total: ${response.meta?.total_tweet_count}`);
```
```json theme={null}
{
"data": [
{
"end": "2024-01-16T00:00:00.000Z",
"start": "2024-01-15T00:00:00.000Z",
"tweet_count": 5
},
{
"end": "2024-01-17T00:00:00.000Z",
"start": "2024-01-16T00:00:00.000Z",
"tweet_count": 3
},
{
"end": "2024-01-18T00:00:00.000Z",
"start": "2024-01-17T00:00:00.000Z",
"tweet_count": 8
}
],
"meta": {
"total_tweet_count": 16
}
}
```
***
## Opções de granularidade
Controle como as contagens são agrupadas:
| Granularidade | Descrição |
| :------------ | :-------------------------- |
| `minute` | Contagens por minuto |
| `hour` | Contagens por hora (padrão) |
| `day` | Contagens por dia |
```bash cURL theme={null}
# Obter contagens por hora
curl "https://api.x.com/2/tweets/counts/recent?\
query=python%20lang%3Aen&\
granularity=hour" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_BEARER_TOKEN")
# Obter contagens por hora
response = client.posts.count_recent(
query="python lang:en",
granularity="hour"
)
for bucket in response.data:
print(f"{bucket.start}: {bucket.tweet_count}")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// Obter contagens por hora
const response = await client.posts.countRecent({
query: "python lang:en",
granularity: "hour",
});
response.data?.forEach((bucket) => {
console.log(`${bucket.start}: ${bucket.tweet_count}`);
});
```
***
## Filtrar por intervalo de tempo
Limite as contagens a um período específico:
```bash cURL theme={null}
curl "https://api.x.com/2/tweets/counts/recent?\
query=from%3AXDevelopers&\
start_time=2024-01-10T00%3A00%3A00Z&\
end_time=2024-01-15T00%3A00%3A00Z&\
granularity=day" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_BEARER_TOKEN")
# Obter contagens para um intervalo de tempo específico
response = client.posts.count_recent(
query="from:XDevelopers",
start_time="2024-01-10T00:00:00Z",
end_time="2024-01-15T00:00:00Z",
granularity="day"
)
print(f"Total Posts: {response.meta.total_tweet_count}")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// Obter contagens para um intervalo de tempo específico
const response = await client.posts.countRecent({
query: "from:XDevelopers",
startTime: "2024-01-10T00:00:00Z",
endTime: "2024-01-15T00:00:00Z",
granularity: "day",
});
console.log(`Total Posts: ${response.meta?.total_tweet_count}`);
```
***
## Parâmetros comuns
| Parâmetro | Descrição | Padrão |
| :------------ | :-------------------------------- | :----------- |
| `query` | Query de busca (obrigatória) | — |
| `granularity` | Tamanho do bucket de tempo | `hour` |
| `start_time` | Timestamp mais antigo (ISO 8601) | 7 dias atrás |
| `end_time` | Timestamp mais recente (ISO 8601) | Agora |
***
## Próximos passos
Obtenha Post counts históricos
Domine a sintaxe de query
Documentação completa do endpoint