---
title: "Bulk upsert hunted creatives (Chrome extension endpoint)"
method: POST
path: "/api/v1/hunted_creatives"
tags: ["Hunted Creatives"]
---

# Bulk upsert hunted creatives (Chrome extension endpoint)

`POST /api/v1/hunted_creatives`

## Request

- Base URL: `https://getscaleforge.com`
- URL: `https://getscaleforge.com/api/v1/hunted_creatives`
- Auth: HTTP bearer

Accepts a list of creatives scraped from Meta Ad Library. Records are
matched/upserted by `library_id`. Requires scope `hunted_creatives:write`.

## Request body

- object
  - `creatives` object[], required
    - `library_id` string, required
    - `page_title` string
    - `page_avatar` string, uri
    - `ad_text` string
    - `call_to_action` string
    - `link_url` string, uri
    - `link_headline` string
    - `link_description` string
    - `start_date` string, date
    - `days_running` integer
    - `platforms` string[]
    - `image_url` string, uri
    - `video_url` string, uri
    - `video_poster_url` string, uri

## Response `201`

Upserted

- object
  - `created` integer
  - `updated` integer
  - `total` integer

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/getscaleforge/apis/scaleforge-api.md) · [All operations](https://skmtc.dev/getscaleforge/apis/scaleforge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getscaleforge/apis/scaleforge-api/revisions/ca382e62f404?raw)