# Adspy.sh: Add a brand to the ad library

Add a brand from its Meta Ad Library page URL (view_all_page_id) or Google Ads Transparency advertiser URL (AR…): Adspy.sh collects its ads, then analyses, tags and transcribes them. Returns a jobId at once: poll adspy/get-fetch-job until isTerminal, then read the ads with adspy/search-creatives and the returned brandKey. A brand already in the library or already being fetched costs nothing. Take the URL and name from adspy/search-advertisers. 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. At most $0.8; reserved before the call, the unused part refunded.

- Tool ID: `adspy/request-brand-fetch`
- 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.8. Your agent sees the maximum before running.


```json
{
  "model": "reported",
  "costPath": "",
  "costTerms": [
    {
      "path": "billing.credits",
      "usd": 0.002
    }
  ],
  "requireCost": true,
  "maxUsdDefault": 0.8,
  "maxUsdCap": 0.8
}
```

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": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    },
    "resultCap": {
      "default": 20,
      "description": "Suggested page size for later creative retrieval, not an ingestion limit. Fetching costs a flat 400 credits.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "url",
    "name"
  ],
  "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/request-brand-fetch",
  "input": {
    "url": "https://www.facebook.com/ads/library/?view_all_page_id=183869772601",
    "name": "AG1 by Athletic Greens"
  }
}
```

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

---

[HTML page](/tools/adspy/request-brand-fetch) · [Agent index](/llms.txt)