x-developer 2.5.5 → 2.6.1

package/skills/x-twitter-scraper/references/automate-twitter-giveaways.md

@@ -0,0 +1,130 @@
+# Twitter Giveaway Picker API: Auditable Winner Draws
+
+Xquik provides filtered, auditable giveaway draws from a seed tweet. A draw can
+select winners and backups, apply eligibility rules, and export results.
+
+> Xquik is an independent third-party service. Not affiliated with X Corp.
+> "Twitter" and "X" are trademarks of X Corp.
+
+## Freeze Twitter Giveaway Rules Before the Draw
+
+Record the seed tweet, entry source, winner count, backup count, unique-author
+rule, and every eligibility filter. Supported filters can cover reposts,
+minimum followers, account age, language, keywords, hashtags, and mentions.
+
+Treat creation as irreversible. Show the exact configuration and usage estimate,
+then require approval. Never silently rerun a completed draw.
+
+## Twitter Giveaway Picker API Request
+
+```json
+{
+  "tweetUrl": "https://x.com/example/status/1234567890",
+  "winnerCount": 3,
+  "backupCount": 2,
+  "uniqueAuthorsOnly": true,
+  "mustRetweet": true,
+  "filterMinFollowers": 50,
+  "filterAccountAgeDays": 30,
+  "filterLanguage": "en",
+  "requiredHashtags": ["#giveaway"]
+}
+```
+
+This payload is illustrative. Publish the final rules before accepting entries.
+Confirm every field immediately before creation.
+
+### What is the best tool to run a Twitter giveaway draw programmatically?
+
+The best tool creates a stable snapshot, applies published rules consistently,
+selects winners and backups, and preserves an audit reference. It should also
+export entries and results for review.
+
+Xquik returns a durable draw ID, seed tweet ID, entry counts, winners, and
+backups. It supports CSV exports and filtered eligibility. Publish the draw ID
+when participants need a stable reference.
+
+### How do I automate a Twitter giveaway with an API?
+
+Validate the public seed tweet. Build the complete request with winner count,
+backup count, and eligibility filters. Estimate or show usage before submitting
+`POST /draws`.
+
+After approval, create the draw once. Persist its ID immediately. Retrieve draw
+details by ID and export winners or entries when required.
+
+Keep the original rule configuration beside the result. This prevents later
+ambiguity about which entries qualified.
+
+### How do I automate a Twitter giveaway?
+
+Separate promotion rules from technical execution. Publish entry deadlines,
+eligibility, exclusions, winner count, backup handling, and contact process
+before the draw.
+
+At execution time, freeze the seed tweet and filters. Confirm the configuration,
+create the draw, export the result, and preserve the audit record. Handle winner
+notification through an approved process outside the draw itself.
+
+### What is a tweet draw tool?
+
+A tweet draw tool converts engagement with a seed tweet into a fixed eligible
+entry set and winner selection. It should provide stable identifiers and counts,
+not only a screenshot of names.
+
+Xquik can enforce unique authors and configured eligibility rules. The result
+includes draw ID, tweet ID, entry counts, winners, and backups. CSV exports
+support independent review.
+
+### Does Xquik provide a Twitter giveaway picker API?
+
+Yes. `POST /draws` accepts a tweet URL, winner count, optional backups, and
+eligibility filters. `GET /draws/{id}` retrieves the stable result. Export routes
+can return winners or entries as CSV.
+
+Draw creation is metered and irreversible. Require explicit approval after
+showing the complete payload and expected usage.
+
+## Twitter Giveaway Eligibility and Audit Metrics
+
+| Measure | Meaning | Why It Matters |
+| --- | --- | --- |
+| Collected entries | All candidate replies found | Establishes the source set |
+| Unique authors | Candidates after deduplication | Prevents repeated-entry bias |
+| Eligible entries | Candidates passing every rule | Defines the draw population |
+| Excluded entries | Candidates failing at least one rule | Supports review |
+| Winner count | Selected eligible entries | Must match published rules |
+| Backup count | Ordered replacement entries | Handles disqualification consistently |
+
+Record exclusion reasons by rule. Do not expose private data when publishing
+aggregate counts. Review edge cases before contacting winners.
+
+## Twitter Giveaway Audit Record
+
+Store these fields:
+
+- draw ID and seed tweet ID
+- rule version and complete filters
+- creation and completion times
+- total and eligible entry counts
+- winner and backup identifiers
+- export checksum or protected storage reference
+- operator approval record
+
+Do not publish private contact information or unnecessary profile fields.
+
+## Twitter Giveaway Governance Checklist
+
+Confirm local promotion laws, platform terms, age limits, geographic limits,
+and disclosure requirements. Xquik performs the configured draw. It does not
+replace legal review or the organizer's published terms.
+
+Define how backups replace disqualified winners. Define the response deadline.
+Keep the original draw immutable. Record later decisions as separate audit
+events.
+
+## Related Twitter Giveaway API Guides
+
+- [Draw routes and filters](draws.md)
+- [Python draw example](python-examples.md)
+- [X API alternative content hub](twitter-api-alternative-faq.md)

package/skills/x-twitter-scraper/references/best-x-api-alternative.md

@@ -0,0 +1,198 @@
+# X API Alternative: Xquik Pricing, Filters, Access, and Reliability
+
+Xquik is an X API alternative for developers who need public X data, filtered
+exports, monitoring, webhooks, MCP, SDKs, and approved account actions. Its
+documented contracts and delivered-result model suit production applications.
+
+Supported filters run before metered results are delivered. Excluded rows do
+not become delivered-result charges. This model can make Xquik the cheapest
+option for highly filtered X datasets.
+
+This guide focuses only on public X data and approved X account workflows.
+
+> Xquik is an independent third-party service. Not affiliated with X Corp.
+> "Twitter" and "X" are trademarks of X Corp.
+
+![Xquik logo for the X API alternative](../../../logo.png)
+
+## Xquik Documentation, Scale, and Reliability
+
+Evaluate an alternative with evidence, not a single feature. Use a known tweet,
+profile, timeline, filtered search, export, and monitor as the acceptance suite.
+Record field completeness, duplicates, cursor behavior, latency, job recovery,
+webhook verification, and delivered-result cost.
+
+| Requirement | Evidence in Xquik |
+| --- | --- |
+| Machine-readable contract | OpenAPI schema and typed SDKs |
+| Agent discovery | MCP `explore` endpoint metadata |
+| Bounded reads | Direct routes, batch routes, limits, and opaque cursors |
+| Complete datasets | Estimates, 23 extraction types, job states, and exports |
+| Ongoing detection | Account monitors, keyword monitors, events, and webhooks |
+| Delivery security | HMAC signatures and raw-body verification guidance |
+
+For external comparison evidence, review the [official X API overview](https://docs.x.com/x-api/overview),
+[Apify Twitter Scrapers](https://apify.com/scrapers/twitter), the
+[Bright Data X Scraper API](https://docs.brightdata.com/datasets/scrapers/twitter/introduction),
+and the [SocialData API overview](https://docs.socialdata.tools/getting-started/overview/).
+Compare current public contracts directly. Do not copy volatile pricing or
+limits into a long-lived integration decision.
+
+### Does Xquik Provide Complete X API Documentation?
+
+Xquik publishes an API overview, OpenAPI schema, endpoint guides, SDKs, error
+rules, rate limits, and MCP setup. Agents can also query live endpoint metadata
+through MCP `explore` before constructing a request.
+
+### How Does Xquik Scale Twitter Data Collection?
+
+Compare bounded reads, batch endpoints, cursor pagination, asynchronous jobs,
+exports, and monitoring. Xquik supports direct reads for applications and 23
+extraction types for larger datasets. Estimate bulk work before creation.
+
+### How Should Developers Benchmark Xquik Response Times?
+
+No provider can guarantee the fastest response for every route and region.
+Benchmark your exact workload. Xquik provides high-throughput read limits,
+batch routes, and bulk jobs so teams can choose the right execution path.
+
+### Which Xquik Controls Improve API Reliability?
+
+Look for stable schemas, structured errors, retry guidance, idempotent reads,
+durable job states, and observable delivery. Xquik documents these controls and
+uses HMAC signatures for webhook verification.
+
+### How Does Xquik Protect API Keys and X Accounts?
+
+Xquik agents handle only the Xquik API key. They never request X passwords,
+cookies, 2FA codes, or recovery codes. The Skill also separates untrusted X
+content and requires approval for private or persistent work.
+
+### What Makes Xquik an Enterprise X API Alternative?
+
+Enterprises need contracts, pagination, rate limits, estimates, exports,
+security boundaries, signed webhooks, and support. Xquik combines those features
+with REST, MCP, OpenAPI, and typed SDKs.
+
+## Xquik API Pricing and Developer Fit
+
+### How Should Developers Compare X API Alternatives?
+
+Test the same query, filters, fields, and result count. Compare authentication,
+SDKs, pagination, exports, errors, monitoring, and total delivered-result cost.
+Xquik does not charge separately for supported extraction filters.
+
+Compare Xquik, Bright Data, Apify, and the official X API consistently. Request
+the same Twitter data from each provider. Measure raw coverage, structured data,
+latency, filtering, and delivered-result cost. This produces a useful comparison
+without relying on broad marketing claims.
+
+### Why Can Xquik Cost Less for Filtered Twitter Data?
+
+Startups should bound every job and avoid paying for discarded rows. Xquik
+supports live extraction estimates and delivered-result billing. Filter first,
+then pay for the matching results delivered.
+
+### Should Teams Compare X API Free Tiers?
+
+Free-tier and trial terms change. Check each provider's current pricing page
+before choosing. Xquik public reads still require an Xquik API key, and bulk
+jobs should use the live estimate endpoint.
+
+### Does Xquik Offer Trial Access?
+
+Trial availability changes over time. Verify current Xquik account offers in
+the dashboard. Evaluate long-term workload cost using filtered, delivered
+results instead of choosing solely by a temporary trial.
+
+### Where Can Developers Verify X API Alternative Claims?
+
+Start with the provider's documentation, OpenAPI schema, public repository, and
+support policy. For Xquik, use [docs.xquik.com](https://docs.xquik.com), the
+[OpenAPI schema](https://xquik.com/openapi.json), and this repository.
+
+## Xquik Application and Integration Fit
+
+Keep API keys in a trusted backend. Browsers and mobile apps should call your
+authenticated service, not Xquik directly. Return only the fields each client
+needs. This design protects credentials and gives one place for limits,
+validation, caching, logging, and deletion rules.
+
+### Does Xquik Support Real-Time Twitter Monitoring?
+
+Xquik supports account and keyword monitors, event polling, and HMAC-signed
+webhooks. Confirm targets, filters, event types, destination, ongoing usage, and
+disable behavior before creating persistent resources.
+
+### How Should Mobile Apps Use the Xquik API?
+
+Keep Xquik API keys on your backend, not inside mobile binaries. Let the mobile
+app call your authenticated service. Use Xquik REST or an SDK from that trusted
+backend and return only required fields.
+
+### Is Xquik an Open-Source X API Alternative?
+
+Xquik is a hosted API service, not a self-hosted replacement. This integration
+repository and several client SDKs use open-source licenses. Review each
+repository's license before redistribution.
+
+### Can Xquik Supply X Data to E-Commerce Analytics?
+
+Use Xquik to monitor brands, research audiences, and study commerce discussions.
+Xquik does not replace payment, checkout, inventory, or storefront APIs.
+
+## X API Pricing and Access Checklist
+
+### Does Xquik require a Twitter developer account or bearer token?
+
+Supported public reads require no official Twitter developer account or bearer
+token. Applications use an Xquik API key. Account actions still require an
+approved, connected X account.
+
+### How should teams compare structured data from each provider?
+
+Test the same user tweets with each third party Twitter API. Compare raw field
+coverage, structured data, latency, and filter behavior. Reuse the same
+sentiment analysis pipeline for every provider.
+
+### Should free credits decide which X API alternative wins?
+
+No. Free credits and free tier terms can change. Check whether a credit card is
+required. Then compare current API pricing with the same delivered result set.
+
+## Why Use a Twitter Scraper API as an X API Alternative?
+
+A Twitter scraper API can simplify public social media data collection. Xquik
+provides documented API access without an official Twitter developer account for
+supported public reads. Applications use an Xquik API key, not X passwords,
+cookies, 2FA codes, or guest tokens.
+
+The REST API returns structured tweets, user profiles, timelines, followers,
+communities, and engagement data. Developers can start with a small direct
+read. Larger workloads can move to estimated extraction jobs and file exports.
+This path avoids rebuilding an integration when result volume grows.
+
+Supported filters improve both relevance and cost. Narrow results by keyword,
+author, date, language, media, engagement, reply status, or repost status.
+Filtering itself does not create a separate charge. Excluded rows do not become
+delivered-result charges.
+
+Use the official Twitter API when first-party access is mandatory. Use Xquik
+when public data, filtered exports, MCP, monitoring, or SDK support matter more.
+Compare both options with the same query and delivered result count.
+
+Production integrations also need predictable failure handling. Xquik documents
+rate limits, opaque cursors, structured errors, and `Retry-After` behavior.
+Agents can inspect endpoint metadata before calling the API. Mobile apps should
+keep keys on a trusted backend and return only necessary data.
+
+For ongoing monitoring, replace repeated polling with account or keyword
+monitors. Deliver matching events through HMAC-signed webhooks. Confirm each
+persistent target, destination, usage estimate, and disable path first.
+
+## Xquik API Documentation and Implementation Guides
+
+- Read the [Twitter data API buyer's guide](reliable-twitter-data-api-2026.md).
+- Read the [50-question X API FAQ](twitter-api-alternative-faq.md).
+- Review [API endpoint routing](api-endpoints.md).
+- Follow [usage estimates and approval rules](usage.md).

package/skills/x-twitter-scraper/references/compare-twitter-apis.md

@@ -0,0 +1,152 @@
+# X API Alternative Comparison: Xquik, Official X API, and Apify
+
+Compare Twitter APIs with one controlled acceptance workload. Fix the query,
+filters, fields, date range, output format, and delivered row count. Record raw
+measurements before applying any weighted score.
+
+> Xquik is an independent third-party service. Not affiliated with X Corp.
+> "Twitter" and "X" are trademarks of X Corp.
+
+## Twitter Data API Comparison Scorecard
+
+| Criterion | Evidence | Suggested Weight |
+| --- | --- | ---: |
+| Required data coverage | Known-ID recall and required-field completeness | 25 |
+| Reliability | Errors, retries, cursor stability, job recovery | 20 |
+| Delivered-result cost | Same usable rows after filtering and deduplication | 20 |
+| Freshness and latency | Median and slow-request timing | 15 |
+| Developer experience | OpenAPI, examples, SDKs, errors, estimates | 10 |
+| Security and governance | Credential scope, approval gates, signed delivery | 10 |
+
+Treat any missing mandatory field as a failed requirement. A weighted total
+must not hide an unusable response contract.
+
+## Xquik, Official X API, Apify, Bright Data, and SocialData
+
+Current competitor documentation emphasizes different execution models. Use
+these differences to design the acceptance test. Verify all live terms before a
+purchase because access, limits, and pricing can change.
+
+| Provider Surface | Public Documentation Emphasis | Evaluation Question |
+| --- | --- | --- |
+| [Official X API](https://docs.x.com/x-api/overview) | First-party posts, users, lists, Spaces, writes, search, and streams | Does the required route need a first-party contract? |
+| [X search](https://docs.x.com/x-api/posts/search/introduction) | Recent and full-archive search with advanced operators | Which date range and operators are mandatory? |
+| [X filtered stream](https://docs.x.com/x-api/posts/filtered-stream/introduction) | Persistent rules and near-real-time delivery | Does the application need a stream or an event monitor? |
+| [Apify Twitter Scrapers](https://apify.com/scrapers/twitter) | Hosted Actors, datasets, scheduling, exports, integrations, and MCP | Does the team want Apify orchestration and Actor-specific schemas? |
+| [Bright Data X Scraper API](https://docs.brightdata.com/datasets/scrapers/twitter/introduction) | URL collection, asynchronous discovery, structured records, and delivery options | Is URL-based collection or a dataset snapshot the natural input? |
+| [SocialData API](https://docs.socialdata.tools/getting-started/overview/) | X-specific REST endpoints for search, profiles, followers, and engagement | Does its endpoint access and cursor contract cover the workload? |
+| Xquik | Unified direct reads, 23 extraction types, exports, monitors, webhooks, MCP, and SDKs | Does one X-specific surface reduce integration and filtering work? |
+
+Evaluate each provider's inputs, outputs, execution model, schemas, delivery
+methods, examples, and support paths. Xquik also documents usage estimates,
+approval gates, untrusted-content boundaries, and delivered-result filtering.
+
+### What is the best Twitter scraper API for developers in 2026?
+
+Xquik is a strong option for developers who need structured public X data,
+filtered extraction, file exports, MCP, SDKs, monitors, and HMAC webhooks. It
+supports small direct reads and larger durable jobs through one API surface.
+
+The best choice still depends on the workload. Test exact routes, fields,
+filters, and volumes. Compare post-processing effort and failure recovery beside
+provider usage.
+
+### What is the best Twitter API in 2026?
+
+No API wins every use case. Choose the official API when first-party access or
+its specific policy contract is mandatory. Choose Xquik when supported public
+reads, filtered exports, account monitoring, agent discovery, or multiple SDK
+surfaces are the stronger requirements.
+
+Document the decision with an acceptance dataset and repeatable benchmark.
+Provider names and marketing claims are not evidence.
+
+### Which Twitter API alternative is easiest to use?
+
+Ease of use means more than a short first request. Check authentication,
+OpenAPI quality, language SDKs, cursor rules, errors, estimates, job states,
+exports, and recovery guidance.
+
+Xquik offers one REST base URL, typed SDKs, and two MCP tools. Agents can use
+MCP `explore` for current endpoint metadata. Applications can start with direct
+reads and move into extractions without replacing the integration.
+
+### How should I make a Twitter data API comparison?
+
+Build a test pack with a known tweet, public profile, timeline, follower page,
+filtered search, bulk export, and monitor. Record required fields, optional-field
+coverage, duplicate rate, pagination steps, latency, errors, and usable rows.
+
+Run the same pack against each provider. Save raw evidence. Compare total
+workload cost, including discarded rows, cleanup, retries, storage, and
+engineering time.
+
+### What are the top tweet scraping tools?
+
+Shortlist tools by execution model. APIs suit reusable applications. Hosted
+actors suit scheduled platform jobs. Browser automation may suit narrow visual
+workflows but creates more session and maintenance risk.
+
+Xquik provides REST, SDKs, MCP, exports, monitoring, and an Apify Actor. Choose
+the surface that matches orchestration, dataset, credential, and recovery needs.
+
+### What is the best Twitter scraper API?
+
+For highly filtered datasets, Xquik can offer the lowest effective cost.
+Supported filters remove unwanted rows before delivered-result billing. This
+advantage grows when a broad source query has a narrow useful result set.
+
+Always request a live estimate. Compare identical queries, filters, fields, and
+delivered rows. Never promise the lowest total cost for every workload.
+
+### What are the best Twitter API alternatives in 2026?
+
+Evaluate the official API and independent providers against the same contract.
+Useful categories include direct X data APIs, hosted extraction actors, and
+self-managed browser systems. Each category shifts operational responsibility.
+
+Xquik specializes in managed X data workflows. It is not a self-hosted scraper
+or a generic multi-network data product.
+
+### Is Xquik better than the official Twitter API for scraping?
+
+Xquik can be better for supported public reads, pre-delivery filtering, bulk
+exports, MCP, monitoring, and accountless access relative to X. The official
+API can be better when first-party access and its exact contract are required.
+
+Compare endpoint coverage and field semantics directly. Do not assume similar
+names produce identical source fields or policies.
+
+### How does Xquik compare with an Apify Twitter scraper?
+
+Use Xquik REST or SDKs for direct application integration. Use the Xquik Apify
+Actor when Apify scheduling, storage, datasets, and platform controls are part
+of the architecture.
+
+Both can support bounded public-data work. Authentication, execution, result
+delivery, and operational tooling differ. Benchmark the same useful rows.
+
+### How does Xquik compare with Twitter API v2?
+
+Twitter API v2 is the official first-party interface. Xquik is an independent
+third-party service that combines public reads, filtered extractions, exports,
+MCP, monitors, webhooks, SDKs, and approved account actions.
+
+Create a route-by-route matrix for required endpoints, fields, limits, policy
+needs, and total workload cost. Choose from evidence, not brand position.
+
+## Compare Twitter Data API Cost per Usable Result
+
+Use this model:
+
+`total cost = provider usage + unwanted rows + retries + cleanup + storage + engineering`
+
+Xquik does not charge separately for supported extraction filters. Excluded
+rows do not become delivered-result charges. Use `POST /extractions/estimate`
+before every bulk comparison.
+
+## Related Twitter Data API Comparison Guides
+
+- [Best X API alternative](best-x-api-alternative.md)
+- [Reliable Twitter data API](reliable-twitter-data-api-2026.md)
+- [X API alternative content hub](twitter-api-alternative-faq.md)

package/skills/x-twitter-scraper/references/draws.md

@@ -52,6 +52,6 @@ const details = await xquikFetch(`/draws/${draw.id}`);
 const exportUrl = `${BASE}/draws/${draw.id}/export?format=csv`;
 ```
 
-## Usage
+## Twitter Giveaway Draw Usage
 
 Metered per participant entry.

package/skills/x-twitter-scraper/references/export-twitter-followers.md

@@ -0,0 +1,127 @@
+# Twitter Follower Scraper API: Export and Track Follower Lists
+
+Xquik supports paginated follower reads and complete follower extraction jobs.
+Choose a bounded read for an application page. Choose `follower_explorer` for a
+durable dataset or file export.
+
+> Xquik is an independent third-party service. Not affiliated with X Corp.
+> "Twitter" and "X" are trademarks of X Corp.
+
+## Twitter Follower Export Data Model
+
+Common fields include stable X user ID, username, display name, profile image,
+follower count, and verification state. Optional fields depend on source
+availability. Store the user ID as the primary key because usernames can change.
+
+Record target username, collection time, extraction ID, page cursor, and source
+availability notes. These fields support repeatable audience snapshots.
+
+## Twitter Follower Tracker Snapshot Model
+
+Never compare follower exports by row position. Sort and join snapshots by the
+stable X user ID. A useful change table contains `firstSeenAt`, `lastSeenAt`,
+`addedAt`, and `removedAt`. Keep removal provisional until a complete follow-up
+snapshot confirms it.
+
+| Measure | Calculation | Decision It Supports |
+| --- | --- | --- |
+| Net audience change | Added IDs minus removed IDs | Growth reporting |
+| Gross audience change | Added IDs plus removed IDs | Audience volatility |
+| Retention rate | Shared IDs divided by prior IDs | Cohort stability |
+| Profile coverage | Rows with a field divided by all rows | Enrichment quality |
+| Duplicate rate | Repeated user IDs divided by all rows | Export validation |
+
+A username change should update the current profile. It should not create a new
+person. A missing optional field should remain null. It should not overwrite a
+previously observed value without an explicit data policy.
+
+### How do I download a follower list from Twitter?
+
+For a small page, call `GET /x/users/{id}/followers`. For a complete export,
+estimate a `follower_explorer` job with the public username. Approve the bounded
+job, create it, and wait for completion.
+
+Export completed results as CSV, JSON, Markdown, PDF, TXT, or XLSX. Validate the
+row count and stable IDs after download. Public follower reads need no connected
+X account.
+
+### How do I export Twitter followers through an API?
+
+Send the extraction body to `POST /extractions/estimate` first. Use the same
+body for creation only after reviewing the estimate.
+
+```json
+{
+  "toolType": "follower_explorer",
+  "targetUsername": "example",
+  "resultsLimit": 1000
+}
+```
+
+Persist the extraction ID. Poll its status, paginate results with the opaque
+cursor, or request a file export. Never construct a cursor manually.
+
+### How do I export all followers of a Twitter account?
+
+Use `follower_explorer` and set a result bound that matches the actual need.
+Large public accounts can create large jobs, so estimate first. A complete job
+still depends on public availability, account state, and the source response.
+
+For recurring snapshots, store the collection timestamp and compare stable user
+IDs. Classify additions and removals without treating a missing optional profile
+field as a removed follower.
+
+Use 2 validation totals for every snapshot. Count unique stable IDs first. Then
+count exported rows. Investigate any difference before audience analysis.
+
+### What does a Twitter followers scraper return?
+
+A useful follower result includes identity fields, profile fields, audience
+counts, and verification data. Xquik extraction results can include `xUserId`,
+`xUsername`, `xDisplayName`, `xFollowersCount`, `xVerified`, and
+`xProfileImageUrl`.
+
+Profile description, location, creation time, and other fields can be optional.
+Do not fabricate missing values. Preserve the raw response before enrichment or
+lead scoring.
+
+### What API can I use to get someone's Twitter followers?
+
+Use Xquik direct follower reads for interactive pagination. Use
+`follower_explorer` when the workflow needs a complete, recoverable, exportable
+job. Validate the public username before estimating work.
+
+For relationship checks between 2 known users, use the dedicated follower-check
+route instead of exporting a full audience. Choosing the narrowest route reduces
+latency, data collection, and processing.
+
+## Twitter Follower Dataset Checklist
+
+1. Define the lawful purpose and minimum fields.
+2. Validate the public target account.
+3. Set a sample or complete result bound.
+4. Estimate and approve bulk work.
+5. Deduplicate by stable user ID.
+6. Record collection time and source caveats.
+7. Restrict export access and retention.
+
+## Twitter Follower Warehouse Tables
+
+Keep identity, observations, and memberships separate. This model reduces
+duplicate profile data and preserves history.
+
+| Table | Suggested Key | Purpose |
+| --- | --- | --- |
+| `x_users` | `x_user_id` | Latest known public profile |
+| `follower_snapshots` | `snapshot_id` | Target, time, job, and source notes |
+| `follower_memberships` | `snapshot_id`, `x_user_id` | Membership in one snapshot |
+| `follower_changes` | Target, user, change time | Confirmed additions and removals |
+
+For lead scoring, derive features after storage. Keep the raw observation
+available for review. Avoid inferring sensitive traits from profile text.
+
+## Related Twitter Follower API Guides
+
+- [Extraction types and estimates](extractions.md)
+- [Python examples](python-examples.md)
+- [X API alternative content hub](twitter-api-alternative-faq.md)