Twitter scraping cost estimator & credit quote

POST

extractions

estimate

curl --request POST \
  --url https://xquik.com/api/v1/extractions/estimate \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "toolType": "<string>",
  "targetTweetId": "<string>",
  "targetUsername": "<string>",
  "targetCommunityId": "<string>",
  "searchQuery": "<string>",
  "targetListId": "<string>",
  "targetSpaceId": "<string>",
  "resultsLimit": 123
}
'

import requests

url = "https://xquik.com/api/v1/extractions/estimate"

payload = {
    "toolType": "<string>",
    "targetTweetId": "<string>",
    "targetUsername": "<string>",
    "targetCommunityId": "<string>",
    "searchQuery": "<string>",
    "targetListId": "<string>",
    "targetSpaceId": "<string>",
    "resultsLimit": 123
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({
    toolType: '<string>',
    targetTweetId: '<string>',
    targetUsername: '<string>',
    targetCommunityId: '<string>',
    searchQuery: '<string>',
    targetListId: '<string>',
    targetSpaceId: '<string>',
    resultsLimit: 123
  })
};

fetch('https://xquik.com/api/v1/extractions/estimate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/extractions/estimate"

	payload := strings.NewReader("{\n  \"toolType\": \"<string>\",\n  \"targetTweetId\": \"<string>\",\n  \"targetUsername\": \"<string>\",\n  \"targetCommunityId\": \"<string>\",\n  \"searchQuery\": \"<string>\",\n  \"targetListId\": \"<string>\",\n  \"targetSpaceId\": \"<string>\",\n  \"resultsLimit\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Free - does not consume credits

curl -X POST https://xquik.com/api/v1/extractions/estimate \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "toolType": "reply_extractor",
    "targetTweetId": "1893704267862470862",
    "resultsLimit": 500
  }' | jq

const response = await fetch("https://xquik.com/api/v1/extractions/estimate", {
  method: "POST",
  headers: {
    "x-api-key": "xq_YOUR_KEY_HERE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    toolType: "reply_extractor",
    targetTweetId: "1893704267862470862",
    resultsLimit: 500,
  }),
});
const data = await response.json();

if (data.allowed) {
  // Safe to proceed with extraction
}

import requests

response = requests.post(
    "https://xquik.com/api/v1/extractions/estimate",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    json={
        "toolType": "reply_extractor",
        "targetTweetId": "1893704267862470862",
        "resultsLimit": 500,
    },
)
data = response.json()

if data.get("allowed"):
    # Safe to proceed with extraction
    pass

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    body, _ := json.Marshal(map[string]interface{}{
        "toolType":      "reply_extractor",
        "targetTweetId": "1893704267862470862",
        "resultsLimit":  500,
    })

    req, err := http.NewRequest("POST", "https://xquik.com/api/v1/extractions/estimate", bytes.NewReader(body))
    if err != nil {
        panic(err)
    }
    req.Header.Set("x-api-key", "xq_YOUR_KEY_HERE")
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var data map[string]interface{}
    if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
        panic(err)
    }
    fmt.Println(data)
}

Headers

string

required

Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.

string

required

Must be application/json.

Body

The request body accepts the same fields as Create Extraction, including all 16 tweet search filter parameters. Only toolType and the corresponding target field are required for the estimate.

string

required

Extraction tool to estimate. One of: article_extractor, community_extractor, community_moderator_explorer, community_post_extractor, community_search, favoriters, follower_explorer, following_explorer, list_follower_explorer, list_member_extractor, list_post_extractor, mention_extractor, people_search, post_extractor, quote_extractor, reply_extractor, repost_extractor, space_explorer, thread_extractor, tweet_search_extractor, user_likes, user_media, verified_follower_explorer.

string

Tweet ID to estimate. Required for reply_extractor, repost_extractor, quote_extractor, thread_extractor, article_extractor.

string

X username to estimate. Required for follower_explorer, following_explorer, verified_follower_explorer, mention_extractor, post_extractor, user_likes, and user_media.

string

Community ID to estimate. Required for community_extractor, community_moderator_explorer, community_post_extractor, and community_search.

string

Search query to estimate. Required for people_search, community_search, tweet_search_extractor.

string

X List ID to estimate. Required for list_member_extractor, list_post_extractor, list_follower_explorer.

string

X Space ID to estimate. Required for space_explorer.

integer

Maximum number of results to extract. When set, the estimate caps estimatedResults to this value and adjusts projected usage accordingly. Useful for previewing the cost of a partial extraction.

Response

boolean

Whether the extraction can proceed given the current credit balance.

string

Data source used for the estimate. One of: followers, following, paginationCap, posts, quoteCount, replyCount, resultsLimit, retweetCount, unknown.

number

Estimated number of results the extraction will return.

string

Credits this extraction will consume (stringified integer).

string

Credits currently available in your balance (stringified integer).

string

Resolved X user ID when targetUsername was provided. Omitted for non-user-based tools.

{
  "allowed": true,
  "creditsRequired": "500",
  "creditsAvailable": "50000",
  "estimatedResults": 250,
  "source": "replyCount",
  "resolvedXUserId": "123456"
}

When allowed is false, credits required exceed the available balance:

{
  "allowed": false,
  "creditsRequired": "250000",
  "creditsAvailable": "18000",
  "estimatedResults": 250000,
  "source": "followers"
}

{ "error": "invalid_input" }

Request body is missing or malformed. Ensure toolType and the corresponding target field are present.

{ "error": "invalid_tool_type" }

The toolType value is not one of the 23 supported tools.

{ "error": "unauthenticated" }

Missing or invalid API key.

{ "error": "insufficient_credits" }

The available balance cannot cover the estimate. Possible error values include no_subscription, subscription_inactive, no_credits, and insufficient_credits.

{ "error": "tweet_not_found", "message": "Tweet not found" }

The target tweet does not exist, was deleted, or the ID is invalid.

{ "error": "user_not_found", "message": "X user not found" }

The target user does not exist or is suspended.

{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }

Wait for the Retry-After value before requesting another estimate.

Decision handoff

Treat the 200 OK response as a planning checkpoint, not a running extraction. Store the estimate with the request you plan to run:

{
  "checkpoint_type": "extraction_estimate",
  "toolType": "reply_extractor",
  "targetTweetId": "1893704267862470862",
  "resultsLimit": 500,
  "estimatedResults": 500,
  "creditsRequired": "500",
  "creditsAvailable": "50000",
  "allowed": true,
  "source": "replyCount",
  "next_action": "create_extraction",
  "create_path": "/api/v1/extractions",
  "fallback_action": "lower_results_limit_or_add_credits"
}

Allowed run

When allowed is true, send the same toolType, target fields, filters, and resultsLimit to Create Extraction. Store the returned job ID from that 202 Accepted receipt.

Blocked run

When allowed is false, lower resultsLimit, narrow the target or filters, or add credits before calling Create Extraction.

Source signal

Store source so operators know whether the estimate came from replyCount, followers, resultsLimit, paginationCap, or another supported signal.

Audit fields

Store estimatedResults, creditsRequired, creditsAvailable, allowed, and source with the planned extraction request.

Always call this endpoint before running an extraction to avoid hitting credit limits. If allowed is false, the corresponding Create Extraction request will return a 402 error. Check your current usage on the dashboard.

Next steps: Create Extraction to start an extraction, or Extraction Workflow Guide for the full flow.

Last modified on July 31, 2026

Build a post draftGenerate editorial rules, refine a tweet or thread plan, and check a post draft for clarity, tone, structure, claims, and platform fit.

Twitter scraping cost estimator & credit quote

curl --request POST \
  --url https://xquik.com/api/v1/extractions/estimate \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "toolType": "<string>",
  "targetTweetId": "<string>",
  "targetUsername": "<string>",
  "targetCommunityId": "<string>",
  "searchQuery": "<string>",
  "targetListId": "<string>",
  "targetSpaceId": "<string>",
  "resultsLimit": 123
}
'

import requests

url = "https://xquik.com/api/v1/extractions/estimate"

payload = {
    "toolType": "<string>",
    "targetTweetId": "<string>",
    "targetUsername": "<string>",
    "targetCommunityId": "<string>",
    "searchQuery": "<string>",
    "targetListId": "<string>",
    "targetSpaceId": "<string>",
    "resultsLimit": 123
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({
    toolType: '<string>',
    targetTweetId: '<string>',
    targetUsername: '<string>',
    targetCommunityId: '<string>',
    searchQuery: '<string>',
    targetListId: '<string>',
    targetSpaceId: '<string>',
    resultsLimit: 123
  })
};

fetch('https://xquik.com/api/v1/extractions/estimate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/extractions/estimate"

	payload := strings.NewReader("{\n  \"toolType\": \"<string>\",\n  \"targetTweetId\": \"<string>\",\n  \"targetUsername\": \"<string>\",\n  \"targetCommunityId\": \"<string>\",\n  \"searchQuery\": \"<string>\",\n  \"targetListId\": \"<string>\",\n  \"targetSpaceId\": \"<string>\",\n  \"resultsLimit\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Overview

X API

X Write

Trends

Radar

Account

API Keys

Guest Wallets

Credits

X Accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Twitter scraping cost estimator & credit quote

Headers

Body

Response

Decision handoff

Allowed run

Blocked run

Source signal

Audit fields

​Headers

​Body

​Response

​Decision handoff

Allowed run

Blocked run

Source signal

Audit fields

Headers

Body

Response

Decision handoff