# Adspy.sh organic brand posts

Organic posts of a brand's TikTok, YouTube and Instagram accounts that Adspy.sh collects (posts, not ads): thumbnail, permalink, date, format, caption, views. Takes brand key, account id, platform and more, all optional.

Organic posts of a brand's TikTok, YouTube and Instagram accounts that Adspy.sh collects (posts, not ads): thumbnail, permalink, date, format, caption, views, likes, comments, shares, saves (null = not public on that platform), engagement per view (per follower on Instagram, never ranked together), and whether the post later ran as an ad, with its counts before that ad. Sort by recent, engagement or breakouts; breakouts lists the posts far above the account's usual views and keeps paid-reach posts (views far above usual with engagement per view far below) apart. Brands with collected accounts carry social.platforms in adspy/search-brands. A post already read by this workspace in the last 30 days, or a post of an account it paid to collect in the last 30 days, costs nothing. 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. Reserves up to $0.002 per result (at most 50), the unused part refunded.

- Tool ID: `adspy/list-social-posts`
- Name in the catalog: Adspy.sh: A brand's organic TikTok, YouTube and Instagram posts
- Provider: [Adspy.sh](/providers/adspy.md)
- Capability: [Brand organic posts](/tools/social-media/brand-posts.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.1. Your agent sees the maximum before running.


```json
{
  "model": "reported",
  "costPath": "",
  "costTerms": [
    {
      "path": "billing.credits",
      "usd": 0.002
    }
  ],
  "requireCost": true,
  "maxUsdDefault": 0.04,
  "maxUsdCap": 0.1,
  "multipliers": [
    {
      "setUsd": 0
    },
    {
      "addUsdPer": {
        "field": "limit",
        "usd": 0.002,
        "max": 50,
        "default": 20
      }
    }
  ],
  "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": {
    "brandKey": {
      "description": "The brand (search_brands); give brandKey or accountId.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[^\\s\\x00-\\x1f]+$"
    },
    "accountId": {
      "description": "One account, e.g. social:tiktok:6643891469239320582.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[^\\s\\x00-\\x1f]+$"
    },
    "platform": {
      "type": "string",
      "enum": [
        "tiktok",
        "youtube",
        "instagram"
      ],
      "description": "tiktok, youtube or instagram."
    },
    "format": {
      "description": "TikTok and YouTube: video, short, live, carousel (TikTok photo post). Instagram: reel, image, carousel, video.",
      "type": "string",
      "enum": [
        "video",
        "short",
        "live",
        "carousel",
        "image",
        "reel"
      ]
    },
    "since": {
      "description": "Posts published on or after this date, e.g. 2026-09-01.",
      "type": "string",
      "maxLength": 40
    },
    "sort": {
      "default": "recent",
      "description": "recent: newest first. engagement: highest engagement first, per view on TikTok and YouTube, per follower on Instagram (give platform when the brand has Instagram and another platform: the two are never ranked together). breakouts: the posts far above the account's usual views (90-day statistics), with paid-reach posts listed apart.",
      "type": "string",
      "enum": [
        "recent",
        "engagement",
        "breakouts"
      ]
    },
    "offset": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "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/list-social-posts) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

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