# Adspy research playbooks by job

Ready research jobs on ads and organic posts, grouped by goal: read a competitor's ad strategy, find the hooks that keep running, build a swipe file, write. Takes group and brand, all optional. Served by Adspy.sh.

Ready research jobs on ads and organic posts, grouped by goal: read a competitor's ad strategy, find the hooks that keep running, build a swipe file, write a brief from real ads, watch a competitor, compare brands, spot posts run as ads, scan a category. Each one gives its outcome, its steps in plain words and a ready prompt; pass brand to fill the prompts. Reads no ad data and bills nothing. Prices are not listed here: each step is billed at its tool's own price. Agentik price: free.

- Tool ID: `adspy/list-playbooks`
- Name in the catalog: Adspy.sh: Adspy research playbooks by job
- Provider: [Adspy.sh](/providers/adspy.md)
- Capability: [Competitor ad search](/tools/ad-intelligence/creative-search.md)
- Price: no charge per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

No charge per call. A workspace is still needed so your agent can call it.


```json
{
  "model": "per_call",
  "amountUsd": 0
}
```

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "group": {
      "description": "Only this job's playbooks.",
      "type": "string",
      "enum": [
        "competitor",
        "ideas",
        "social",
        "market"
      ]
    },
    "brand": {
      "description": "A brand the user named: fills the prompts, e.g. AG1.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "pattern": "^[^\\n\\r{}[\\]<>]+$"
    }
  },
  "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-playbooks",
  "input": {}
}
```

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

## Provider websites

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

---

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