ParseForge Scrapers

Heads Up For Tails Catalog Scraper

parseforge/heads-up-for-tails-scraper

E-commerceAutomationDeveloper tools

Scrapes pet product listings from Heads Up For Tails by collection handle. Returns each product as a flat row with title, price, and availability.

Run this scraper See the API call
Total users
2
Monthly active
0
Total runs
199
Bookmarked
1
Rating
Not rated yet
Last modified
12 days ago

Overview

ParseForge

Heads Up For Tails Catalog Scraper

Scrape Heads Up For Tails pet products from any collection, up to a million per run. Each product comes with its title, price, and availability. No login or API key. Export to CSV, JSON, Excel, or XML.

Heads Up For Tails is India's largest online pet store, but its catalog is spread across dozens of Shopify collections. This Actor reads the public collection feeds directly, so you can pull dog food, cat litter, toys, or every product in one run without building a Shopify app or dealing with rate limits.

Who uses it What they scrape Heads Up For Tails for
Pet industry analysts Track which brands and product types Heads Up For Tails is stocking this month
E-commerce managers Monitor competitor pricing and assortment on Heads Up For Tails
Dropshippers Build a product feed of pet supplies to list on their own store
SEO agencies Audit product titles and descriptions for keyword coverage

What it does

This Actor collects pet product listings from Heads Up For Tails by collection handle, and returns each product as a flat row.

  • ๐Ÿ›๏ธ Collection scraping: pass a handle like 'dog-food' or 'cat-toys' to get every product in that collection
  • ๐Ÿ“ฆ Bulk extraction: set maxItems up to 1,000,000 to pull the entire catalog in one run
  • ๐Ÿงพ Flat schema: each product is returned as a single row with consistent fields, ready for spreadsheets

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with Heads Up For Tails data

๐Ÿ“Š Track pet food prices.

A pricing analyst runs the Actor weekly on the 'dog-food' collection to see which brands changed price and by how much.

๐Ÿ›’ Build a competitor assortment report.

An e-commerce manager scrapes all collections to compare Heads Up For Tails' catalog against their own store.

๐Ÿ” Audit product SEO.

An SEO specialist pulls the full catalog to check product titles and descriptions for missing keywords.

๐Ÿ“ฆ Generate a dropshipping feed.

A dropshipper scrapes the 'all' collection and maps the rows to their own store's import format.

Why choose this scraper

What you get
No Shopify app required Reads the public collection JSON directly, no authentication or API key
One handle, whole collection Get every product in a category without paginating manually
Export anywhere CSV, JSON, Excel, or XML for your existing workflow

How it compares

No other Store actor targets Heads Up For Tails the same way, so the honest comparison is with the alternatives teams actually weigh.

Heads Up For Tails Catalog Scraper Build it in-house By hand
Setup Run it now, zero config Days of engineering None, but hours per pull
When Heads Up For Tails changes Maintained for you You fix it You re-learn the page
Proxies, retries, anti-bot Built in Your problem Browser only
Output Fixed JSON schema, CSV/Excel export Whatever you build Copy-paste
Cost Pay per result Engineering time Analyst hours

Configure the run

Drive the Actor with a single collection handle, and cap the number of products returned per run. The Input tab lists every parameter.

A first run with the defaults:

{
  "collectionHandle": "all",
  "maxItems": 10
}

A larger pull:

{
  "collectionHandle": "all",
  "maxItems": 200
}

Pricing

Pay-per-result: $0.01599 per result collected. You pay only for the results written to your dataset.

Results collected Approximate cost
100 results $1.60
1,000 results $15.99
10,000 results $159.90

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

  1. Create a free Apify account with $5 in credit.
  2. Open the Heads Up For Tails Catalog Scraper.
  3. Set your inputs and any filters, then click Start.
  4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to Heads Up For Tails through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/heads-up-for-tails-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check the collectionHandle. It must match exactly what appears in the URL, including hyphens. Try 'all' to confirm the site is reachable. If 'all' works but your handle does not, the collection may be empty or renamed.

Why did the run stop before reaching maxItems?

The Actor stops when it has read all products in the collection. If the collection has fewer products than maxItems, you will get fewer rows. Increase maxItems only if you expect more products.

Why are some products missing fields?

Not every product has every field. For example, a product may not have a compare-at price. The Actor returns whatever the website provides, so missing fields are normal.

Can I scrape multiple collections in one run?

No, the Actor takes one collection handle per run. To scrape multiple collections, run the Actor multiple times with different handles, or use Apify's scheduler to run them in sequence.

FAQ

Question Answer
What is a collection handle? It is the part of the Heads Up For Tails URL after /collections/. For example, in https://headsupfortails.com/collections/dog-food, the handle is 'dog-food'. Use 'all' to scrape every product.
Can I scrape the entire catalog? Yes. Set collectionHandle to 'all' and maxItems to a high number like 1000000. The Actor will return every product it finds.
Does this need an API key or login? No. The Actor reads the public Shopify collection feeds that the website itself uses, so no authentication is required.
What data do I get for each product? Each row includes the product title, price, availability, and other fields as shown in the sample output. The exact fields are listed in the dataset schema.
How often should I run this? For price monitoring, weekly is usually enough. For new product alerts, you can schedule it daily. The Actor is fast and cheap to run.
Can I filter by product type or brand? The Actor does not filter by type or brand directly. Scrape a collection that matches your interest, or filter the exported dataset in your own tools.
Is this legal? You should only scrape public data in accordance with the website's terms of service and applicable laws. Apify provides the tool, you are responsible for how you use it.
What if a collection has no products? The Actor will return an empty dataset. Double-check the collection handle for typos, or try 'all' to see if the site has any products at all.

Related actors

Browse the full ParseForge collection for more scrapers.

๐Ÿ†˜ Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

โš ๏ธ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Heads Up For Tails. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

Input

FieldTypeWhat it doesDefault
collectionHandle required string Shopify collection handle to scrape products from (e.g., 'dog-food', 'cat-food', 'all') all
maxItems integer How many products to collect per run. 10

Pricing

from $11.99 per 1,000 results

Charged forWhat it isPrice each
Actor Start Charged once when the run starts. $0.005
Result Item Charged once per result collected. $0.01199 to $0.01599

Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.

API

One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.

POST ยท run and get results
curl -X POST "https://api.apify.com/v2/acts/parseforge~heads-up-for-tails-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "helloWorld": 123
  }'

Examples

Input that runs as-is.

input.json
{
  "helloWorld": 123
}

Reviews

No reviews yet. Be the first.

Issues

We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.

Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.

Related scrapers

Run Heads Up For Tails Catalog Scraper on Apify All scrapers