# Adspy.sh organic post details and AI tags

Organic TikTok, YouTube and Instagram posts by id: counts, 1-day and 7-day snapshots, the brand's ads matched to the post. Needs ids.

Organic TikTok, YouTube and Instagram posts by id: counts, 1-day and 7-day snapshots, the brand's ads matched to the post (Adspy.sh creative IDs for adspy/get-creatives, with lag and match type), how far a breakout or a paid-reach post sits from the account's usual, and with includeAnalysis the post's AI tags (no extra charge). Unknown ids come back under missing and cost 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 item (at most 20), the unused part refunded.

- Tool ID: `adspy/get-social-posts`
- Name in the catalog: Adspy.sh: Organic social posts in detail
- 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.04. Your agent sees the maximum before running.


```json
{
  "model": "reported",
  "costPath": "",
  "costTerms": [
    {
      "path": "billing.credits",
      "usd": 0.002
    }
  ],
  "requireCost": true,
  "maxUsdDefault": 0.002,
  "maxUsdCap": 0.04,
  "multipliers": [
    {
      "setUsd": 0
    },
    {
      "addUsdPer": {
        "field": "ids",
        "usd": 0.002,
        "max": 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": {
    "ids": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^(tiktok|youtube|instagram):[A-Za-z0-9_-]{1,64}$",
        "description": "A post id from list_social_posts, e.g. tiktok:7675005480867073311."
      }
    },
    "includeAnalysis": {
      "default": false,
      "description": "Add the post's AI tags (included).",
      "type": "boolean"
    }
  },
  "required": [
    "ids"
  ],
  "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/get-social-posts) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

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