Skip to content
looot docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

Scrape Creators API / Find Social Profiles

ScrapeCreators tool scrapecreators-find-social-profiles on looot: input fields, $0.00188 per call, output shape, and code to run it with curl, JavaScript or Python.

Accepts a supported platform and creator handle, validates both using platform-specific rules, and constructs the canonical source profile URL internally. URLs are not accepted as handles. Supported platforms are Instagram, TikTok, YouTube, X/Twitter, and Facebook; X is accepted as an alias for Twitter. YouTube accepts handles and 24-character channel IDs. The endpoint returns social profiles explicitly linked from the source profile and expands recognized link-in-bio pages. It also re-scrapes up to three supported profiles explicitly linked by the source and follows up to three unique public website URLs declared by the source or those trusted profiles for one page, while preserving each declared path and query. Generic service-provider landing pages reached through parked or unconfigured branded-domain redirects are ignored so the provider’s own footer links are not attributed to the creator. It also checks whether the same handle exists on the other supported platforms. All attempted same-handle URLs are returned in same_handle_candidate_urls even when they cannot be verified strongly enough for profiles. Same-handle accounts are included in profiles only when corroborated by a shared owner-controlled website or a reciprocal profile link; matching handles and display names alone are not identity proof. same_handle_match records supporting name evidence at 0.75 confidence, while shared_website and website_link use 0.9. A bounded Google search discovers alternate handles, but Google results are never returned without verification. At most two candidates per other supported platform, up to four total, are re-scraped through that platform’s profile scraper. The endpoint may also follow up to two unique recognized link-in-bio URLs declared by the re-scraped Google candidates. The global two-page cap is applied after candidates whose returned handles do not match their Google URLs are rejected. Optional profile probes and page fetches make one attempt and receive the s

  • Tool id: scrapecreators-find-social-profiles
  • Provider: ScrapeCreators
  • Job: Get findsocialprofiles (findsocialprofiles.get)
  • Price: $0.00188 per call. A call that fails at the provider costs $0.

Inputs

Name Type Required Description
cache_max_age string no
handle string yes
platform string yes

Output

Shape of the run’s result, the expected shape, not yet checked against real answers:

{ source: { url, handle, platform }, partial, success, profiles: { url, handle, evidence: string[], platform, confidence }[], credits_charged, link_in_bio_urls: unknown[], credits_remaining, google_se... ...

The shape is cut here. Signed in, looot inspect scrapecreators-find-social-profiles prints all of it.

Run it

Every call needs your API token in LOOOT_TOKEN; Sign in shows how to get one. Each run also needs a new idempotency key, so a retry never pays twice. With wait: 30 the answer comes back inline when the run ends within 30 seconds. Otherwise you get the running run back: poll GET /v1/runs/<runId>.

Example input with placeholder values:

curl -X POST "https://api.looot.ai/v1/runs" \
  -H "Authorization: Bearer $LOOOT_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"endpointId":"scrapecreators-find-social-profiles","input":{"platform":"<platform>","handle":"<handle>"},"wait":30}'
const response = await fetch("https://api.looot.ai/v1/runs", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LOOOT_TOKEN}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    endpointId: "scrapecreators-find-social-profiles",
    input: {
      platform: "<platform>",
      handle: "<handle>",
    },
    wait: 30,
  }),
});
const run = await response.json();
console.log(run.status, run.result);
import os
import uuid

import requests

response = requests.post(
    "https://api.looot.ai/v1/runs",
    headers={
        "Authorization": f"Bearer {os.environ['LOOOT_TOKEN']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "endpointId": "scrapecreators-find-social-profiles",
        "input": {
            "platform": "<platform>",
            "handle": "<handle>",
        },
        "wait": 30,
    },
    timeout=90,
)
run = response.json()
print(run["status"], run.get("result"))

To let looot pick among every provider of this job instead, send job:findsocialprofiles.get as endpointId; see the job page.

Was this page helpful?