Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Scrape Creators

Scalekit connector
Open markdown

The Scrape Creators connector lets your AI agent act in each user's Scrape Creators account. Each user connects their own Scrape Creators API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

Tools
60
What they doRead · write · destructive
60 · 0 · 060 read0 write0 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Scrape Creators connection

    In AgentKit > Connections, create a Scrape Creators connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'scrapecreators'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Scrape Creators:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'scrapecreators_credit_balance_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Scrape Creators credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • scrapecreators_bluesky_profile_getRetrieves a Bluesky user's public profile including handle, displayName, avatar, description, followersCount, followsCount, postsCount, createdAt, and verification status.Read-only

    Get Bluesky Profile

    Retrieves a Bluesky user's public profile including handle, displayName, avatar, description, followersCount, followsCount, postsCount, createdAt, and verification status. Use this for a Bluesky account's details.

    Inputs

    handlestringrequired
    Bluesky handle. Example: espn.com.
  • scrapecreators_credit_balance_getGet the number of API credits remaining on your Scrape Creators account.Read-only

    Get Credit Balance

    Get the number of API credits remaining on your Scrape Creators account. Returns a creditCount field with the current balance. Use this to check how many API credits remain before running large jobs.

    Inputs

    This tool takes no inputs.

  • scrapecreators_facebook_ad_library_company_ads_listFetches all ads currently running for a specific company from the Meta Ad Library.Read-only

    List Meta Ad Library Company Ads

    Fetches all ads currently running for a specific company from the Meta Ad Library. Each ad includes ad_archive_id, page_name, is_active, publisher_platform, and a snapshot with body, images, videos, and display_format. Use this for one advertiser's ads. Use scrapecreators_facebook_ad_library_companies_search to find the page ID first.

    Inputs

    company_namestring
    The name of the company. Can either use this or pageId. Example: Lululemon.
    countrystring
    This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL. Example: ALL.
    cursorstring
    Cursor to paginate through results. Example: AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP.
    end_datestring
    End date to search for. Format: YYYY-MM-DD. Example: 2025-12-31.
    languagestring
    Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc. Example: EN.
    media_typestring
    Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme. Example: ALL.one of ALLIMAGEVIDEOMEMEIMAGE_AND_MEMENONE
    page_idstring
    The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName. Example: 367152833370567.
    sort_bystring
    Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions. Example: total_impressions.one of total_impressionsrelevancy_monthly_grouped
    start_datestring
    Start date to search for. Format: YYYY-MM-DD. Example: 2025-01-01.
    statusstring
    Status of the ad. Defaults to ACTIVE. Example: ACTIVE.one of ALLACTIVEINACTIVE
    trimboolean
    Set to true for a trimmed down version of the response. Example: false.
  • scrapecreators_facebook_group_posts_listFetches posts from a public Facebook group, limited to 3 posts per page due to API limitations.Read-only

    List Facebook Group Posts

    Fetches posts from a public Facebook group, limited to 3 posts per page due to API limitations. Each post includes id, text, url, reactionCount, commentCount, publishTime, videoDetails, and topComments. Use this for posts in a public group.

    Inputs

    cursorstring
    The cursor to paginate to the next page. Example: AQHRBjJCelNvdGRjH8s2j-6...
    group_idstring
    The ID of the group. Example: 742354120555345.
    sort_bystring
    How to sort the posts. Defaults to CHRONOLOGICAL. Example: CHRONOLOGICAL.one of TOP_POSTSRECENT_ACTIVITYCHRONOLOGICALCHRONOLOGICAL_LISTINGS
    urlstring
    The URL of the group. Example: https://www.facebook.com/groups/1270525996445602/.
  • scrapecreators_facebook_post_comments_listFetches comments from a Facebook post or reel with cursor-based pagination.Read-only

    List Facebook Post Comments

    Fetches comments from a Facebook post or reel with cursor-based pagination. Each comment includes id, text, created_at, reply_count, reaction_count, and author details with name and profile_picture. Use this for comments on a post or reel.

    Inputs

    cursorstring
    Cursor from the previous response to get more comments. Keep the same sort on every cursor page. Example: MToxNzU3MTA2NzYyOgF1P1VkxpkA9Ds4...
    feedback_idstring
    Using feedback_id (instead of url) will *really* speed up the request. You can get the feedback_id when you make a request to /v1/facebook/post. Example: ZmVlZGJhY2s6MTQ0NzY1NjMyMzM4Mzg0OA==.
    sortstring
    Defaults to most_relevant, which can filter comments. Set sort=all to request Facebook's unfiltered view; this does not guarantee every counted comment is available. Example: most_relevant.one of most_relevantall
    urlstring
    Facebook post URL (or reel URL). Example: https://www.facebook.com/reel/753347914167361.
  • scrapecreators_facebook_post_getRetrieves a single public Facebook post or reel by URL.Read-only

    Get Facebook Post

    Retrieves a single public Facebook post or reel by URL. Returns post_id, like_count, comment_count, share_count, view_count, description, creation_time, and author details, including the author handle when Facebook exposes a vanity profile URL. Use this for one post or reel by URL. Use scrapecreators_facebook_post_comments_list for its comments.

    Inputs

    urlstringrequired
    The URL of the post to get. Example: https://www.facebook.com/reel/1535656380759655.
    allow_long_transcriptionboolean
    Paid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Example: true.
    cache_max_agestring
    If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit; default short AI is included; allow_long_transcription=true adds 10 credits per started minute to the existing base cost). See the Caching page for details. (https://docs.scrapecreators.com/caching). Example: 7d.one of 1d3d7d14d30d
    get_transcriptboolean
    Transcription is opt-in via get_transcript=true. Default short AI (up to 120 seconds, inclusive) is included in the existing base endpoint price, with no extra AI fee. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. On detail routes, successful paid-mode AI costs are in addition to the existing base endpoint cost; media-download pricing is unchanged. Returned native captions leave the base endpoint price unchanged. Empty AI results and errors incur no AI fee; the base scrape fee still applies when the detail scrape succeeds. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Example: true.