# Collect a brand’s organic social account

Collect the organic posts of one TikTok, YouTube or Instagram brand account from its profile link or @handle, linked to an Adspy.sh brand: pass the brandKey. Needs platform. Served by Adspy.sh.

Collect the organic posts of one TikTok, YouTube or Instagram brand account from its profile link or @handle, linked to an Adspy.sh brand: pass the brandKey of the brand the user named, the one given to adspy/search-social-accounts (an account linked to another brand is never moved). The first collection aims to cover the last 12 months. Instagram reads professional accounts only, and Meta paces Instagram reads: Adspy.sh can start about 10 new Instagram collections an hour across all users, so a new collection may wait its turn (state waiting, with retryAt). Returns a jobId at once: poll adspy/get-fetch-job until isTerminal, then read the posts with adspy/list-social-posts. An account Adspy.sh already collects, or one being collected, costs nothing. A new collection includes its posts: for 30 days the workspace that paid reads them with adspy/list-social-posts and adspy/get-social-posts at no charge, AI tags included. Take the link from adspy/search-social-accounts or from the user. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.8; reserved before the call, the unused part refunded.

- Tool ID: `adspy/request-social-fetch`
- Name in the catalog: Adspy.sh: Collect a TikTok, YouTube or Instagram account's posts
- Provider: [Adspy.sh](/providers/adspy.md)
- Capability: [Brand social accounts](/tools/social-media/brand-accounts.md)
- Price: usage based, the maximum is shown before a run
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

Billed at the cost the provider reports for the call, never above $0.8. Your agent sees the maximum before running.


```json
{
  "model": "reported",
  "costPath": "",
  "costTerms": [
    {
      "path": "billing.credits",
      "usd": 0.002
    }
  ],
  "requireCost": true,
  "maxUsdDefault": 0.8,
  "maxUsdCap": 0.8,
  "headroom": 1
}
```

Pricing source: [https://www.adspy.sh/agentik/catalog.json](https://www.adspy.sh/agentik/catalog.json). Adspy publishes the Agentik price grid 2026-10-23-v3 with its partner catalog; Adspy charges Agentik nothing..

Price verification date: 2026-10-23.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "enum": [
        "tiktok",
        "youtube",
        "instagram"
      ],
      "description": "tiktok, youtube or instagram."
    },
    "url": {
      "description": "Profile link, e.g. https://www.tiktok.com/@handle or https://www.instagram.com/handle. Give url or handle.",
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "handle": {
      "description": "The @handle, when no link is given. On Instagram, the exact username.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "brandKey": {
      "description": "The brandKey of the brand the user named (from search_brands, the one given to search_social_accounts): always pass it when the user named a brand. The account is linked to it on proof, else the brand's own site is checked for a link to the account. An account already linked to another brand is never moved.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[^\\s\\x00-\\x1f]+$"
    }
  },
  "required": [
    "platform"
  ],
  "additionalProperties": false
}
```

## Published example

No example input is published for this tool. Ask for the inputs required by its schema.

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

Attribution: Research by Adspy.sh (adspy.sh), from public ads and brand social posts..

[Provider documentation](https://www.adspy.sh)

[REST inspection](https://api.agentik.cc/v1/tools/adspy/request-social-fetch) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/adspy/request-social-fetch) · [Agent index](/llms.txt)