↑ ↓ to move ↵ to open
Linktree API reference

Linktree Harvest Directory Profiles

linktree.directory.profiles

Collect profiles from several pages of the directory in one call, filtered by category.

At a glance

Endpoint ID
linktree.directory.profiles
Price
1–10 credits per call; failed calls are free
Runs for up to
120 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
linktree__directory__profiles
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "linktree.directory.profiles",  "input": {    "category": "business",    "max_pages": 2  }}'

Input

FieldTypeRequiredWhat it doesExample
category string no A directory category, such as business, tech or food-beverage. Use this or subcategory, not both. business
max_pages integer no How many directory pages to read, about 18 profiles each: 10 by default, up to 25. 2
subcategory string no A narrower directory category, such as coffee-tea, saas or real-estate. Use this or category, not both. affiliate-marketing · agency-consulting · alcoh…

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

No sample response is published for this endpoint yet.

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other Linktree endpoints

Something missing or unclear? Ask the team that builds the Linktree endpoints.