> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://gethookdai.crisp.help/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 💡 Swipe File Your **Swipe File** is your personal collection of ads you’ve saved for inspiration, analysis, or reference. Every ad you bookmark from the Explore page or save via the Chrome Extension ends up here. Think of it as your ad library — organized, searchable, and always ready when you need ideas. > **Heads up:** there's also a **Swipe Files** section (plural) further down the Discover menu. That one holds public boards curated by the GetHookd team — it was called Expert Picks until recently. This article is about **your** Swipe File, which stays private to you. --- ## Before You Start - **Credits:** Saving ads to your Swipe File is completely free. - **How to get there:** Click **Swipe File** in the left sidebar. - **Limits:** None. Save as many ads as you like, on any plan. --- ## How to Save Ads There are three ways to save an ad to your Swipe File: 1. **From the Explore page** — Click the **bookmark icon** on any ad card. The icon fills in to confirm it’s saved. 2. **From the Chrome Extension** — Click **Save to Gethookd** on any ad in the Meta Ad Library or TikTok. The ad appears in your Swipe File automatically. 3. **From the ad detail view** — Open any ad and click the **Save** button. To unsave an ad, click the filled bookmark icon again. --- ## What You’ll See The Swipe File has two tabs: ### My Ads This is your main view. All your saved ads appear as a grid of ad cards showing: - Brand logo and name - Ad preview (image, video, or carousel) - Format label (Video, Image, Carousel) - Performance Score (star rating) - Bookmark icon (filled, since it’s saved) The total number of saved ads shows at the top. Scroll down and more ads load automatically. ### Brands Switch to the **Brands** tab to see a list of brands you’ve saved ads from. Click any brand to open their full Brand Page. --- ## Ad Detail View Click any ad card to open the full detail view. Here you’ll see: - **Full creative** — image, video, or carousel with prev/next navigation if there are multiple media items - **Ad copy** — the full text of the ad (expandable) - **Brand info** — name, logo, and link to the Brand Page - **Platform and format** — where the ad runs and what type it is - **Days active** — how long the ad has been running - **CTA type** — the call-to-action button used - **Landing page** — link to where the ad sends traffic - **Performance Score** — star rating with tier label **Actions you can take from the detail view:** - **Save / Unsave** the ad - **Download** the media (image or video) - **View the brand** — open the full Brand Page - **Share the ad** — copy a shareable link - **Spy on the brand** — start tracking it with Brand Spy - **Clone the ad** — use it as inspiration in Clone Ads to generate your own version - **Generate a script** — create an AI video script based on the ad - **Assign to a board** — organize it into one or more boards --- ## Boards Boards let you organize your saved ads into collections. Think of them as folders for different projects, campaigns, or themes. ### Create a Board Click the **Create new** button and select **Board**. Give it a name (e.g., “Summer Campaign Ideas” or “Competitor Ads”) and choose which folder to put it in. ### Assign Ads to Boards From the ad detail view, use the **board selector** to assign the ad to one or more boards. An ad can live in multiple boards at the same time. You can also assign a board when saving from the Chrome Extension by using the **Select Board** dropdown. ### Set a Default Board In the Chrome Extension popup, choose a **Default Board**. Every ad you save from the extension will automatically go to that board without having to select it each time. ### View a Board Click on any board in the sidebar to see just the ads in that collection. You can search, filter, and sort within a board the same way you do in the main Swipe File. ### Rename or Delete a Board You can rename any board or delete it. Deleting a board does **not** delete the ads inside — they stay in your Swipe File. --- ## Migrating Folders & Boards From Another Platform Switching from **Foreplay**, **Atria**, or another ad intelligence tool? You don’t have to start from scratch — we can bring your existing folders and boards over to Gethookd. **How it works:** 1. **Message us in the live chat** (the chat bubble in the bottom-right of the app) and let us know which platform you’re migrating from. 2. We’ll follow up with the details we need from you — usually an export from your current tool, or access to the boards/folders you want to bring over. 3. Our team handles the import for you. Your folder structure and saved ads land in your Gethookd Swipe File, ready to use. This is a free service — just reach out and we’ll take it from there. 🙂 --- ## Search Use the search bar at the top to find specific ads in your Swipe File. Type a brand name, keyword, or phrase and results update in real time. Your search term and filters are saved in the URL, so you can bookmark a filtered view of your Swipe File and come back to it later. || 💡 **Note:** **Favourite Searches** — the star that saves a filter combination — is an **Explore** feature, so it isn't available here. In the Swipe File, bookmarking the page is the way to keep a filtered view. --- ## Filters The left-side filter panel works the same way as on the Explore page. You can filter your saved ads by: - Ad Format (image, video, carousel) - Status (active or inactive) - Run Time (minimum days running) - Start Date (date range) - Niche (industry category) - Language - Channels (Facebook, Instagram, TikTok, etc.) - Performance Score (star rating) - Creative Usage - Brand Active Ads - Video Length - EU Transparency (gender, age, reach) - CTA Type (Shop Now, Learn More, Sign Up, Download, etc.) All filters combine together — stack as many as you need. ➡️ [Learn more about Mastering Filters →](https://gethookdai.crisp.help/en/article/mastering-filters-1xhf011/) --- ## Sort Options Use the sort dropdown to reorder your saved ads: - **Latest added** — most recently saved (default) - **Oldest added** — earliest saves first - **Newest** — by ad start date, newest first - **Oldest** — by ad start date, oldest first - **Longest running** — ads that have been live the longest - **Most used** — ads whose creative appears in the most campaigns --- ## Remove Ads **Remove from Swipe File:** Click the filled bookmark icon on any ad card (in the Swipe File or on the Explore page) to unsave it. The ad is removed from your Swipe File. **Remove from a Board:** Open the board, find the ad, and remove it from that board. The ad stays in your Swipe File and any other boards it’s assigned to. --- ## Share a Board Each board has a **shareable link**. Share it with teammates or collaborators so they can see the ads you’ve curated — great for creative brainstorming or campaign planning. --- ## Advanced: Manage Your Swipe File via API or MCP On the Team and Agency plans you can also drive your Swipe File programmatically — useful for AI agents, automations, or custom dashboards. * **REST API:** `GET /api/v1/swipefile` returns your saved ads with all the same filters as the in-app sidebar (creative categories, tags, languages, platforms, performance scores, video lengths, display formats). `POST` saves an ad, `DELETE` removes one. Protected by the `swipe-file:read` and `swipe-file:write` token scopes. See the [Public API article](https://gethookdai.crisp.help/en/article/public-api-6ihtg/). * **MCP (Claude and other AI agents):** three tools — `list_swipe_file` (accepts the REST-style `per_page` parameter), `save_ad_to_swipe_file`, and `remove_ad_from_swipe_file`. See the [MCP article](https://gethookdai.crisp.help/en/article/mcp-1nys0t1/) to connect. --- ## FAQs **Does saving ads cost credits?** No. Saving ads to your Swipe File is completely free on all plans. **Is there a limit to how many ads I can save?** No. There’s no monthly cap and no total cap — save as many ads as you want, on every plan. **Can I save an ad to multiple boards?** Yes! An ad can be assigned to as many boards as you want. **What happens if I delete a board?** The board is removed, but all the ads inside it stay in your Swipe File. Nothing is lost. **Can I save ads from TikTok?** Yes. Use the Chrome Extension on TikTok Ad Library, TikTok Creative Center, TikTok Spotlight, or organic TikTok videos. **Where do Chrome Extension saves go?** They go to your Swipe File. If you’ve set a default board in the extension, they also go to that board. **Can I migrate my folders and boards from Foreplay, Atria, or another tool?** Yes — just message us in the live chat and let us know which platform you’re coming from. We’ll follow up with the details we need and handle the import for you. It’s free. --- ## Related Articles - [Explore Page](https://gethookdai.crisp.help/en/article/explore-page-your-mission-control-for-ad-discovery-wyzh03/) — Discover and save ads - [Chrome Extension](https://gethookdai.crisp.help/en/article/chrome-extension-urmo03/) — Save ads from Meta Ad Library and TikTok - [Mastering Filters](https://gethookdai.crisp.help/en/article/mastering-filters-1xhf011/) — Filter your saved ads - [Brand Spy](https://gethookdai.crisp.help/en/article/brand-spy-1hgxsty/) — Track brands from your saved ads - [Clone Ads](https://gethookdai.crisp.help/en/article/clone-ads-instantly-generate-high-converting-ad-creatives-1v9fdkp/) — Use saved ads as inspiration to generate new creatives