search
Retrieve matching Meta Ads record IDs by querying ad accounts, campaigns, ads, pages, and businesses. Enables targeted data access for integration with AI tools.
Instructions
Search through Meta Ads data and return matching record IDs.
This tool is required for OpenAI ChatGPT Deep Research integration.
It searches across ad accounts, campaigns, ads, pages, and businesses to find relevant records
based on the provided query.
Args:
access_token: Meta API access token (optional - will use cached token if not provided)
query: Search query string to find relevant Meta Ads records
Returns:
JSON response with list of matching record IDs
Example Usage:
search(query="active campaigns")
search(query="account spending")
search(query="facebook ads performance")
search(query="facebook pages")
search(query="user businesses")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| access_token | No | ||
| query | No |
Input Schema (JSON Schema)
{
"properties": {
"access_token": {
"default": null,
"title": "Access Token",
"type": "string"
},
"query": {
"default": null,
"title": "Query",
"type": "string"
}
},
"title": "searchArguments",
"type": "object"
}