You can access the Facebook Hashtag Scraper - Ad Library Search by Hashtag programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "niNlxfQkCwpLcXXVF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~facebook-hashtag-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-facebook-hashtag-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/khadinakbar~facebook-hashtag-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-facebook-hashtag-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/khadinakbar~facebook-hashtag-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-facebook-hashtag-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "hashtags"
        ],
        "properties": {
          "hashtags": {
            "title": "Hashtags",
            "type": "array",
            "description": "List of hashtags to search the Facebook Ad Library for (e.g. ['#blackfriday', 'fitness']). The leading '#' is optional and added automatically; spaces inside a tag are removed ('#summer sale' becomes '#summersale'). Each hashtag is searched independently and matched against ad copy in the Meta Ad Library. This is NOT a Facebook page URL or username - to scrape a page's posts use a Facebook page scraper instead.",
            "items": {
              "type": "string"
            }
          },
          "maxResultsPerHashtag": {
            "title": "Max ads per hashtag",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum number of ads to return for each hashtag (e.g. 50). The actor paginates through the Ad Library until it reaches this cap or runs out of results. Defaults to 50; range 1-1000. You are charged per ad returned, so this is also your per-hashtag cost cap.",
            "default": 50
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Two-letter ISO country code to scope ad delivery (e.g. 'US', 'GB', 'DE'), or 'ALL' for every country. Defaults to 'ALL'. This filters where the ads were shown, not the advertiser's location. Invalid codes fall back to 'ALL'.",
            "default": "ALL"
          },
          "status": {
            "title": "Ad status",
            "enum": [
              "ACTIVE",
              "INACTIVE",
              "ALL"
            ],
            "type": "string",
            "description": "Whether to return currently running ads, stopped ads, or both. 'ACTIVE' returns live ads only (default), 'INACTIVE' returns stopped ads, 'ALL' returns both. Active-only is the most useful for competitor monitoring.",
            "default": "ACTIVE"
          },
          "mediaType": {
            "title": "Media type",
            "enum": [
              "ALL",
              "IMAGE",
              "VIDEO",
              "MEME",
              "IMAGE_AND_MEME"
            ],
            "type": "string",
            "description": "Filter ads by creative format. 'ALL' returns every format (default), 'IMAGE' returns image ads, 'VIDEO' returns video ads, 'MEME' returns image-with-text. Use this to study a specific creative style for a hashtag.",
            "default": "ALL"
          },
          "searchType": {
            "title": "Match type",
            "enum": [
              "keyword_unordered",
              "keyword_exact_phrase"
            ],
            "type": "string",
            "description": "How the hashtag is matched. 'keyword_unordered' matches the tag anywhere in the ad (default, broader recall), 'keyword_exact_phrase' matches the exact phrase only (higher precision). Use exact phrase when a hashtag is a common substring of other words.",
            "default": "keyword_unordered"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "total_impressions",
              "relevancy_monthly_grouped"
            ],
            "type": "string",
            "description": "Result ordering. 'total_impressions' surfaces the highest-reach ads first (default), 'relevancy_monthly_grouped' uses Meta's relevance grouping. Impressions-first is best for finding the biggest spenders on a hashtag.",
            "default": "total_impressions"
          },
          "startDate": {
            "title": "Impressions start date",
            "type": "string",
            "description": "Only return ads that were shown on or after this date, in YYYY-MM-DD format (e.g. '2026-01-01'). Leave empty for no lower bound. Use with End date to scope a campaign window."
          },
          "endDate": {
            "title": "Impressions end date",
            "type": "string",
            "description": "Only return ads that were shown on or before this date, in YYYY-MM-DD format (e.g. '2026-03-31'). Leave empty for no upper bound. Combine with Start date to isolate a specific period."
          },
          "includeRaw": {
            "title": "Include raw provider payload",
            "type": "boolean",
            "description": "Set to true to attach the unmodified provider response for each ad under a 'raw' field. Useful for debugging or accessing fields not in the normalized schema. Defaults to false to keep records small and cheap to read.",
            "default": false
          },
          "providerOrder": {
            "title": "Provider order",
            "enum": [
              "auto",
              "scrapecreators-first",
              "sociavault-first"
            ],
            "type": "string",
            "description": "Internal data-provider order for testing and fallback control. 'auto' tries ScrapeCreators before SociaVault when both secrets exist (default). 'scrapecreators-first' or 'sociavault-first' force an order. Not relevant to most users.",
            "default": "auto"
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Facebook Hashtag Scraper - Ad Library Ads by Hashtag OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Facebook Hashtag Scraper - Ad Library Search by Hashtag from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Facebook Hashtag Scraper - Ad Library Search by Hashtag API in Python

Facebook Hashtag Scraper - Ad Library Search by Hashtag API in JavaScript

Facebook Hashtag Scraper - Ad Library Search by Hashtag API through CLI

Facebook Hashtag Scraper - Ad Library Search by Hashtag API

Meta/Facebook Ads Library Scraper

alwaysprimedev/facebook-ads-library-scraper

Scrape ads, creatives, advertisers, and landing pages from the Facebook (Meta) Ad Library by keyword or advertiser — fast, structured JSON.

Always Prime

Facebook Ads Library Scraper

scrapemesh/facebook-ads-library-scraper

Facebook Ads Library Scraper extracts public Facebook Ads Library data, including ad creatives, advertiser details, ad copy, media, landing pages, campaign status, and more. Ideal for competitor analysis, ad monitoring, creative research, and marketing intelligence.

ScrapeMesh

Facebook Ads Library Scraper - Meta Ad Creative Monitor

meilimiao/facebook-ads-library-monitor

Scrape Meta/Facebook Ads Library by keyword, Ads Library URL, or Page ID. Extract ad copy, creatives, CTA, landing pages, dates, and monitor newly launched competitor ads.

Glamour Meow

Meta Ad Library Ads Scraper

adside/meta-ad-library-ads-scraper

Scrape active Meta Ad Library ads by Facebook page ID. Get ad creatives, copy, media, CTAs, landing URLs, dates & platforms for competitor research.

Adside

Facebook Ad Library Scraper - Ads & Advertisers

lentic_clockss/facebook-ad-library-scraper

Scrape Facebook Ad Library ads and advertiser signals for competitive research and creative monitoring. Export structured ad metadata without building browser automation from scratch.

kane liu

Meta Ad Library Scraper | Ad Copy & Landing Pages

happyfhantum/meta-ad-library-intelligence-scraper

Pull competitor ads from the public Meta Ad Library with ad copy, CTAs, landing pages, and angle tags.

Kelsey Todd

Meta Ad Library API - Facebook & Instagram Ads Scraper

thenetaji/meta-ad-library-api-scraper

Scrape public Facebook and Instagram ads from Meta Ad Library: search by keyword or Ad Library URL, browse every ad from a known advertiser Page, or find a Page's ID by brand name. Filter by country, status, category, format, platform, and date, and optionally enrich each ad with full details.

The Netaji

5.0

Meta Facebook Ad Library Scraper

code-node-tools/facebook-ad-library-scraper

Meta Facebook Ads Library scraper for keyword, Page, or URL search. Extract ad creatives, advertiser info, spend, and reach as JSON/CSV, no login needed. Also works as a Meta Ads Library scraper and Facebook Ad Library scraping API via Apify.

CodeNodeTools

Meta Ad Library Scraper — Facebook & Instagram Ads API No Login

affiliatescope/meta-ads-scraper

Bulk Meta Ad Library scraper — every Facebook & Instagram ad, creative, landing URL. $0.0015/ad. No login, no Graph API approval. Raw JSON passthrough. Perfect for creative and competitor research.

AffiliateScope

155

5.0

Meta Ad Library - Competitor Ad Scaling Tracker

xtracto/meta-ad-library-tracker

Scrape live competitor ads from the public Meta Ad Library (Facebook & Instagram): ad copy, creative images/videos, landing page URL, start date, and active status. No account or API key required.