> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# How can I build a source-backed ad creative reference sheet?

> Search TikTok ad creatives with tiktok.ads.search_ads, fetch shortlisted details with tiktok.ads.get_ads_detail, and combine Meta, LinkedIn, or Google ad library records with explicit source scope.

To build a source-backed ad creative reference sheet, search TikTok ad creatives with `tiktok.ads.search_ads`, fetch details for shortlisted ads with `tiktok.ads.get_ads_detail`, and add any Meta, LinkedIn or Google ad library records you already have, each with the record's own source scope. Fix the market, the observation dates and the brands first. In the finished sheet, every creative observation cites the ad behind the observation, so colleagues can revisit each example.

The running-shoe ad review below compares how brands explain cushioning, weight, and daily commuting.

## Start with a small TikTok creative sample

Use `tiktok.ads.search_ads` for creative discovery. The example request below asks for one page of running-shoe results for the US in a 30-day window. Send the request to `POST https://api.beatapi.io/v1/social-data/call` with BeatAPI Bearer authentication.

```json
{
  "action": "tiktok.ads.search_ads",
  "params": {"keyword":"running shoes","country_code":"US","period":30,"page":1,"limit":20,"order_by":"for_you"}
}
```

1. Keep the original filters, and record each page you actually requested and the returned search state.
2. If the response explicitly returns a search identifier for continuation, pass the returned identifier in `search_id`.
3. Record the actual result count of each page. Stop at duplicates, at an empty page or at the planned page limit, and record the reason.

Creative samples help you study messaging. To answer where a specific advertiser ran an ad, use actual ad transparency records instead.

For a selected ad that needs more detail, pass the confirmed ad ID as `ads_id` to `tiktok.ads.get_ads_detail`. Record the details, assets and destinations that the actual response contains. Plan the number of search pages and selected details with [pricing](https://beatapi.io/pricing).

### How do I track a batch of keyword searches?

For example, start with “running shoes,” “cushioned running shoes” and “commuter running shoes.” Two pages for each term take six search requests. Save the keyword, market, time window, page and request ID with each page of results. In your shortlist, deduplicate by verified ad ID and keep every matching keyword attached to the ad. If two searches find the same ad, cite the creative once and keep both search records. Send detail requests only for material you shortlist.

## Compare saved material from other ad libraries by source

The public BeatAPI catalog has no Meta, LinkedIn or Google ad transparency action. If you already have records or exports from those ad libraries, add the records to the same research sheet together with each record's actual source scope.

| Source material                 | Check first                                                | Recommended use                                                                         |
| ------------------------------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| Meta Ad Library records         | Advertiser’s page, reported market and status              | Disambiguate names and compare messages and assets from the selected page               |
| LinkedIn Ad Library records     | Actual advertiser, company or sub-brand, reported location | Compare headlines and calls to action, preserving displayed impression ranges           |
| Google Ads Transparency records | Advertiser identity, reported location and creative format | Select confirmed creatives for the market, then inspect available copy and destinations |

Copy each source's original regions, dates, impression ranges and states. Leave fields that the source does not show blank. If the advertiser identity is unclear, compare the brand profile with the library record before combining the results.

## Turn the sample into a creative brief

Include the following columns in each row of the sheet: platform, advertiser, ad ID or link, query scope, source wording or visual location, selling point, call to action and your interpretation. Describe only the material you actually inspected; for an image-only candidate, write what the image shows. Variants with similar messaging can support one creative theme while each variant keeps a separate source record.

For example, if three ads show a commute in the opening five seconds, propose “open with a use case” as a creative direction and cite the three ads. If the material shows impression ranges and no conversions, keep the analysis on how the ads communicate.

Suppose TikTok sample A opens on a rainy commute, Meta record B uses commuting in the headline, and LinkedIn record C shows people standing through a long shift. Group A and B as commute examples, and keep C for a different use case. Keep each original record and the record's market. A production brief could say “Open with a rainy commute and test whether viewers grasp the use case sooner,” and cite the scene in A and the headline in B.