# New ads since a date

Ad creatives first seen on or after a date, newest first: a brand's new launches, several brands at once, or the whole library, with the same filters. Needs since. Served by Adspy.sh.

Ad creatives first seen on or after a date, newest first: a brand's new launches, several brands at once, or the whole library, with the same filters and records as adspy/search-creatives. Billed per new ad read. First seen is when the ad appeared in public libraries as Adspy.sh read them, not a launch confirmed by the brand. 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-new-creatives`
- Name in the catalog: Adspy.sh: New ads since a date
- Provider: [Adspy.sh](/providers/adspy.md)
- Capability: [Competitor ad search](/tools/ad-intelligence/creative-search.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-11-04.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "brandKey": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[^\\s\\x00-\\x1f]+$"
    },
    "brandKeys": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 256,
        "pattern": "^[^\\s\\x00-\\x1f]+$"
      }
    },
    "platform": {
      "type": "string",
      "enum": [
        "all",
        "meta",
        "google"
      ]
    },
    "format": {
      "type": "string",
      "enum": [
        "all",
        "image",
        "video",
        "carousel"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "all",
        "active",
        "inactive"
      ]
    },
    "tags": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 160
      }
    },
    "language": {
      "type": "string",
      "maxLength": 30
    },
    "minDaysActive": {
      "type": "integer",
      "minimum": 0,
      "maximum": 36500
    },
    "since": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T[0-9:.]+(Z|[+-]\\d{2}:\\d{2})?)?$",
      "description": "Ads first seen on or after this date, e.g. 2026-09-01."
    },
    "offset": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "since"
  ],
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "adspy/list-new-creatives",
  "input": {
    "since": "2026-10-01",
    "brandKey": "a4f8d93c-b738-4ca3-a6db-974c5a5dcc68",
    "limit": 3
  }
}
```

## 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-new-creatives) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

## Provider websites

- [Adspy.sh](https://www.adspy.sh/)

---

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