ScrapeCreators: Find Social Profiles

Accepts a supported platform and creator handle, validates both using platform-specific rules, and constructs the canonical source profile URL internally.

Tool ID: scrapecreators_find_social_profiles

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'scrapecreators_find_social_profiles',
  {
    "platform": "instagram",
    "handle": "example"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute scrapecreators_find_social_profiles --input '{
  "platform": "instagram",
  "handle": "example"
}' --json

Example response

The static output schema lacks the details for a reliable example. Use deepline describe scrapecreators_find_social_profiles --json for the complete live contract.

Input reference

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 See the live schema below for the complete notes.

Name	Type	Required	Default	Details
`payload.platform`	`"instagram" \| "tiktok" \| "youtube" \| "x" \| "twitter" \| "facebook"`	Yes	—	Source social platform Allowed: `instagram`, `tiktok`, `youtube`, `x`, `twitter`, `facebook`.
`payload.handle`	`string`	Yes	—	Creator handle without a profile URL. A leading @ is optional.
`payload.cache_max_age`	`"1d" \| "3d" \| "7d" \| "14d" \| "30d"`	No	—	If we have a response in the cache that is this many days old or newer, return the cached response. Otherwise, scrape a live result. See the Caching page for details. Allowed: `1d`, `3d`, `7d`, `14d`, `30d`.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`unknown`	Yes	—	Provider response payload.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: provider_usage (provider usage).
Estimated Deepline credits: 0.02 per pricing unit.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation