# Adside.ai API

## Docs

- [Add Assets To Group](https://docs.adside.ai/api-reference/google-ads/add-assets-to-group.md): Link existing assets to an asset group with field_type mapping (HEADLINE, DESCRIPTION, MARKETING_IMAGE, etc.).
- [Add Audience To Campaign](https://docs.adside.ai/api-reference/google-ads/add-audience-to-campaign.md): Add an audience segment to a campaign or ad group as targeting criterion.
- [Add Keywords](https://docs.adside.ai/api-reference/google-ads/add-keywords.md): Add keywords to an ad group (batch, up to 200). Supports EXACT, PHRASE, and BROAD match types, and negative keywords.
- [Create Ad Group](https://docs.adside.ai/api-reference/google-ads/create-ad-group.md): Create an ad group within a campaign. Set default CPC bid and ad rotation.
- [Create Asset](https://docs.adside.ai/api-reference/google-ads/create-asset.md): Create a text, image, or video asset for use in Performance Max Asset Groups.
- [Create Asset Group](https://docs.adside.ai/api-reference/google-ads/create-asset-group.md): Create an asset group for a Performance Max campaign. Google's AI assembles ads from the assets in each group.
- [Create Campaign Budget](https://docs.adside.ai/api-reference/google-ads/create-campaign-budget.md): Create a campaign budget. Amount is in dollars (converted to micros internally). Required before creating a campaign.
- [Create Conversion Action](https://docs.adside.ai/api-reference/google-ads/create-conversion-action.md): Create a conversion action for tracking user actions (purchases, sign-ups, etc.). Required for Smart Bidding strategies.
- [Create Google Campaign](https://docs.adside.ai/api-reference/google-ads/create-google-campaign.md): Create a Search or Performance Max campaign. Always created as PAUSED by default (safety contract). Requires a budget_id from create_campaign_budget.
- [Create Responsive Search Ad](https://docs.adside.ai/api-reference/google-ads/create-responsive-search-ad.md): Create a Responsive Search Ad (RSA) with 3-15 headlines and 2-4 descriptions. Google tests combinations to find best performers.
- [Get Campaign Performance](https://docs.adside.ai/api-reference/google-ads/get-campaign-performance.md): Get campaign performance metrics (impressions, clicks, cost, conversions, CTR, CPC). Supports date ranges and segmentation.
- [Get Customer](https://docs.adside.ai/api-reference/google-ads/get-customer.md): Get Google Ads account details including name, currency, timezone, and status.
- [Get Geo Targets](https://docs.adside.ai/api-reference/google-ads/get-geo-targets.md): Search geographic targets by name (countries, regions, cities). Returns geo target constant IDs for campaign targeting.
- [Get Keyword Performance](https://docs.adside.ai/api-reference/google-ads/get-keyword-performance.md): Get keyword-level performance metrics with quality score breakdown (expected CTR, ad relevance, landing page experience).
- [Get Search Terms Report](https://docs.adside.ai/api-reference/google-ads/get-search-terms-report.md): Get actual search queries that triggered your ads (vs keywords you're targeting). Essential for negative keyword discovery.
- [List Accessible Customers](https://docs.adside.ai/api-reference/google-ads/list-accessible-customers.md): List all Google Ads customer accounts accessible with the current credentials.
- [List Ad Groups](https://docs.adside.ai/api-reference/google-ads/list-ad-groups.md): List ad groups for a campaign with bids, status, and rotation settings.
- [List Asset Groups](https://docs.adside.ai/api-reference/google-ads/list-asset-groups.md): List asset groups for a Performance Max campaign with status and final URLs.
- [List Assets](https://docs.adside.ai/api-reference/google-ads/list-assets.md): List assets (text, image, video) for a Google Ads account. Filter by type.
- [List Audience Segments](https://docs.adside.ai/api-reference/google-ads/list-audience-segments.md): List available audience segments (in-market, affinity, custom) for targeting.
- [List Campaign Budgets](https://docs.adside.ai/api-reference/google-ads/list-campaign-budgets.md): List campaign budgets for a Google Ads account with usage information.
- [List Conversion Actions](https://docs.adside.ai/api-reference/google-ads/list-conversion-actions.md): List conversion actions configured for the account.
- [List Google Ads](https://docs.adside.ai/api-reference/google-ads/list-google-ads.md): List ads in an ad group with RSA details including headlines, descriptions, and ad strength.
- [List Google Campaigns](https://docs.adside.ai/api-reference/google-ads/list-google-campaigns.md): List campaigns with optional filters for status and type. Includes budget and bidding information.
- [List Keywords](https://docs.adside.ai/api-reference/google-ads/list-keywords.md): List keywords for an ad group with match type, quality score, and performance data.
- [Remove Ad](https://docs.adside.ai/api-reference/google-ads/remove-ad.md): PERMANENTLY remove an ad. IRREVERSIBLE. Requires confirm: true.
- [Remove Ad Group](https://docs.adside.ai/api-reference/google-ads/remove-ad-group.md): PERMANENTLY remove an ad group. IRREVERSIBLE. Requires confirm: true.
- [Remove Asset](https://docs.adside.ai/api-reference/google-ads/remove-asset.md): PERMANENTLY remove an asset. IRREVERSIBLE. Requires confirm: true.
- [Remove Asset Group](https://docs.adside.ai/api-reference/google-ads/remove-asset-group.md): PERMANENTLY remove an asset group. IRREVERSIBLE. Requires confirm: true.
- [Remove Campaign](https://docs.adside.ai/api-reference/google-ads/remove-campaign.md): PERMANENTLY remove a campaign. This action is IRREVERSIBLE — the campaign and all its data will be lost. Requires confirm: true.
- [Remove Campaign Budget](https://docs.adside.ai/api-reference/google-ads/remove-campaign-budget.md): PERMANENTLY remove a campaign budget. This action is IRREVERSIBLE — the budget and all its data will be lost. Budget must not be in use by any campaign. Requires confirm: true.
- [Remove Keywords](https://docs.adside.ai/api-reference/google-ads/remove-keywords.md): Remove keywords from an ad group by criterion IDs. PERMANENT and IRREVERSIBLE. Requires confirm: true.
- [Run Gaql Query](https://docs.adside.ai/api-reference/google-ads/run-gaql-query.md): Execute a raw GAQL query for advanced users. Escape-hatch tool for power users. Use Google Ads Query Language (GAQL) syntax. Returns raw results from Google Ads API.
- [Update Ad Group](https://docs.adside.ai/api-reference/google-ads/update-ad-group.md): Update ad group properties (name, status, bid, rotation mode).
- [Update Campaign Budget](https://docs.adside.ai/api-reference/google-ads/update-campaign-budget.md): Update an existing campaign budget (name, amount, delivery method).
- [Update Google Ad](https://docs.adside.ai/api-reference/google-ads/update-google-ad.md): Update an ad's status (ENABLED or PAUSED). RSA content cannot be modified after creation.
- [Update Google Campaign](https://docs.adside.ai/api-reference/google-ads/update-google-campaign.md): Update campaign properties (name, status, bidding strategy, dates, geo targeting).
- [Create Drive Folder](https://docs.adside.ai/api-reference/google/create-drive-folder.md): Create a Google Drive folder or nested folder path. Reuses existing intermediate folders, but fails if the final target already exists as either a folder or file.
- [Download Drive File](https://docs.adside.ai/api-reference/google/download-drive-file.md): Download a Google Drive file through the connected Google workspace context and return the binary bytes.
- [Get Drive File Metadata](https://docs.adside.ai/api-reference/google/get-drive-file-metadata.md): Return metadata for a Google Drive file, including its parent folder ID. Use this to resolve the parent of a source file before creating a sibling output folder.
- [Get Drive Thumbnail](https://docs.adside.ai/api-reference/google/get-drive-thumbnail.md): Proxy a Google Drive file thumbnail through the connected Google workspace context.
- [List Drive Files](https://docs.adside.ai/api-reference/google/list-drive-files.md): List files in a Google Drive folder available through the connected Google workspace context.
- [List Drive Folders](https://docs.adside.ai/api-reference/google/list-drive-folders.md): List subfolders in a Google Drive folder. Defaults to `root` (My Drive) when `parent_id` is omitted.
- [Read Meta Bulk Upload Sheet](https://docs.adside.ai/api-reference/google/read-meta-bulk-upload-sheet.md): Read the Adside Meta bulk-upload Google Sheets template and return structured campaign and ad set data.
- [Read Video Generation Cities Sheet](https://docs.adside.ai/api-reference/google/read-video-generation-cities-sheet.md): Read the GOATS-96 city-localization Google Sheets template and return structured city rows for video variations generation.
- [Upload Drive File to Meta](https://docs.adside.ai/api-reference/google/upload-drive-file-to-meta.md): Upload a file from Google Drive directly to Meta Ads Manager. Requires both Google and Meta channel connections.
- [Upload File to Drive Folder](https://docs.adside.ai/api-reference/google/upload-file-to-drive-folder.md): Upload a local file into a Google Drive folder through the connected Google workspace context.
- [Write Meta Bulk Upload Sheet Results](https://docs.adside.ai/api-reference/google/write-meta-bulk-upload-sheet-results.md): Write bulk-upload result columns back to rows in the Adside Meta bulk-upload Google Sheets template.
- [Compare Linkedin Performance](https://docs.adside.ai/api-reference/linkedin/compare-linkedin-performance.md): Compare performance across multiple campaigns side-by-side. Returns analytics grouped by campaign for easy comparison of metrics like impressions, clicks, cost, and conversions.
- [Create Campaign Group](https://docs.adside.ai/api-reference/linkedin/create-campaign-group.md): Create a new campaign group in a LinkedIn Ad Account. Campaign groups organize related campaigns and can control shared budget and schedule.
- [Create Conversion Rule](https://docs.adside.ai/api-reference/linkedin/create-conversion-rule.md): Create a new conversion tracking rule for a LinkedIn Ad Account. Optionally auto-associates with all campaigns.
- [Create Creative](https://docs.adside.ai/api-reference/linkedin/create-creative.md): Create a new creative in a campaign. Use content_reference to sponsor an existing post, or inline_content to create a new post and creative in one call.
- [Create Linkedin Campaign](https://docs.adside.ai/api-reference/linkedin/create-linkedin-campaign.md): Create a new campaign in a LinkedIn Ad Account. Requires campaign group, name, type, objective, cost type, locale, and budget. Optionally set targeting, schedule, and format.
- [Delete Campaign Group](https://docs.adside.ai/api-reference/linkedin/delete-campaign-group.md): Delete a campaign group. DRAFT groups are hard-deleted; all other statuses are soft-deleted by setting status to PENDING_DELETION.
- [Delete Linkedin Campaign](https://docs.adside.ai/api-reference/linkedin/delete-linkedin-campaign.md): Delete a campaign. DRAFT campaigns are hard-deleted; all other statuses are soft-deleted by setting status to PENDING_DELETION.
- [Get Ad Account](https://docs.adside.ai/api-reference/linkedin/get-ad-account.md): Get details of a LinkedIn Ad Account (name, status, currency, type, serving statuses)
- [Get Analytics](https://docs.adside.ai/api-reference/linkedin/get-analytics.md): Get performance analytics (impressions, clicks, cost, conversions, etc.) for LinkedIn ad entities. Group by account, campaign group, campaign, or creative with daily/monthly/all-time granularity.
- [Get Audience Size Estimate](https://docs.adside.ai/api-reference/linkedin/get-audience-size-estimate.md): Estimate the audience size for a given targeting criteria. Returns the approximate number of LinkedIn members matching the targeting. Useful for validating targeting before creating campaigns.
- [Get Company Pages](https://docs.adside.ai/api-reference/linkedin/get-company-pages.md): List LinkedIn Company Pages (organizations) the authenticated user has access to, with their roles.
- [Get Creative](https://docs.adside.ai/api-reference/linkedin/get-creative.md): Get details of a specific creative by ID, including content, status, review status, and serving hold reasons.
- [Get Demographic Insights](https://docs.adside.ai/api-reference/linkedin/get-demographic-insights.md): Get professional demographic analytics for LinkedIn ads. Break down performance by member company, industry, seniority, job title, job function, or location. Uses q=analytics with MEMBER_* pivots. Note: demographic data has 12-24h delay and 2-year retention.
- [Get Targeting Entities](https://docs.adside.ai/api-reference/linkedin/get-targeting-entities.md): Resolve targeting URNs to human-readable names. Pass a list of URNs (e.g. urn:li:seniority:7, urn:li:industry:9) to get their display names.
- [List Ad Accounts](https://docs.adside.ai/api-reference/linkedin/list-ad-accounts.md): List all LinkedIn Ad Accounts the authenticated user has access to. Supports filtering by status, type, and test flag.
- [List Campaign Groups](https://docs.adside.ai/api-reference/linkedin/list-campaign-groups.md): Search and list campaign groups for a LinkedIn Ad Account. Filter by status, name, or test flag. Supports cursor-based pagination.
- [List Conversions](https://docs.adside.ai/api-reference/linkedin/list-conversions.md): List all conversion rules for a LinkedIn Ad Account. Returns conversion name, type, method, attribution settings, and enabled status.
- [List Linkedin Campaigns](https://docs.adside.ai/api-reference/linkedin/list-linkedin-campaigns.md): List campaigns for a LinkedIn Ad Account. Filter by status, type, campaign group, or name. Supports cursor-based pagination.
- [List Linkedin Creatives](https://docs.adside.ai/api-reference/linkedin/list-linkedin-creatives.md): Search and list creatives for a LinkedIn Ad Account. Filter by campaign, status, or creative IDs. Uses q=criteria finder with cursor-based pagination (max 100 per page).
- [Search Campaigns](https://docs.adside.ai/api-reference/linkedin/search-campaigns.md): Search campaigns with multiple filters (IDs, statuses, types, campaign groups). More flexible than list_campaigns for complex queries.
- [Search Targeting Facets](https://docs.adside.ai/api-reference/linkedin/search-targeting-facets.md): Search for targeting entity values by facet type. Use typeahead search with a query string, or list all values for a facet. Returns URNs to use in campaign targeting criteria. Uses the /v2/ API path.
- [Send Conversion Event](https://docs.adside.ai/api-reference/linkedin/send-conversion-event.md): Send a conversion event to LinkedIn. Requires at least one user identifier (SHA256 email, LinkedIn tracking UUID, or first+last name). The conversion must have been created first and must be within the past 90 days.
- [Update Campaign Group](https://docs.adside.ai/api-reference/linkedin/update-campaign-group.md): Update an existing campaign group's settings (name, status, budget, schedule). Only provided fields are updated via RestLi PARTIAL_UPDATE.
- [Update Linkedin Campaign](https://docs.adside.ai/api-reference/linkedin/update-linkedin-campaign.md): Update an existing campaign's settings (name, status, budget, bid, schedule, delivery options). Only provided fields are updated via RestLi PARTIAL_UPDATE.
- [Update Linkedin Creative](https://docs.adside.ai/api-reference/linkedin/update-linkedin-creative.md): Update a creative's intended status or name via RestLi PARTIAL_UPDATE. Cannot pause a creative that is under review.
- [Upload Image](https://docs.adside.ai/api-reference/linkedin/upload-image.md): Upload an image from a public URL to LinkedIn for use in creatives. Returns the image URN to use in create_creative.
- [Verify Campaign Readiness](https://docs.adside.ai/api-reference/linkedin/verify-campaign-readiness.md): Verify campaign readiness by checking serving statuses, budget, targeting, and creative setup. Returns a diagnostic report with issues and recommendations.
- [Analyze Account Creatives](https://docs.adside.ai/api-reference/meta/analyze-account-creatives.md): Analyze all creatives in an account to identify patterns, performance insights, and optimization opportunities. Provides summary statistics and recommendations.
- [Check Api V23 Compliance](https://docs.adside.ai/api-reference/meta/check-api-v23-compliance.md): Check if your creative parameters are compliant with Meta Marketing API v23.0 requirements. Identifies deprecated features and recommends v23.0 best practices.
- [Check Campaign Readiness](https://docs.adside.ai/api-reference/meta/check-campaign-readiness.md): Check if a campaign is ready for ad set creation. Identify the campaign by ID or by name. Returns a readiness report with issues, requirements, and recommendations.
- [Compare Meta Performance](https://docs.adside.ai/api-reference/meta/compare-meta-performance.md): Compare performance metrics across multiple campaigns, ad sets, or ads side by side. Returns ranked comparisons with summary statistics for each object.
- [Create Ad](https://docs.adside.ai/api-reference/meta/create-ad.md): Create a new ad within an ad set. Requires an existing creative and ad set. The ad is created in PAUSED status by default.
- [Create Ad Creative](https://docs.adside.ai/api-reference/meta/create-ad-creative.md): Create a new ad creative with images, videos, text, and call-to-action buttons. Supports both image and video creatives with proper object_story_spec structure for Meta API compliance.
- [Create Ad Set Enhanced](https://docs.adside.ai/api-reference/meta/create-ad-set-enhanced.md): Create a new ad set with advanced validation and helpful error messages. Specify campaign, name, budget (daily or lifetime), optimization goal, billing event, targeting, and promoted object if required by the campaign objective. Returns the new ad set ID and summary, or detailed error guidance if cr…
- [Create Custom Audience](https://docs.adside.ai/api-reference/meta/create-custom-audience.md): Create a new custom audience from customer data, website visitors, app users, or other sources. Specify subtype to control the data source.
- [Create Lookalike Audience](https://docs.adside.ai/api-reference/meta/create-lookalike-audience.md): Create a lookalike audience based on an existing custom audience. Specify the source audience, target country, and similarity ratio (1-20%).
- [Create Meta Campaign](https://docs.adside.ai/api-reference/meta/create-meta-campaign.md): Create a new Meta ad campaign. Specify the objective, name, and either a daily or lifetime budget (not both). Optionally set start/stop times, special ad categories, and bid strategy. The campaign will be created in PAUSED status unless otherwise specified. Returns the new campaign ID and summary.
- [Delete Ad](https://docs.adside.ai/api-reference/meta/delete-ad.md): Delete an ad. This action cannot be undone.
- [Delete Audience](https://docs.adside.ai/api-reference/meta/delete-audience.md): Permanently delete a custom or lookalike audience. This action cannot be undone — campaigns using this audience will need updated targeting.
- [Delete Creative](https://docs.adside.ai/api-reference/meta/delete-creative.md): Delete an ad creative by ID. This will affect all ads using the creative.
- [Delete Meta Campaign](https://docs.adside.ai/api-reference/meta/delete-meta-campaign.md): Permanently delete a campaign and all its associated ad sets and ads. This action cannot be undone. Identify the campaign by ID or by name.
- [Estimate Audience Size](https://docs.adside.ai/api-reference/meta/estimate-audience-size.md): Estimate the potential reach of a targeting specification. Returns monthly and daily active user estimates with targeting recommendations.
- [Exchange Code For Token](https://docs.adside.ai/api-reference/meta/exchange-code-for-token.md): Exchange an OAuth authorization code for an access token. Use after the user has granted permissions via the auth URL.
- [Export Insights](https://docs.adside.ai/api-reference/meta/export-insights.md): Export performance insights data in CSV or JSON format. Fetches up to 1000 records for comprehensive data export with optional breakdowns.
- [Generate Auth Url](https://docs.adside.ai/api-reference/meta/generate-auth-url.md): Generate a Meta OAuth authorization URL for user login. Returns a URL to open in a browser to grant ad account permissions.
- [Generate System User Token](https://docs.adside.ai/api-reference/meta/generate-system-user-token.md): Generate an access token for a Business Manager system user. Used for server-to-server automation with configurable expiration.
- [Get Account Pages](https://docs.adside.ai/api-reference/meta/get-account-pages.md): List Facebook Pages available for ad creation on the given ad account. Returns page IDs and names needed for promoted_object in ad sets.
- [Get Account Pixels](https://docs.adside.ai/api-reference/meta/get-account-pixels.md): List Meta Pixels (formerly Facebook Pixels) on the ad account. Returns pixel IDs needed for conversion tracking in promoted_object for Sales and Leads campaigns.
- [Get Ad](https://docs.adside.ai/api-reference/meta/get-ad.md): Retrieve details for a single ad including its name, status, ad set, campaign, and creative.
- [Get Ad Creative](https://docs.adside.ai/api-reference/meta/get-ad-creative.md): Get a single ad creative by ID with full details including copy, media, and Advantage+ Creative (asset_feed_spec) data. Use this to retrieve the actual ad copy text (bodies, titles, descriptions) for creatives using Advantage+ or dynamic creative optimization.
- [Get Ad Images](https://docs.adside.ai/api-reference/meta/get-ad-images.md): Retrieve ad images from a Meta ad account. Returns image URLs, dimensions, and hashes. Use to get image URLs for displaying ad creatives or generating variations.
- [Get Ad Set](https://docs.adside.ai/api-reference/meta/get-ad-set.md): Retrieve details for a single ad set including its targeting, budget, optimization goal, and schedule.
- [Get Attribution Data](https://docs.adside.ai/api-reference/meta/get-attribution-data.md): Retrieve attribution data with conversion tracking across multiple attribution windows (1-day click, 7-day click, 1-day view). Returns conversion metrics and cost-per-conversion analysis.
- [Get Audience Details](https://docs.adside.ai/api-reference/meta/get-audience-details.md): Get detailed information about a specific audience including size estimates, delivery status, operation status, data source, and targeting rules.
- [Get Campaign](https://docs.adside.ai/api-reference/meta/get-campaign.md): Retrieve full details for a specific campaign by ID or name. Returns all campaign fields including status, objective, budget, and timing.
- [Get Creative Best Practices](https://docs.adside.ai/api-reference/meta/get-creative-best-practices.md): Get comprehensive best practices for creating high-performing ad creatives. Includes platform-specific guidelines, content recommendations, and optimization strategies.
- [Get Creative Performance](https://docs.adside.ai/api-reference/meta/get-creative-performance.md): Get guidance on analyzing creative performance metrics. Provides recommended approaches for tracking creative effectiveness and optimization strategies.
- [Get Insights](https://docs.adside.ai/api-reference/meta/get-insights.md): Retrieve performance insights (impressions, clicks, spend, CTR, CPC, etc.) for a campaign, ad set, ad, or account. Supports date presets, custom date ranges, breakdowns, and custom field selection.
- [Get Interest Suggestions](https://docs.adside.ai/api-reference/meta/get-interest-suggestions.md): Get suggested interests similar to a list of seed interests. Useful for expanding targeting reach based on existing high-performing interests.
- [Get Meta Api Reference](https://docs.adside.ai/api-reference/meta/get-meta-api-reference.md): Get a reference guide for valid Meta Marketing API parameters, including allowed optimization goals, billing events, and their valid combinations. Use this to troubleshoot parameter errors or to construct valid requests.
- [Get Meta Error Codes](https://docs.adside.ai/api-reference/meta/get-meta-error-codes.md): Get detailed reference for Meta Marketing API error codes, subcodes, and specific solutions. Essential for troubleshooting v23.0 API integration issues.
- [Get Quick Fixes](https://docs.adside.ai/api-reference/meta/get-quick-fixes.md): Get targeted troubleshooting tips for common Meta Ads API errors. Provide an error message to receive likely causes, suggestions, and next steps for resolution.
- [Get Token Info](https://docs.adside.ai/api-reference/meta/get-token-info.md): Get cached token status, configuration details, expiration info, and actionable recommendations for token management.
- [List Ad Sets](https://docs.adside.ai/api-reference/meta/list-ad-sets.md): List all ad sets for a given campaign or ad account. Filter by status and paginate results. Returns ad set details including budget, targeting, and optimization settings.
- [List Audiences](https://docs.adside.ai/api-reference/meta/list-audiences.md): List custom and lookalike audiences for an ad account. Supports filtering by type (custom, lookalike, saved) and pagination.
- [List Meta Ads](https://docs.adside.ai/api-reference/meta/list-meta-ads.md): List all ads for a given campaign, ad set, or ad account. Filter by status and paginate results. Returns ad details including creative, status, and timing.
- [List Meta Campaigns](https://docs.adside.ai/api-reference/meta/list-meta-campaigns.md): Retrieve a paginated list of all campaigns for a Meta ad account. Filter by status (e.g., ACTIVE, PAUSED) and view key campaign details including budget, objective, and timing. Use this to audit or select campaigns for further actions.
- [List Meta Creatives](https://docs.adside.ai/api-reference/meta/list-meta-creatives.md): List all ad creatives in an ad account. Use this to see existing creatives, their formats, and content before creating new ones or reusing existing creatives.
- [Pause Campaign](https://docs.adside.ai/api-reference/meta/pause-campaign.md): Instantly pause a campaign to stop ad delivery and spending. Identify the campaign by ID or by name.
- [Preview Ad](https://docs.adside.ai/api-reference/meta/preview-ad.md): Generate HTML preview of how an ad creative will appear in different placements and formats. Useful for testing creative appearance before launching campaigns.
- [Refresh To Long Lived Token](https://docs.adside.ai/api-reference/meta/refresh-to-long-lived-token.md): Exchange a short-lived token (~1-2 hours) for a long-lived token (~60 days). Recommended for sustained API access.
- [Resume Campaign](https://docs.adside.ai/api-reference/meta/resume-campaign.md): Reactivate a previously paused campaign to resume ad delivery and spending. Identify the campaign by ID or by name.
- [Search Behaviors](https://docs.adside.ai/api-reference/meta/search-behaviors.md): List all available targetable behaviors from Meta's targeting categories. Returns behavior IDs, names, descriptions, and audience sizes.
- [Search Demographics](https://docs.adside.ai/api-reference/meta/search-demographics.md): List all available targetable demographics from Meta's targeting categories. Returns demographic IDs, names, descriptions, and audience sizes.
- [Search Geo Locations](https://docs.adside.ai/api-reference/meta/search-geo-locations.md): Search for targetable geographic locations (countries, regions, cities, zip codes) by keyword. Returns location keys for use in ad set geo targeting.
- [Search Interests](https://docs.adside.ai/api-reference/meta/search-interests.md): Search for targetable interests by keyword. Returns interest IDs, names, audience sizes, and topic paths for use in ad set targeting.
- [Setup Ab Test](https://docs.adside.ai/api-reference/meta/setup-ab-test.md): Get comprehensive guidance on setting up A/B tests for ad creatives. Provides best practices, testing strategies, and metrics to track for creative optimization.
- [Troubleshoot Creative Issues](https://docs.adside.ai/api-reference/meta/troubleshoot-creative-issues.md): Diagnose and fix common creative creation and performance issues. Provide an error message or describe your issue to get specific solutions and recommendations.
- [Update Ad Creative](https://docs.adside.ai/api-reference/meta/update-ad-creative.md): Update an existing ad creative's name, title, body text, or URL tags.
- [Update Ad Set](https://docs.adside.ai/api-reference/meta/update-ad-set.md): Update an existing ad set's name, status, budget, bid, schedule, or targeting.
- [Update Custom Audience](https://docs.adside.ai/api-reference/meta/update-custom-audience.md): Update a custom audience's metadata (name, description, retention days, or rule). At least one field must be provided.
- [Update Meta Ad](https://docs.adside.ai/api-reference/meta/update-meta-ad.md): Update an existing ad's name, status, or creative.
- [Update Meta Campaign](https://docs.adside.ai/api-reference/meta/update-meta-campaign.md): Update an existing campaign's settings. Identify the campaign by name. Change the name, status, budget, or schedule. Only the provided fields will be updated.
- [Update Meta Creative](https://docs.adside.ai/api-reference/meta/update-meta-creative.md): Get information about creative update limitations in Meta's system. Provides alternative approaches since creatives cannot be modified after creation.
- [Upload Creative Asset](https://docs.adside.ai/api-reference/meta/upload-creative-asset.md): Get guidance on uploading creative assets (images/videos) to Meta. Provides step-by-step instructions and technical requirements for asset uploads.
- [Upload Image From Url](https://docs.adside.ai/api-reference/meta/upload-image-from-url.md): Upload an image from a URL to Meta and get the image_hash for v23.0 API compliance. Downloads the image from the provided URL and uploads it to Meta's servers, returning the hash required for ad creatives.
- [Upload Video From Url](https://docs.adside.ai/api-reference/meta/upload-video-from-url.md): Upload a video from a URL to Meta and get the video_id required for video creatives.
- [Validate Creative Enhanced](https://docs.adside.ai/api-reference/meta/validate-creative-enhanced.md): Enhanced creative validation with comprehensive checks including page permissions, image accessibility, and Meta API compliance. Provides detailed feedback and fix suggestions.
- [Validate Creative Setup](https://docs.adside.ai/api-reference/meta/validate-creative-setup.md): Validate ad creative parameters before creation to catch errors early. Checks required fields, URL validity, and provides object_story_spec preview. Use this before create_ad_creative to avoid API errors.
- [Validate Token](https://docs.adside.ai/api-reference/meta/validate-token.md): Validate the current access token by making a live API call to Meta. Returns token validity, permissions, diagnostics, and health check results.
- [Verify Account Setup](https://docs.adside.ai/api-reference/meta/verify-account-setup.md): Verify that a Meta ad account is ready for ad creation. Checks for account access, payment method, Facebook pages, and active campaigns. Returns a setup status, recommendations, and warnings.
- [Create Ad](https://docs.adside.ai/api-reference/tiktok/create-ad.md): Create a TikTok ad with creative (video/image), text, CTA, and landing page. Created DISABLED by default.
- [Create Ad Group](https://docs.adside.ai/api-reference/tiktok/create-ad-group.md): Create a TikTok ad group with targeting, placement, schedule, budget, and bid settings. Created DISABLED by default.
- [Create Campaign](https://docs.adside.ai/api-reference/tiktok/create-campaign.md): Create a TikTok ad campaign. Created with DISABLE status by default (safety). Use update_campaign_status to enable.
- [Get Action Categories](https://docs.adside.ai/api-reference/tiktok/get-action-categories.md): List TikTok behavior/action categories for targeting (user actions on TikTok)
- [Get Advertiser Info](https://docs.adside.ai/api-reference/tiktok/get-advertiser-info.md): Get TikTok advertiser account details (name, status, currency, timezone, balance)
- [Get Audience Report](https://docs.adside.ai/api-reference/tiktok/get-audience-report.md): Get TikTok audience demographic breakdown (age, gender, country, OS, language)
- [Get Identities](https://docs.adside.ai/api-reference/tiktok/get-identities.md): List available TikTok identities for ad creation. An identity is required as the ad author.
- [Get Image Info](https://docs.adside.ai/api-reference/tiktok/get-image-info.md): Get TikTok image details (dimensions, format, URL)
- [Get Interest Categories](https://docs.adside.ai/api-reference/tiktok/get-interest-categories.md): List all TikTok interest category tree for browsing (not keyword search). Returns hierarchical categories with IDs.
- [Get Report](https://docs.adside.ai/api-reference/tiktok/get-report.md): Get TikTok integrated reporting with dimensions, metrics, date range, and filters. Supports campaign/ad group/ad level.
- [Get Video Info](https://docs.adside.ai/api-reference/tiktok/get-video-info.md): Get TikTok video processing status and details (duration, dimensions, format)
- [List Ad Groups](https://docs.adside.ai/api-reference/tiktok/list-ad-groups.md): List TikTok ad groups with optional filtering
- [List Ads](https://docs.adside.ai/api-reference/tiktok/list-ads.md): List TikTok ads with optional filtering by ad group, campaign, or status
- [List Advertisers](https://docs.adside.ai/api-reference/tiktok/list-advertisers.md): List all TikTok advertiser accounts the authenticated user has access to
- [List Campaigns](https://docs.adside.ai/api-reference/tiktok/list-campaigns.md): List TikTok ad campaigns with optional filtering by name, objective, status. Returns paginated results.
- [Search Interest Categories](https://docs.adside.ai/api-reference/tiktok/search-interest-categories.md): Search TikTok interest categories by keyword for targeting. Returns interest IDs to use in ad group targeting.
- [Search Locations](https://docs.adside.ai/api-reference/tiktok/search-locations.md): Search TikTok targeting locations by keyword. Returns location IDs for use in ad group targeting.
- [Update Ad](https://docs.adside.ai/api-reference/tiktok/update-ad.md): Update a TikTok ad (creative, text, CTA, landing page)
- [Update Ad Group](https://docs.adside.ai/api-reference/tiktok/update-ad-group.md): Update a TikTok ad group (targeting, budget, bid, schedule)
- [Update Ad Group Status](https://docs.adside.ai/api-reference/tiktok/update-ad-group-status.md): Batch enable, disable, or delete TikTok ad groups
- [Update Ad Status](https://docs.adside.ai/api-reference/tiktok/update-ad-status.md): Batch enable, disable, or delete TikTok ads
- [Update Campaign](https://docs.adside.ai/api-reference/tiktok/update-campaign.md): Update a TikTok ad campaign (name, budget, status)
- [Update Campaign Status](https://docs.adside.ai/api-reference/tiktok/update-campaign-status.md): Batch enable, disable, or delete TikTok campaigns
- [Upload Image](https://docs.adside.ai/api-reference/tiktok/upload-image.md): Upload an image to TikTok for use in ad creatives (from URL)
- [Upload Video](https://docs.adside.ai/api-reference/tiktok/upload-video.md): Upload a video to TikTok for use in ad creatives (from URL). Video processing may take a few minutes.
- [Authentication](https://docs.adside.ai/authentication.md): How API key authentication works
- [Error Handling](https://docs.adside.ai/error-handling.md): Error codes, classes, and resolution guidance
- [Getting Started](https://docs.adside.ai/getting-started.md): Set up your API key and make your first MCP tool call
- [Introduction](https://docs.adside.ai/introduction.md): Adside.ai — Unified API for managing ad campaigns across Meta, LinkedIn, and Google
- [MCP Protocol](https://docs.adside.ai/mcp-protocol.md): How JSON-RPC 2.0 and the Model Context Protocol work in this API
- [Rate Limits](https://docs.adside.ai/rate-limits.md): Per-account scoring model and retry strategies
- [Google](https://docs.adside.ai/sources/google.md): Google Sheets/Drive REST endpoints and Google Ads MCP tools
- [LinkedIn](https://docs.adside.ai/sources/linkedin.md): LinkedIn Ads API integration — RestLi protocol
- [Meta](https://docs.adside.ai/sources/meta.md): Meta Ads API integration — Graph API v23.0

## OpenAPI Specs

- [openapi](https://docs.adside.ai/api-reference/openapi.yaml)