Twitter Scraping Cost Estimator & Credit Quote

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

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

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

POST

extractions

estimate

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>",
  "targetListId": "<string>",
  "targetSpaceId": "<string>",
  "searchQuery": "<string>",
  "targetTweetIds": [
    "<string>"
  ],
  "targetUsernames": [
    "<string>"
  ],
  "targetCommunityIds": [
    "<string>"
  ],
  "targetListIds": [
    "<string>"
  ],
  "searchQueries": [
    "<string>"
  ],
  "targets": [
    {}
  ],
  "relationTargets": [
    {}
  ],
  "queryType": "<string>",
  "resultsLimit": 123,
  "maxItemsPerTarget": 123,
  "maxPagesPerTarget": 123,
  "startCursor": "<string>",
  "dedupeAcrossTargets": true,
  "dedupeMode": "<string>",
  "overlapMode": true,
  "includeSearchTerms": true,
  "includeTargetMetadata": true,
  "collectionStrategy": "<string>",
  "scope": "<string>",
  "maxDepth": 123,
  "sort": "<string>",
  "excludeOriginalAuthor": true,
  "includeOriginalPost": true,
  "hasMediaOnly": true,
  "sinceTime": {},
  "untilTime": {},
  "minViews": 123,
  "minBookmarks": 123,
  "maxLikes": 123,
  "maxRetweets": 123,
  "maxReplies": 123,
  "maxQuotes": 123,
  "blueVerifiedOnly": true,
  "cardName": "<string>",
  "source": "<string>",
  "excludeSource": "<string>",
  "geocode": "<string>",
  "sinceId": "<string>",
  "maxId": "<string>",
  "near": "<string>",
  "within": "<string>",
  "withinTime": "<string>",
  "nativeRetweets": true,
  "safe": true,
  "news": true,
  "minFollowers": 123,
  "maxFollowers": 123,
  "minFollowing": 123,
  "maxFollowing": 123,
  "minPosts": 123,
  "maxPosts": 123,
  "minAccountAgeDays": 123,
  "verifiedType": "<string>",
  "hasWebsite": true,
  "hasLocation": true,
  "bioContains": "<string>",
  "locationContains": "<string>",
  "usernameContains": "<string>",
  "fromUser": "<string>",
  "toUser": "<string>",
  "mentioning": "<string>",
  "language": "<string>",
  "sinceDate": "<string>",
  "untilDate": "<string>",
  "mediaType": "<string>",
  "minFaves": 123,
  "minRetweets": 123,
  "minReplies": 123,
  "minQuotes": 123,
  "verifiedOnly": true,
  "replies": "<string>",
  "retweets": "<string>",
  "quotes": "<string>",
  "exactPhrase": "<string>",
  "excludeWords": "<string>",
  "anyWords": "<string>",
  "hashtags": "<string>",
  "cashtags": "<string>",
  "url": "<string>",
  "conversationId": "<string>",
  "inReplyToTweetId": "<string>",
  "quotesOfTweetId": "<string>",
  "retweetsOfTweetId": "<string>",
  "listId": "<string>",
  "place": "<string>",
  "placeCountry": "<string>",
  "pointRadius": "<string>",
  "boundingBox": "<string>",
  "advancedQuery": "<string>"
}
'

import requests

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

payload = {
    "toolType": "<string>",
    "targetTweetId": "<string>",
    "targetUsername": "<string>",
    "targetCommunityId": "<string>",
    "targetListId": "<string>",
    "targetSpaceId": "<string>",
    "searchQuery": "<string>",
    "targetTweetIds": ["<string>"],
    "targetUsernames": ["<string>"],
    "targetCommunityIds": ["<string>"],
    "targetListIds": ["<string>"],
    "searchQueries": ["<string>"],
    "targets": [{}],
    "relationTargets": [{}],
    "queryType": "<string>",
    "resultsLimit": 123,
    "maxItemsPerTarget": 123,
    "maxPagesPerTarget": 123,
    "startCursor": "<string>",
    "dedupeAcrossTargets": True,
    "dedupeMode": "<string>",
    "overlapMode": True,
    "includeSearchTerms": True,
    "includeTargetMetadata": True,
    "collectionStrategy": "<string>",
    "scope": "<string>",
    "maxDepth": 123,
    "sort": "<string>",
    "excludeOriginalAuthor": True,
    "includeOriginalPost": True,
    "hasMediaOnly": True,
    "sinceTime": {},
    "untilTime": {},
    "minViews": 123,
    "minBookmarks": 123,
    "maxLikes": 123,
    "maxRetweets": 123,
    "maxReplies": 123,
    "maxQuotes": 123,
    "blueVerifiedOnly": True,
    "cardName": "<string>",
    "source": "<string>",
    "excludeSource": "<string>",
    "geocode": "<string>",
    "sinceId": "<string>",
    "maxId": "<string>",
    "near": "<string>",
    "within": "<string>",
    "withinTime": "<string>",
    "nativeRetweets": True,
    "safe": True,
    "news": True,
    "minFollowers": 123,
    "maxFollowers": 123,
    "minFollowing": 123,
    "maxFollowing": 123,
    "minPosts": 123,
    "maxPosts": 123,
    "minAccountAgeDays": 123,
    "verifiedType": "<string>",
    "hasWebsite": True,
    "hasLocation": True,
    "bioContains": "<string>",
    "locationContains": "<string>",
    "usernameContains": "<string>",
    "fromUser": "<string>",
    "toUser": "<string>",
    "mentioning": "<string>",
    "language": "<string>",
    "sinceDate": "<string>",
    "untilDate": "<string>",
    "mediaType": "<string>",
    "minFaves": 123,
    "minRetweets": 123,
    "minReplies": 123,
    "minQuotes": 123,
    "verifiedOnly": True,
    "replies": "<string>",
    "retweets": "<string>",
    "quotes": "<string>",
    "exactPhrase": "<string>",
    "excludeWords": "<string>",
    "anyWords": "<string>",
    "hashtags": "<string>",
    "cashtags": "<string>",
    "url": "<string>",
    "conversationId": "<string>",
    "inReplyToTweetId": "<string>",
    "quotesOfTweetId": "<string>",
    "retweetsOfTweetId": "<string>",
    "listId": "<string>",
    "place": "<string>",
    "placeCountry": "<string>",
    "pointRadius": "<string>",
    "boundingBox": "<string>",
    "advancedQuery": "<string>"
}
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>',
    targetListId: '<string>',
    targetSpaceId: '<string>',
    searchQuery: '<string>',
    targetTweetIds: ['<string>'],
    targetUsernames: ['<string>'],
    targetCommunityIds: ['<string>'],
    targetListIds: ['<string>'],
    searchQueries: ['<string>'],
    targets: [{}],
    relationTargets: [{}],
    queryType: '<string>',
    resultsLimit: 123,
    maxItemsPerTarget: 123,
    maxPagesPerTarget: 123,
    startCursor: '<string>',
    dedupeAcrossTargets: true,
    dedupeMode: '<string>',
    overlapMode: true,
    includeSearchTerms: true,
    includeTargetMetadata: true,
    collectionStrategy: '<string>',
    scope: '<string>',
    maxDepth: 123,
    sort: '<string>',
    excludeOriginalAuthor: true,
    includeOriginalPost: true,
    hasMediaOnly: true,
    sinceTime: {},
    untilTime: {},
    minViews: 123,
    minBookmarks: 123,
    maxLikes: 123,
    maxRetweets: 123,
    maxReplies: 123,
    maxQuotes: 123,
    blueVerifiedOnly: true,
    cardName: '<string>',
    source: '<string>',
    excludeSource: '<string>',
    geocode: '<string>',
    sinceId: '<string>',
    maxId: '<string>',
    near: '<string>',
    within: '<string>',
    withinTime: '<string>',
    nativeRetweets: true,
    safe: true,
    news: true,
    minFollowers: 123,
    maxFollowers: 123,
    minFollowing: 123,
    maxFollowing: 123,
    minPosts: 123,
    maxPosts: 123,
    minAccountAgeDays: 123,
    verifiedType: '<string>',
    hasWebsite: true,
    hasLocation: true,
    bioContains: '<string>',
    locationContains: '<string>',
    usernameContains: '<string>',
    fromUser: '<string>',
    toUser: '<string>',
    mentioning: '<string>',
    language: '<string>',
    sinceDate: '<string>',
    untilDate: '<string>',
    mediaType: '<string>',
    minFaves: 123,
    minRetweets: 123,
    minReplies: 123,
    minQuotes: 123,
    verifiedOnly: true,
    replies: '<string>',
    retweets: '<string>',
    quotes: '<string>',
    exactPhrase: '<string>',
    excludeWords: '<string>',
    anyWords: '<string>',
    hashtags: '<string>',
    cashtags: '<string>',
    url: '<string>',
    conversationId: '<string>',
    inReplyToTweetId: '<string>',
    quotesOfTweetId: '<string>',
    retweetsOfTweetId: '<string>',
    listId: '<string>',
    place: '<string>',
    placeCountry: '<string>',
    pointRadius: '<string>',
    boundingBox: '<string>',
    advancedQuery: '<string>'
  })
};

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  \"targetListId\": \"<string>\",\n  \"targetSpaceId\": \"<string>\",\n  \"searchQuery\": \"<string>\",\n  \"targetTweetIds\": [\n    \"<string>\"\n  ],\n  \"targetUsernames\": [\n    \"<string>\"\n  ],\n  \"targetCommunityIds\": [\n    \"<string>\"\n  ],\n  \"targetListIds\": [\n    \"<string>\"\n  ],\n  \"searchQueries\": [\n    \"<string>\"\n  ],\n  \"targets\": [\n    {}\n  ],\n  \"relationTargets\": [\n    {}\n  ],\n  \"queryType\": \"<string>\",\n  \"resultsLimit\": 123,\n  \"maxItemsPerTarget\": 123,\n  \"maxPagesPerTarget\": 123,\n  \"startCursor\": \"<string>\",\n  \"dedupeAcrossTargets\": true,\n  \"dedupeMode\": \"<string>\",\n  \"overlapMode\": true,\n  \"includeSearchTerms\": true,\n  \"includeTargetMetadata\": true,\n  \"collectionStrategy\": \"<string>\",\n  \"scope\": \"<string>\",\n  \"maxDepth\": 123,\n  \"sort\": \"<string>\",\n  \"excludeOriginalAuthor\": true,\n  \"includeOriginalPost\": true,\n  \"hasMediaOnly\": true,\n  \"sinceTime\": {},\n  \"untilTime\": {},\n  \"minViews\": 123,\n  \"minBookmarks\": 123,\n  \"maxLikes\": 123,\n  \"maxRetweets\": 123,\n  \"maxReplies\": 123,\n  \"maxQuotes\": 123,\n  \"blueVerifiedOnly\": true,\n  \"cardName\": \"<string>\",\n  \"source\": \"<string>\",\n  \"excludeSource\": \"<string>\",\n  \"geocode\": \"<string>\",\n  \"sinceId\": \"<string>\",\n  \"maxId\": \"<string>\",\n  \"near\": \"<string>\",\n  \"within\": \"<string>\",\n  \"withinTime\": \"<string>\",\n  \"nativeRetweets\": true,\n  \"safe\": true,\n  \"news\": true,\n  \"minFollowers\": 123,\n  \"maxFollowers\": 123,\n  \"minFollowing\": 123,\n  \"maxFollowing\": 123,\n  \"minPosts\": 123,\n  \"maxPosts\": 123,\n  \"minAccountAgeDays\": 123,\n  \"verifiedType\": \"<string>\",\n  \"hasWebsite\": true,\n  \"hasLocation\": true,\n  \"bioContains\": \"<string>\",\n  \"locationContains\": \"<string>\",\n  \"usernameContains\": \"<string>\",\n  \"fromUser\": \"<string>\",\n  \"toUser\": \"<string>\",\n  \"mentioning\": \"<string>\",\n  \"language\": \"<string>\",\n  \"sinceDate\": \"<string>\",\n  \"untilDate\": \"<string>\",\n  \"mediaType\": \"<string>\",\n  \"minFaves\": 123,\n  \"minRetweets\": 123,\n  \"minReplies\": 123,\n  \"minQuotes\": 123,\n  \"verifiedOnly\": true,\n  \"replies\": \"<string>\",\n  \"retweets\": \"<string>\",\n  \"quotes\": \"<string>\",\n  \"exactPhrase\": \"<string>\",\n  \"excludeWords\": \"<string>\",\n  \"anyWords\": \"<string>\",\n  \"hashtags\": \"<string>\",\n  \"cashtags\": \"<string>\",\n  \"url\": \"<string>\",\n  \"conversationId\": \"<string>\",\n  \"inReplyToTweetId\": \"<string>\",\n  \"quotesOfTweetId\": \"<string>\",\n  \"retweetsOfTweetId\": \"<string>\",\n  \"listId\": \"<string>\",\n  \"place\": \"<string>\",\n  \"placeCountry\": \"<string>\",\n  \"pointRadius\": \"<string>\",\n  \"boundingBox\": \"<string>\",\n  \"advancedQuery\": \"<string>\"\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))

}

{
  "allowed": true,
  "source": "<string>",
  "estimatedResults": 123,
  "creditsRequired": "<string>",
  "creditsAvailable": "<string>",
  "resolvedXUserId": "<string>"
}

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)
}

Estimate Twitter API Scraping Cost

Request a free credit quote before starting any extraction. The response estimates results and required credits. It also checks your available credit balance. A quote never starts a scraping job. Use the same request fields for estimation and extraction. Keep toolType, target fields, filters, and resultsLimit unchanged. This pairing makes the API cost estimate useful during approval and budgeting.

Match Each Scraping Task

Choose the tool matching the tweets, profiles, or members you need.

Twitter scraping task	`toolType`	Required target	Estimated results
Search tweets with filters	`tweet_search_extractor`	`searchQuery`	Matching tweet search results
Export tweet replies	`reply_extractor`	`targetTweetId`	Replies beneath one tweet
Export followers	`follower_explorer`	`targetUsername`	Follower profiles
Export following	`following_explorer`	`targetUsername`	Followed profiles
Export profile tweets	`post_extractor`	`targetUsername`	Tweets from one profile
Export community tweets	`community_post_extractor`	`targetCommunityId`	Tweets from one community
Export list members	`list_member_extractor`	`targetListId`	Profiles inside one list
Export list tweets	`list_post_extractor`	`targetListId`	Tweets from list members

Other supported tools estimate likes, media, mentions, quotes, reposts, threads, Spaces, and articles. Use their matching target fields below.

Control the Credit Quote

Set resultsLimit when you need a smaller export. The estimator caps estimatedResults at that limit. It then adjusts creditsRequired for the capped result count. Narrow tweet search estimates with dates, authors, languages, engagement thresholds, or media filters. Reuse those filters when creating the extraction. Changed filters can produce a different estimate. The source field explains the result-count signal. Examples include followers, following, posts, replyCount, quoteCount, retweetCount, and resultsLimit. Save this field beside the credit quote.

Start with a conservative resultsLimit. Increase it after the first quote passes your budget.

Read the Estimate

Check these response fields before creating the extraction:

estimatedResults projects the matching tweets, replies, profiles, or members.
creditsRequired states the projected credit charge.
creditsAvailable states the current balance.
allowed confirms whether that balance covers the estimate.
source identifies the signal behind the projected result count.

When allowed is false, reduce the requested result count. You can also narrow filters or add credits. Request another quote before creating the extraction.

Headers

string

required

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

string

required

Must be application/json.

The estimator accepts the same fields as Create Extraction.

Body

string

required

Extraction tool to run or estimate. See the endpoint’s tool list.

Single Targets

string

Tweet ID for a tweet-centered extraction.

string

Username for an account-centered extraction. You may include @.

string

Community ID for a community extraction.

string

List ID for a list extraction.

string

Space ID for space_explorer.

string

Query for tweet_search_extractor or community_search.

Collection Targets

string[]

Process 1-10,000 Tweet IDs in one collection job.

string[]

Process 1-100 unique usernames in one collection job.

string[]

Process 1-100 unique community IDs in one collection job.

string[]

Process 1-100 unique List IDs in one collection job.

string[]

Process 1-100 unique search queries in one collection job.

array

Process up to 10,000 mixed targets with automatic routing.

Each target accepts a supported string or { "kind": "...", "value": "..." }.

array

Process up to 100 profile relations in one collection job.

Each relation target uses { "relation": "...", "value": "..." }.

Collection Controls

string

Search ranking: Latest, Top, or Both. Defaults to Latest.

integer

Stop after this many results. Omit it to collect all available results.

integer

Maximum results collected for each target. Minimum: 1.

integer

Reply pages collected per target. Range: 1-1,000.

string

Resume one reply target from this cursor.

boolean

Merge duplicates across targets. Defaults to true.

string

Duplicate handling: none, first, or merge.

boolean

Use dedupeMode=merge. Defaults to false.

boolean

Add matched search terms to collection metadata. Defaults to false.

boolean

Add source target metadata to each result. Defaults to true.

Reply Collection

string

Strategy: auto, complete, direct, search, or thread.

string

Reply scope: all, direct, or nested. Defaults to all.

integer

Maximum nested reply depth. Minimum: 1.

string

Order: relevance, latest, oldest, or likes.

boolean

Exclude replies from the source author. Defaults to false.

boolean

Include the source post. Defaults to false.

boolean

Return only replies with media. Defaults to false.

string | integer

Reply start time as ISO 8601 or Unix seconds.

string | integer

Reply end time as ISO 8601 or Unix seconds.

Tweet Result Filters

integer

Minimum Tweet view count.

integer

Minimum Tweet bookmark count.

integer

Maximum Tweet like count.

integer

Maximum Tweet repost count.

integer

Maximum Tweet reply count.

integer

Maximum Tweet quote count.

boolean

Return only Blue-verified Tweet authors. Defaults to false.

string

Match the Tweet card name.

string

Match the source application.

string

Exclude a source application.

string

Match latitude, longitude, and radius.

string

Return Tweets newer than this Tweet ID.

string

Return Tweets older than this Tweet ID.

string

Match a place name.

string

Set the radius for near.

string

Match Tweets inside a recent time window.

boolean

Return only native reposts. Defaults to false.

boolean

Enable safe search. Defaults to false.

boolean

Return only news results. Defaults to false.

Profile Result Filters

integer

Minimum profile follower count.

integer

Maximum profile follower count.

integer

Minimum profile following count.

integer

Maximum profile following count.

integer

Minimum profile post count.

integer

Maximum profile post count.

integer

Minimum profile age in days.

string

Match the exact profile verification type.

boolean

Require a profile website. Defaults to false.

boolean

Require a profile location. Defaults to false.

string

Require bio terms separated by commas or lines.

string

Require matching profile location text.

string

Require matching username text.

These fields apply to tweet_search_extractor.

string

Match an author username without @.

string

Match replies sent to a username.

string

Match Tweets mentioning a username.

string

Match a language code, such as en.

string

Include Tweets on or after YYYY-MM-DD.

string

Include Tweets before YYYY-MM-DD.

string

Media: images, videos, gifs, media, links, or none.

integer

Minimum like count.

integer

Minimum repost count.

integer

Minimum reply count.

integer

Minimum quote count.

boolean

Return only verified authors.

string

Reply mode: include, exclude, or only.

string

Repost mode: include, exclude, or only.

string

Quote mode: include, exclude, or only.

string

Match one exact phrase.

string

Exclude words or quoted phrases.

string

Match any listed word or quoted phrase.

string

Match hashtags separated by spaces, commas, or lines.

string

Match cashtags separated by spaces, commas, or lines.

string

Match a URL substring or domain.

string

Match a conversation ID.

string

Return only replies to this Tweet ID.

string

Return only quotes of this Tweet ID.

string

Return only reposts of this Tweet ID.

string

Search within a List ID.

string

Search within a place ID.

string

Search within a country code.

string

Set a geographic center and radius.

string

Set a geographic bounding box.

string

Append raw advanced search syntax.

Response

200 OK

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"
}

400 Invalid input

{ "error": "invalid_input" }

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

400 Invalid tool type

{ "error": "invalid_tool_type" }

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

401 Unauthenticated

{ "error": "unauthenticated" }

Missing or invalid API key.

402 Insufficient credits

{ "error": "insufficient_credits" }

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

404 Not Found

{ "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.

429 Rate Limited

{ "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. This prevents avoidable credit errors. If allowed is false, Create Extraction returns 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.

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

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

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

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>",
  "targetListId": "<string>",
  "targetSpaceId": "<string>",
  "searchQuery": "<string>",
  "targetTweetIds": [
    "<string>"
  ],
  "targetUsernames": [
    "<string>"
  ],
  "targetCommunityIds": [
    "<string>"
  ],
  "targetListIds": [
    "<string>"
  ],
  "searchQueries": [
    "<string>"
  ],
  "targets": [
    {}
  ],
  "relationTargets": [
    {}
  ],
  "queryType": "<string>",
  "resultsLimit": 123,
  "maxItemsPerTarget": 123,
  "maxPagesPerTarget": 123,
  "startCursor": "<string>",
  "dedupeAcrossTargets": true,
  "dedupeMode": "<string>",
  "overlapMode": true,
  "includeSearchTerms": true,
  "includeTargetMetadata": true,
  "collectionStrategy": "<string>",
  "scope": "<string>",
  "maxDepth": 123,
  "sort": "<string>",
  "excludeOriginalAuthor": true,
  "includeOriginalPost": true,
  "hasMediaOnly": true,
  "sinceTime": {},
  "untilTime": {},
  "minViews": 123,
  "minBookmarks": 123,
  "maxLikes": 123,
  "maxRetweets": 123,
  "maxReplies": 123,
  "maxQuotes": 123,
  "blueVerifiedOnly": true,
  "cardName": "<string>",
  "source": "<string>",
  "excludeSource": "<string>",
  "geocode": "<string>",
  "sinceId": "<string>",
  "maxId": "<string>",
  "near": "<string>",
  "within": "<string>",
  "withinTime": "<string>",
  "nativeRetweets": true,
  "safe": true,
  "news": true,
  "minFollowers": 123,
  "maxFollowers": 123,
  "minFollowing": 123,
  "maxFollowing": 123,
  "minPosts": 123,
  "maxPosts": 123,
  "minAccountAgeDays": 123,
  "verifiedType": "<string>",
  "hasWebsite": true,
  "hasLocation": true,
  "bioContains": "<string>",
  "locationContains": "<string>",
  "usernameContains": "<string>",
  "fromUser": "<string>",
  "toUser": "<string>",
  "mentioning": "<string>",
  "language": "<string>",
  "sinceDate": "<string>",
  "untilDate": "<string>",
  "mediaType": "<string>",
  "minFaves": 123,
  "minRetweets": 123,
  "minReplies": 123,
  "minQuotes": 123,
  "verifiedOnly": true,
  "replies": "<string>",
  "retweets": "<string>",
  "quotes": "<string>",
  "exactPhrase": "<string>",
  "excludeWords": "<string>",
  "anyWords": "<string>",
  "hashtags": "<string>",
  "cashtags": "<string>",
  "url": "<string>",
  "conversationId": "<string>",
  "inReplyToTweetId": "<string>",
  "quotesOfTweetId": "<string>",
  "retweetsOfTweetId": "<string>",
  "listId": "<string>",
  "place": "<string>",
  "placeCountry": "<string>",
  "pointRadius": "<string>",
  "boundingBox": "<string>",
  "advancedQuery": "<string>"
}
'

import requests

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

payload = {
    "toolType": "<string>",
    "targetTweetId": "<string>",
    "targetUsername": "<string>",
    "targetCommunityId": "<string>",
    "targetListId": "<string>",
    "targetSpaceId": "<string>",
    "searchQuery": "<string>",
    "targetTweetIds": ["<string>"],
    "targetUsernames": ["<string>"],
    "targetCommunityIds": ["<string>"],
    "targetListIds": ["<string>"],
    "searchQueries": ["<string>"],
    "targets": [{}],
    "relationTargets": [{}],
    "queryType": "<string>",
    "resultsLimit": 123,
    "maxItemsPerTarget": 123,
    "maxPagesPerTarget": 123,
    "startCursor": "<string>",
    "dedupeAcrossTargets": True,
    "dedupeMode": "<string>",
    "overlapMode": True,
    "includeSearchTerms": True,
    "includeTargetMetadata": True,
    "collectionStrategy": "<string>",
    "scope": "<string>",
    "maxDepth": 123,
    "sort": "<string>",
    "excludeOriginalAuthor": True,
    "includeOriginalPost": True,
    "hasMediaOnly": True,
    "sinceTime": {},
    "untilTime": {},
    "minViews": 123,
    "minBookmarks": 123,
    "maxLikes": 123,
    "maxRetweets": 123,
    "maxReplies": 123,
    "maxQuotes": 123,
    "blueVerifiedOnly": True,
    "cardName": "<string>",
    "source": "<string>",
    "excludeSource": "<string>",
    "geocode": "<string>",
    "sinceId": "<string>",
    "maxId": "<string>",
    "near": "<string>",
    "within": "<string>",
    "withinTime": "<string>",
    "nativeRetweets": True,
    "safe": True,
    "news": True,
    "minFollowers": 123,
    "maxFollowers": 123,
    "minFollowing": 123,
    "maxFollowing": 123,
    "minPosts": 123,
    "maxPosts": 123,
    "minAccountAgeDays": 123,
    "verifiedType": "<string>",
    "hasWebsite": True,
    "hasLocation": True,
    "bioContains": "<string>",
    "locationContains": "<string>",
    "usernameContains": "<string>",
    "fromUser": "<string>",
    "toUser": "<string>",
    "mentioning": "<string>",
    "language": "<string>",
    "sinceDate": "<string>",
    "untilDate": "<string>",
    "mediaType": "<string>",
    "minFaves": 123,
    "minRetweets": 123,
    "minReplies": 123,
    "minQuotes": 123,
    "verifiedOnly": True,
    "replies": "<string>",
    "retweets": "<string>",
    "quotes": "<string>",
    "exactPhrase": "<string>",
    "excludeWords": "<string>",
    "anyWords": "<string>",
    "hashtags": "<string>",
    "cashtags": "<string>",
    "url": "<string>",
    "conversationId": "<string>",
    "inReplyToTweetId": "<string>",
    "quotesOfTweetId": "<string>",
    "retweetsOfTweetId": "<string>",
    "listId": "<string>",
    "place": "<string>",
    "placeCountry": "<string>",
    "pointRadius": "<string>",
    "boundingBox": "<string>",
    "advancedQuery": "<string>"
}
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>',
    targetListId: '<string>',
    targetSpaceId: '<string>',
    searchQuery: '<string>',
    targetTweetIds: ['<string>'],
    targetUsernames: ['<string>'],
    targetCommunityIds: ['<string>'],
    targetListIds: ['<string>'],
    searchQueries: ['<string>'],
    targets: [{}],
    relationTargets: [{}],
    queryType: '<string>',
    resultsLimit: 123,
    maxItemsPerTarget: 123,
    maxPagesPerTarget: 123,
    startCursor: '<string>',
    dedupeAcrossTargets: true,
    dedupeMode: '<string>',
    overlapMode: true,
    includeSearchTerms: true,
    includeTargetMetadata: true,
    collectionStrategy: '<string>',
    scope: '<string>',
    maxDepth: 123,
    sort: '<string>',
    excludeOriginalAuthor: true,
    includeOriginalPost: true,
    hasMediaOnly: true,
    sinceTime: {},
    untilTime: {},
    minViews: 123,
    minBookmarks: 123,
    maxLikes: 123,
    maxRetweets: 123,
    maxReplies: 123,
    maxQuotes: 123,
    blueVerifiedOnly: true,
    cardName: '<string>',
    source: '<string>',
    excludeSource: '<string>',
    geocode: '<string>',
    sinceId: '<string>',
    maxId: '<string>',
    near: '<string>',
    within: '<string>',
    withinTime: '<string>',
    nativeRetweets: true,
    safe: true,
    news: true,
    minFollowers: 123,
    maxFollowers: 123,
    minFollowing: 123,
    maxFollowing: 123,
    minPosts: 123,
    maxPosts: 123,
    minAccountAgeDays: 123,
    verifiedType: '<string>',
    hasWebsite: true,
    hasLocation: true,
    bioContains: '<string>',
    locationContains: '<string>',
    usernameContains: '<string>',
    fromUser: '<string>',
    toUser: '<string>',
    mentioning: '<string>',
    language: '<string>',
    sinceDate: '<string>',
    untilDate: '<string>',
    mediaType: '<string>',
    minFaves: 123,
    minRetweets: 123,
    minReplies: 123,
    minQuotes: 123,
    verifiedOnly: true,
    replies: '<string>',
    retweets: '<string>',
    quotes: '<string>',
    exactPhrase: '<string>',
    excludeWords: '<string>',
    anyWords: '<string>',
    hashtags: '<string>',
    cashtags: '<string>',
    url: '<string>',
    conversationId: '<string>',
    inReplyToTweetId: '<string>',
    quotesOfTweetId: '<string>',
    retweetsOfTweetId: '<string>',
    listId: '<string>',
    place: '<string>',
    placeCountry: '<string>',
    pointRadius: '<string>',
    boundingBox: '<string>',
    advancedQuery: '<string>'
  })
};

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  \"targetListId\": \"<string>\",\n  \"targetSpaceId\": \"<string>\",\n  \"searchQuery\": \"<string>\",\n  \"targetTweetIds\": [\n    \"<string>\"\n  ],\n  \"targetUsernames\": [\n    \"<string>\"\n  ],\n  \"targetCommunityIds\": [\n    \"<string>\"\n  ],\n  \"targetListIds\": [\n    \"<string>\"\n  ],\n  \"searchQueries\": [\n    \"<string>\"\n  ],\n  \"targets\": [\n    {}\n  ],\n  \"relationTargets\": [\n    {}\n  ],\n  \"queryType\": \"<string>\",\n  \"resultsLimit\": 123,\n  \"maxItemsPerTarget\": 123,\n  \"maxPagesPerTarget\": 123,\n  \"startCursor\": \"<string>\",\n  \"dedupeAcrossTargets\": true,\n  \"dedupeMode\": \"<string>\",\n  \"overlapMode\": true,\n  \"includeSearchTerms\": true,\n  \"includeTargetMetadata\": true,\n  \"collectionStrategy\": \"<string>\",\n  \"scope\": \"<string>\",\n  \"maxDepth\": 123,\n  \"sort\": \"<string>\",\n  \"excludeOriginalAuthor\": true,\n  \"includeOriginalPost\": true,\n  \"hasMediaOnly\": true,\n  \"sinceTime\": {},\n  \"untilTime\": {},\n  \"minViews\": 123,\n  \"minBookmarks\": 123,\n  \"maxLikes\": 123,\n  \"maxRetweets\": 123,\n  \"maxReplies\": 123,\n  \"maxQuotes\": 123,\n  \"blueVerifiedOnly\": true,\n  \"cardName\": \"<string>\",\n  \"source\": \"<string>\",\n  \"excludeSource\": \"<string>\",\n  \"geocode\": \"<string>\",\n  \"sinceId\": \"<string>\",\n  \"maxId\": \"<string>\",\n  \"near\": \"<string>\",\n  \"within\": \"<string>\",\n  \"withinTime\": \"<string>\",\n  \"nativeRetweets\": true,\n  \"safe\": true,\n  \"news\": true,\n  \"minFollowers\": 123,\n  \"maxFollowers\": 123,\n  \"minFollowing\": 123,\n  \"maxFollowing\": 123,\n  \"minPosts\": 123,\n  \"maxPosts\": 123,\n  \"minAccountAgeDays\": 123,\n  \"verifiedType\": \"<string>\",\n  \"hasWebsite\": true,\n  \"hasLocation\": true,\n  \"bioContains\": \"<string>\",\n  \"locationContains\": \"<string>\",\n  \"usernameContains\": \"<string>\",\n  \"fromUser\": \"<string>\",\n  \"toUser\": \"<string>\",\n  \"mentioning\": \"<string>\",\n  \"language\": \"<string>\",\n  \"sinceDate\": \"<string>\",\n  \"untilDate\": \"<string>\",\n  \"mediaType\": \"<string>\",\n  \"minFaves\": 123,\n  \"minRetweets\": 123,\n  \"minReplies\": 123,\n  \"minQuotes\": 123,\n  \"verifiedOnly\": true,\n  \"replies\": \"<string>\",\n  \"retweets\": \"<string>\",\n  \"quotes\": \"<string>\",\n  \"exactPhrase\": \"<string>\",\n  \"excludeWords\": \"<string>\",\n  \"anyWords\": \"<string>\",\n  \"hashtags\": \"<string>\",\n  \"cashtags\": \"<string>\",\n  \"url\": \"<string>\",\n  \"conversationId\": \"<string>\",\n  \"inReplyToTweetId\": \"<string>\",\n  \"quotesOfTweetId\": \"<string>\",\n  \"retweetsOfTweetId\": \"<string>\",\n  \"listId\": \"<string>\",\n  \"place\": \"<string>\",\n  \"placeCountry\": \"<string>\",\n  \"pointRadius\": \"<string>\",\n  \"boundingBox\": \"<string>\",\n  \"advancedQuery\": \"<string>\"\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))

}

{
  "allowed": true,
  "source": "<string>",
  "estimatedResults": 123,
  "creditsRequired": "<string>",
  "creditsAvailable": "<string>",
  "resolvedXUserId": "<string>"
}

​Estimate Twitter API Scraping Cost

​Match Each Scraping Task

​Control the Credit Quote

​Read the Estimate

​Headers

​Body

​Single Targets

​Collection Targets

​Collection Controls

​Reply Collection

​Tweet Result Filters

​Profile Result Filters

​Tweet Search Filters

​Response

​200 OK

​400 Invalid input

​400 Invalid tool type

​401 Unauthenticated

​402 Insufficient credits

​404 Not Found

​429 Rate Limited

​Decision Handoff

Allowed run

Blocked run

Source signal

Audit fields

Estimate Twitter API Scraping Cost

Match Each Scraping Task

Control the Credit Quote

Read the Estimate

Headers

Body

Single Targets

Collection Targets

Collection Controls

Reply Collection

Tweet Result Filters

Profile Result Filters

Tweet Search Filters

Response

200 OK

400 Invalid input

400 Invalid tool type

401 Unauthenticated

402 Insufficient credits

404 Not Found

429 Rate Limited

Decision Handoff