Questions About API Rate Limits and UTM-Level Reporting

[Lidija Tomanic]

Hello,

I’m using the following API endpoint to monitor Outbrain performance data per state on a daily basis:
https://api.outbrain.com/amplify/v0.1/reports/marketers/{{ config['marketer_id'] }}/campaigns/geo?breakdown=region&limit=500&from=2025-05-01&to=2025-05-01

I’m performing an incremental daily sync to retrieve data for each day. However, I’m frequently hitting rate limits, so I’ve implemented the following error handling:

type: CompositeErrorHandler

error_handlers:

  - type: DefaultErrorHandler

    backoff_strategies:

      - type: WaitTimeFromHeader

        unit: milliseconds

        regex: \d+

        header: rate-limit-msec-left

    handle_on_status_codes:

      - 429

The issue is that with this setup, the data retrieval process is extremely slow — it takes about 24 hours to fetch roughly 400 records.

Is there any recommended way to speed this up (e.g., by optimizing requests, adjusting limits, or using a different endpoint)?

Additionally, I have a question about UTM parameters.
Is there any way to retrieve ad group and content-level spend data on a daily basis through the API?

Thank you in advance for your help.

[Ales Kesar Valenko]

Hi Lidija, 

Thank you for reaching out to the API support team. 

For the first API call that you mention in your email, I'd suggest decreasing the limit to perhaps 250 or 100 items in one call, and also using offset to get all of the data. The default offset is 10 items per page. If you encounter any issues here, please let me know. 

For the second question, I'd suggest using the endpoint here for the performance, including spend, on the campaign level and endpoint here to check the performance, including spend, on the ad level. The default value of the periodic breakdown is daily, so you'll just need to define the date for which you wish to obtain the data. 

In case of additional questions, please let me know. 

Best regards, 

Aleš 

On Thu, Oct 30, 2025 at 4:46 PM Lidija Tomanic <lid...@earthfuneral.com> wrote:

Teads couldn't recognize this email as this is the first time you received an email from this sender lidija @ earthfuneral.com

--
You received this message because you are subscribed to the Google Groups "Outbrain-AmplifyApi" group.
To unsubscribe from this group and stop receiving emails from it, send an email to outbrain-amplif...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/outbrain-amplifyapi/e624f12d-8070-4f84-9e0a-95e77c84aa9cn%40googlegroups.com.

--

Ales Kesar Valenko Demand Technical Solutions Team Lead e | ales.kes...@teads.com

The information in this email is confidential and intended only for the addressee(s) named above. If you are not the intended recipient, any disclosure, copying, distribution, or any action taken or omitted to be taken in reliance on it is prohibited and may be unlawful. Teads does not warrant that any attachment(s) are free from viruses or other defects and accepts no liability for any losses resulting from infected email transmission. Please note that any views expressed in this email may be those of the originator and do not necessarily reflect those of the organization. For more information or feedback, contact us here.

[Lidija Tomanic]

Hi Aleš,

Thank you for your response and the detailed suggestions.

I’ll try adjusting the limit as you recommended and use the offset parameter to retrieve the full dataset.

Regarding the endpoints you mentioned, unfortunately, they don’t fully cover our use case. We’re tracking spend on the UTM level, as we monitor UTM parameters on our end and want to see how many of these tracked events each ad results in spend. For this, we’d need an API that allows us to track daily spend data for both content and ad groups.

Could you please advise if there’s an endpoint that provides spend information at that level of granularity?

Best regards,
Lidija

Lidija Tomanic Data Developer, Earth Funeral www.earthfuneral.com | lid...@earthfuneral.com

[Ales Kesar Valenko]

Hi Lidija,

Thank you for the clarification. 

To obtain UTM tracking spend and info in reporting, we don't have an option in our API.  

Also just to clarify if we're speaking about the same thing - you're mentioning adgroups, which is an entity in the Outbrain DSP (a different product, API available here). 

But if you need info and data for Amplify, then what we discussed in this and previous emails applies. 

In case of additional questions, please let me know. 

Best regards, 

Aleš