---
title: "Search Posts"
method: GET
path: "/v1/twitter/search/posts"
tags: ["Twitter"]
---

# Search Posts

`GET /v1/twitter/search/posts`

## Request

- Base URL: `https://api.scrapecreators.com`
- URL: `https://api.scrapecreators.com/v1/twitter/search/posts`
- Auth: API key in header `x-api-key`

Finds public X/Twitter post URLs through Google Search, then returns their details using the same public post scraper as /v1/twitter/tweet. This is Google-indexed discovery, not native X search: coverage is incomplete, recent posts can be missing, and results are ranked by Google rather than newest first. Deleted, protected, or inaccessible posts are omitted. Each post uses the existing tweet response fields, including rest_id, legacy.full_text, legacy.created_at, engagement counts, author and media when available, plus a canonical url. Pass the returned cursor for the next Google page; cursors range from 1 through 11 and null means pagination has ended. The same post may appear on different pages. Each successful page costs 1 credit, including empty results; validation errors and upstream failures are not charged. Replaying cursor=null is uncharged. Allow at least 30 seconds for your client timeout.

## Query parameters

- `query` string, required
- `cursor` string

## Response `200`

Successful response

## Changes

- **2026-10-06** `8f9a679ad38e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scrapecreators/apis/scrape-creators-api/changes/v1/twitter/search/posts/get.md)

---

[API](https://skmtc.dev/scrapecreators/apis/scrape-creators-api.md) - [All operations](https://skmtc.dev/scrapecreators/apis/scrape-creators-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scrapecreators/apis/scrape-creators-api/revisions/04f589b15e15?raw)