# Adspy.sh: Read a saved collection

A saved collection's creative IDs and notes. With expand, also each creative's full record, priced like adspy/get-creatives. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per creative, +3 for analysis, 60 per X-Ray, 400 per new brand fetch); creatives this workspace retrieved in the last 30 days, X-Rays from the last 24 hours, reused fetches and missing items cost nothing. Reserves up to $0.002 per result when expand is true (at most 50), the unused part refunded.

- Tool ID: `adspy/get-collection`
- Provider: [Adspy.sh](/providers/adspy.md)
- Category: [Advertising](/tools/advertising.md)
- Price: Usage based See tool details
- 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
    },
    {
      "when": {
        "field": "expand",
        "truthy": true
      },
      "addUsdPer": {
        "field": "limit",
        "usd": 0.002,
        "max": 50,
        "default": 20
      }
    }
  ]
}
```

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

Price verification date: 2026-10-05.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "collectionId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[^\\s\\x00-\\x1f]+$"
    },
    "offset": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "expand": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "collectionId"
  ],
  "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: Ad research by Adspy.sh (adspy.sh), from public ad libraries..

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

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

---

[HTML page](/tools/adspy/get-collection) · [Agent index](/llms.txt)