X-rate-limit in response headers

[BrianMCzako]

I’m in the process of updating my company’s calls to the Twitter Ads API from version 3 to version 4.
As part of this, I’m updating our integration tests to validate the endpoints process requests correctly, and have determined that I’m getting rate limited on every request with my account.

My request looks like:

POST to https://ads-api.twitter.com/3/tailored_audience_memberships

Source JSON:

[{
“operation_type”: “Update”,
“params”: {
“advertiser_account_id”: “:accountId”,
“membership_type”: “LIST_MEMBERSHIP”,
“user_identifier”: “f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a”,
“user_identifier_type”: “EMAIL”,
“score”: 100,
“audience_names”: “:audienceName”,
“effective_at”: “2018-12-05T21:05:21Z”
}
}, {
“operation_type”: “Update”,
“params”: {
“advertiser_account_id”: “:accountId”,
“membership_type”: “LIST_MEMBERSHIP”,
“user_identifier”: “31611159e7e6ff7843ea4627745e89225fc866621cfcfdbd40871af4413747cc”,
“user_identifier_type”: “HANDLE”,
“score”: 100,
“audience_names”: “:audienceName”,
“effective_at”: “2018-12-05T21:05:21Z”
}
}, {
“operation_type”: “Update”,
“params”: {
“advertiser_account_id”: “:accountId”,
“membership_type”: “LIST_MEMBERSHIP”,
“user_identifier”: “bbaf670d8020f6e111d507df3e8a6a847a54bf3308ce4a8c7542771d2b23b094”,
“user_identifier_type”: “DEVICE_ID”,
“score”: 100,
“audience_names”: “:audienceName”,
“effective_at”: “2018-12-05T21:05:21Z”
}
}]

With the values of :accountId and :audienceName matching the actual request.

Response:
{“request”:{“params”:{“version_number”:“3”}},“errors”:[{“code”:“TOO_MANY_REQUESTS”,“message”:“Too many requests”}]}

Status code: 429
From response headers, I have:
[x-rate-limit-limit, 0]
[x-rate-limit-remaining, 0]

It appears I am limited to sending 0 requests.
Can I get this updated?

[jrsyo]

@BrianMCzako

This endpoint has been deprecated and will no longer be available as of 2019-02-28. You can use v4
Audience API Integration instead.

For rate-limiting, please read this.

I am getting rate limited all the time, what am I doing wrong? Can my rate limits be elevated?

You should read and get familiar with Twitter’s Ads API Rate Limiting; all relevant limits are documented there. It is worth noting that limits are also communicated in the HTTP response headers (X-Rate-Limit-Limit, X-Rate-Limit-Remaining and X-Rate-Limit-Reset), so you should make use of this information when making requests; if there is no X-Rate-Limit-Remaining, then you should make use of the value provided by X-Rate-Limit-Reset to figure out when you are okay to send a request again and av…

Also, please provide us your Ads account ID at least when you ask questions.

What information do I need to provide in order to get help on the forums as quickly as possible?

You should read our Guidelines for Reporting Issues, it’s a good starting point to understand what kind of information you can provide us with so we can help you as quickly as possible. Pay particular attention to the Ads API Sensitive Information section of those guidelines to avoid revealing any confidential information from advertisers, clients, or your company.

Best,
Shohei

[BrianMCzako]

Thanks, I’m fully aware that the endpoint is being deprecated.
My original note says this “We are in the process to updating our software to use version 4.”
I need to make sure that my code works until we make this migration.

I intentionally did not provide my ads account ID for 2 reasons:

• this is a public forum, and I don’t want this made public - our company takes anything with even a hint of an account ID very seriously
• I figured that was something that could be looked up by you

If you’re asking then this ID isn’t as protected as I expect, so here it is: 18ce53worc8

The “rate limiting” article is no help because this is the only API call I’m making.
Here are 2 other values in the HTTP response:
[Date, Wed, 05 Dec 2018 21:06:07 GMT]
[x-rate-limit-reset, 1544044027]

The ‘rate limit reset’ value corresponds to one minute after the date value.
The response indicates I have effectively a limit of zero requests.

[jrsyo]

@BrianMCzako Thank you. Providing your account ID here is safe.

You said, both x-rate-limit-limit and x-rate-limit-remaining returned “0”, correct? It shouldn’t be 0 at least for x-rate-limit-limit header though. only on v3? or on v4 as well?

Also, you’re using user context OAuth authentication rather than Application-only authentication, correct?

Best,
Shohei

[BrianMCzako]

Yes, they’re both “0” on v3. That is not a typo.
I’m still working on the v4 payload.

My authentication is using the methodology defined here
https://developer.twitter.com/en/docs/basics/authentication/guides/creating-a-signature.html

[jrsyo]

@BrianMCzako The best way to debug these kind of situation is to use twurl and see if you can reproduce even with this tool or not. Then, we can identify and isolate the issue more clearly.

twurl -X POST -t -H 'ads-api.twitter.com' '/3/tailored_audience_memberships' -d 'json_string'

This will show you all response header. Can you try and provide us your output (response headers)?

Best,
Shohei

[BrianMCzako]

It looks very much the same as when I did it in code. But here you go:

-> “HTTP/1.1 429 Too Many Requests\r\n”
-> “connection: close\r\n”
-> “content-disposition: attachment; filename=json.json\r\n”
-> “content-encoding: gzip\r\n”
-> “content-length: 345\r\n”
-> “content-type: application/json;charset=utf-8\r\n”
-> “date: Fri, 07 Dec 2018 16:39:40 GMT\r\n”
-> “server: tsa_b\r\n”
-> “set-cookie: personalization_id=“v1_xIfM40JYwE16kl+s2ZN0KQ==”; Max-Age=63072000; Expires=Sun, 6 Dec 2020 16:39:40 GMT; Path=/; Domain=.twitter.com\r\n”
-> “set-cookie: guest_id=v1%3A154420078032426066; Max-Age=63072000; Expires=Sun, 6 Dec 2020 16:39:40 GMT; Path=/; Domain=.twitter.com\r\n”
-> “strict-transport-security: max-age=631138519\r\n”
-> “x-connection-hash: 74fb42b0d68567bb95bfb3500604aa91\r\n”
-> “x-content-type-options: nosniff\r\n”
-> “x-frame-options: SAMEORIGIN\r\n”
-> “x-rate-limit-limit: 0\r\n”
-> “x-rate-limit-remaining: 0\r\n”
-> “x-rate-limit-reset: 1544200840\r\n”
-> “x-response-time: 14\r\n”
-> “x-transaction: 00a05fa900cb7e9f\r\n”
-> “x-tsa-request-body-time: 1\r\n”
-> “x-xss-protection: 1; mode=block; report=https://twitter.com/i/xss_report\r\n”
-> “\r\n”

[jrsyo]

@BrianMCzako ,

Thanks. What’s your App ID that is associated with your API call? It might be possible if your App doesn’t have an appropriate rate-limit profile.

Best,
Shohei

[BrianMCzako]

I’m using credentials for App ID 4344011
I don’t see any way of setting the rate limit profile from the settings, so that’s all on your side of things.
Please let me know.

Thanks!
Brian

[carmenjyuen]

Hi @BrianMCzako - the real time endpoint requires a special agreement to be signed before we whitelist applications for it. Are you trying to compare the payloads? We were supposed to stop whitelisting new apps due to the impending deprecation.
Best,
Carmen

[BrianMCzako]

Hey Carmen - I’m really just trying to make sure the old payload still works in the context of an integration test. I was planning on removing that test once we fully deployed version 4. We’re trying to get into the habit of having simple, reproducible tests that run with QA credentials using Twitter API so we can ensure that any changes we make don’t break anything in production.

If the official Twitter answer is that the rate limit won’t be able to be updated here, I’ll ensure that my tests will accept the 429 as a response, and then we can close this issue.

Brian