> ## Documentation Index
> Fetch the complete documentation index at: https://agnt.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fech Search Ads Keywords

> The Fetch Search Ads Keywords endpoint allows you to search for ads based on a specified query. You can filter ads by country, status (Active or Inactive), and ad type.



## OpenAPI

````yaml /openapi/facebook.openapi.json get /v1/data/facebook/fetch_search_ads_keywords
openapi: 3.0.0
info:
  title: agntdata Facebook API
  description: >-
    Unlock Facebook data effortlessly with our powerful scraping tools. Extract
    page names, URLs, contact info, likes, followers, posts, comments,
    Marketplace listings, and meta ads metrics. Perfect for market research,
    trend analysis, and optimizing marketing strategies.
  version: 1.0.0
  contact:
    name: agntdata
    url: https://agntdata.dev
servers:
  - url: https://api.agntdata.dev
    description: agntdata API
security:
  - ApiKeyAuth: []
tags:
  - name: Facebook Marketplace Listings
    description: ''
  - name: Facebook Posts Details
    description: ''
  - name: Facebook Search
    description: >-
      The Facebook Search API group provides a comprehensive set of endpoints to
      perform various types of searches across Facebook data, including posts,
      pages, people, and places. These endpoints enable users to retrieve
      targeted information based on specific query parameters and filters such
      as location, user identifiers, and other relevant attributes.
  - name: Meta Ads Library Search
    description: >-
      The Meta Ads Library Search allows you to search and retrieve detailed
      information from Meta’s Ad Library, providing insights into active and
      inactive ad campaigns across Facebook and Instagram. This tool is ideal
      for marketing analysis, competitor research, and understanding ad
      strategies.
  - name: Facebook Pages Details/Posts
    description: ''
  - name: 'Facebook Groups Details/Posts '
    description: ''
  - name: Facebook Download Media
    description: >-
      Download media (images, videos, audio) from Facebook URLs. Returns file
      size in MB and media type.
paths:
  /v1/data/facebook/fetch_search_ads_keywords:
    get:
      tags:
        - Meta Ads Library Search
      summary: Fech Search Ads Keywords
      description: >-
        The Fetch Search Ads Keywords endpoint allows you to search for ads
        based on a specified query. You can filter ads by country, status
        (Active or Inactive), and ad type.
      operationId: Fech_Search_Ads_Keywords
      parameters:
        - name: country
          in: query
          required: false
          schema:
            type: string
        - name: query
          in: query
          required: true
          schema:
            type: string
            default: cars
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Get_facebook_fetch_search_ads_keywords_Response
        '400':
          description: Bad request
        '401':
          description: Unauthorized - invalid API key
        '429':
          description: Rate limit exceeded
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Get_facebook_fetch_search_ads_keywords_Response:
      type: object
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Bearer token. Pass your agntdata API key as: Authorization: Bearer
        agnt_live_...

````