X Search Cursor API | EveryInfra

Use keyword and optional cursor to fetch pages from X search. Copy the next_cursor from output to the next run for pagination. Supports three search types: Top, Latest, Media. This enables continued data collection across multiple runs.

Use Cases

• Paginate X search results
• Analyze historical trends over time

Input

The actor accepts flat inputs including keyword, optional search_type, and cursor. Optional params object is supported. The action is fixed to search and may be omitted.

{
  "keyword": "open source",
  "search_type": "Top"
}

Parameters

• keyword: Keyword expression for X post search.

• search_type: Type of search, default Top, options Top, Latest, Media.

• cursor: Cursor from previous output for pagination.

Pagination

Use the next_cursor from the OUTPUT to supply to the next run with the same keyword and search_type. has_more is true if cursor was supplied by source. One page per run.

Output

The OUTPUT contains schema_version, platform, action, has_data, record_count, records, next_cursor, has_more. Copy next_cursor unchanged to next run's cursor. Records include record_id, url, text, posted_at, author_id, author_username, author_name, author_follower_count, like_count, retweet_count, reply_count, view_count, quote_count, bookmark_count, language, conversation_id. Missing source fields are omitted. No result count guarantee. Does not scrape People or Lists.

Records are one per Apify dataset row. Export via Apify JSON or CSV; OUTPUT is a summary with cursor.

Pricing

Price is US$0.008 per successful NONEMPTY page, independent of row count. Empty/failed requests result in zero result events. No actor-start or per-row event charge. A paid run requires maximum charge budget >= $0.008 before requesting data. Apify platform charges may apply. One record is stored per dataset row.

Trial

The first 3 accepted data-request attempts per Apify account are free of result-event charges across all EveryInfra Actors combined, lifetime total with no reset. Invalid input consumes none, accepted empty or failed source attempts consume a trial. After the third trial, a paid Apify plan is required for continued use, with billing at the stated page event price.

Limitations

No guarantee on total results. has_more is based on source cursor not proof of more results. Does not scrape People or Lists. Search may match context beyond literal text. Search types include Top, Latest, Media.

Support

For technical support and updates, visit https://apify.com/blushing_parachute.