Back

Snapchat Ads API Essential Guide

Aug 9, 20246 minute read

What type of API does Snapchat Ads provide?

The search results do not specify the type of API that Snapchat Ads uses. Common API types include REST, GraphQL, SOAP, and RPC, but without consulting Snapchat's official developer documentation, the specific API type used by Snapchat Ads cannot be determined.

Does the Snapchat Ads API have webhooks?

The official Snapchat Ads API does not appear to have native webhook functionality. The search results do not contain any direct information about webhooks specifically for the Snapchat Ads API.

However, there is information about webhooks for other Snapchat-related platforms. The Snaps platform (which seems to be different from Snapchat Ads) has webhook functionality for monitoring events across subscribed channel activity. Additionally, Zapier offers an integration that can create webhook posts when new leads appear in Snapchat Lead Ads.

For the Snapchat Ads API, there are other methods of tracking events and conversions. The Snapchat Conversions API allows advertisers to pass web, app, and offline events directly to Snap, supporting various event types like purchases, add to cart, page views, etc. While not webhooks, the Conversions API does allow real-time event tracking and reporting to Snapchat's systems.

In summary, the official Snapchat Ads API does not seem to have native webhook functionality. Instead, Snapchat offers other methods like the Conversions API for tracking events and reporting data in real-time. If webhook-like functionality is needed, third-party integrations like Zapier may offer workarounds for specific use cases like lead generation.

Rate Limits and other limitations

Based on the search results provided, here is what we know about the API Rate Limits of the Snapchat Ads API:

Rate Limits for Conversions API

For the Conversions API specifically:

  • If you are using long-lived tokens, there is no longer a rate limit to abide by.
  • However, there is still a constraint of 2000 events per batch when sending events through the Conversions API.

Authentication and Tokens

  • Snapchat uses static long-lived tokens for making Conversions API calls.
  • These tokens are generated on the Business Details page of Ads Manager.
  • Long-lived tokens have no expiration date.
  • Multiple long-lived tokens can be generated and used.

Key Points to Consider

  • To access the Snapchat Conversions API, you need an existing business account and acceptance of the Snap Developer Terms and Snap Business Tools Terms.
  • Organization Admin access is required to generate these tokens.
  • Tokens can be removed or invalidated if no longer needed.
  • No OAuth app creation is necessary for creating these tokens.

General API Limits

While the search results don't provide specific information about rate limits for other parts of the Snapchat Ads API, it's worth noting that:

  • One user reported receiving a "too many requests" error after about 2 minutes of use when querying campaign stats.
  • The user mentioned that the x-rate-limit-reset header value was always 0, which didn't provide clear information about the limit.

Best Practices

  1. Use long-lived tokens for the Conversions API to avoid rate limiting issues.
  2. When sending events through the Conversions API, keep batches to 2000 events or less.
  3. Monitor your API usage and implement appropriate error handling for potential "too many requests" errors.
  4. If you encounter rate limiting issues with other parts of the Snapchat Ads API, contact Snapchat support for specific guidance, as the public documentation may not provide complete information on all rate limits.

It's important to note that the information provided is primarily focused on the Conversions API. For other endpoints or API functionalities, the rate limits may differ, and it would be best to consult Snapchat's official documentation or support for more detailed information.

Latest API Version

Based on the search results provided, I don't have specific information about the most recent version of the Snapchat Ads API. However, I can provide some relevant information about the Snapchat Marketing API:

Availability and Access

The Snapchat Marketing API is now open to everyone [4]. Here are some key points:

  • It's available to any developer (agency, brand, technology vendor, or individual) interested in building ad solutions for the Snapchat platform [4].
  • There are no longer restrictions on the minimum size and scope of what a developer must build to maintain access to the platform [4].
  • To access the API, you need an existing business account and must accept the Snap Developer Terms and Snap Business Tools Terms [4].

How to Get Access

To activate access to Snapchat's Marketing API:

  1. Log in to Ads Manager
  2. Click the menu in the top left corner and select Business Dashboard, then select Business Details
  3. Click +OAuth App
  4. Agree to the terms and conditions to activate access
  5. Click Save [2]

Functionality

The API may be useful for businesses interested in building specific advertising use cases not available through Ads Manager [4]. However, some functionalities are not available through the API, including:

  • Organic Snap management
  • Organic Snap analytics
  • Ability to buy or report on reserved buys [4]

Additional Information

  • Snapchat's Conversions API is also now available to advertisers [4].
  • Businesses can access the API in any country where Ads Manager sign-up is currently supported [4].
  • For Marketing API related questions, you can contact Snapchat's support center. For Conversions API questions, reach out to your Snap sales representative [4].

While this information doesn't directly answer the question about the most recent version of the Snapchat Ads API, it provides an overview of the current state of the Snapchat Marketing API, which is likely closely related to the Ads API.

How to get a Snapchat Ads developer account and API Keys?

To get a developer account for Snapchat Ads and create an API integration, you need to follow these steps:

1. Set up a Business Account

First, you need to have an existing Snapchat business account. This is a prerequisite for accessing the Snapchat Marketing API.

2. Accept Terms and Conditions

You must accept the Snap Developer Terms and the Snap Business Tools Terms. These agreements outline the rules and regulations for using Snapchat's API.

3. Activate Access to the Marketing API

To activate access to Snapchat's Conversions API, follow these steps:

  • Log in to Ads Manager
  • Click the menu in the top corner and select "Business Details"
  • Under the OAuth App section, find the "Conversions API Tokens" section
  • Click on the "Generate Token" button to create a new token
  • Copy the generated token for use in API calls

4. Implement the Business SDK

Before beginning the Conversions API (CAPI) installation process, it's recommended to implement Snapchat's Business SDK. This SDK simplifies integration by providing:

  • A dedicated CAPI client
  • Hashing libraries
  • Code examples

The Business SDK is available in multiple languages, including Go, Java, PHP, Python, and Ruby.

5. Review API Documentation

Visit the Marketing API page for a full list of required and recommended parameters. This will help you understand how to structure your API requests and what data you need to include.

What can you do with the Snapchat Ads API?

Based on the search results provided, I can offer information about the data models you can interact with using the Snapchat Ads API. Here's a list of bullet points covering what is possible for each data model:

Snapchat Marketing API

• The Snapchat Marketing API is available to any developer (agency, brand, technology vendor, or individual) interested in building ad solutions for the platform.

• It allows interaction with various advertising-related data models, including:

  • Campaign management
  • Ad creation and management
  • Audience targeting
  • Performance reporting

• The API does not support:

  • Organic Snap management
  • Organic Snap analytics
  • Ability to buy or report on reserved buys

Conversions API

• Snapchat's Conversions API is available to advertisers.

• It allows for:

  • Attribution and measurement of conversions

Data Models (Fivetran)

Fivetran offers two dbt Core-compatible data models for Snapchat Ads:

  1. Source Model: • Exposes, documents, and standardizes the underlying Fivetran schemas created in the destination • Provides access to raw Snapchat Ads data

  2. Transform Model: • Produces analytics-ready models for each source • Allows for customized data transformations and analysis

Key Points to Consider

• Access to the Snapchat Marketing API requires:

  • An existing business account
  • Acceptance of the Snap Developer Terms and Snap Business Tools Terms

• The API is available in countries where Ads Manager sign-up is supported.

• While the search results don't provide exhaustive details on all possible data models, they suggest that the Snapchat Ads API allows interaction with common advertising-related data such as campaigns, ads, audiences, and performance metrics.

• For more specific information on available data models and their capabilities, it would be best to consult the official Snapchat Ads API documentation or reach out to Snapchat's support team.