Please tell me Ads API limit


#1

Hi

We are developing ads management tool with following endpoints:

https://ads-api.twitter.com/4/accounts/:account_id/media_library
https://ads-api.twitter.com/4/accounts/:account_id/tweet
https://ads-api.twitter.com/4/accounts/:account_id/scheduled_tweets
https://ads-api.twitter.com/4/accounts/:account_id/cards/website
https://ads-api.twitter.com/4/accounts/:account_id/cards/video_website
https://ads-api.twitter.com/4/accounts/:account_id/promoted_tweets

In this case, can we access all these endpoints up to 300 per 1 minute?

EX:
18ce54uldah/media_library …50
18ce54uldah/tweet …50
18ce54kld5c/scheduled_tweets …50
18ce54uldah/cards/website …50
18ce54kld5c/cards/video_website …50
18ce54uldah/promoted_tweets … 50

  • we will access some ads accounts using “multiple user login”.

We are sorry that we can’t understand the definition of “the given category”, so please tell us.

Thank you.


下記のエンドポイントを利用して広告ツールを作成しようとしています。

https://ads-api.twitter.com/4/accounts/:account_id/media_library
https://ads-api.twitter.com/4/accounts/:account_id/tweet
https://ads-api.twitter.com/4/accounts/:account_id/scheduled_tweets
https://ads-api.twitter.com/4/accounts/:account_id/cards/website
https://ads-api.twitter.com/4/accounts/:account_id/cards/video_website
https://ads-api.twitter.com/4/accounts/:account_id/promoted_tweets

この場合、これらすべてのエンドポイント併せて1分間あたり最大300までアクセス可能という認識で在っていますでしょうか?
例えば下記のような形です。

EX:
18ce54uldah/media_library …50
18ce54uldah/tweet …50
18ce54kld5c/scheduled_tweets …50
18ce54uldah/cards/website …50
18ce54kld5c/cards/video_website …50
18ce54uldah/promoted_tweets … 50

※マルチユーザーログインによって複数広告アカウントを連携予定です

We are sorry that we can’t understand the definition of “the given category”, so please tell us.
ドキュメントを読んでいて、"the given category"の定義がわからず、質問させていただきました。
初歩的な質問で恐縮ですが、よろしくお願いいたします。


#2

@dsds11843942

rate limit については、GET なのかそれ以外なのか (read or write) で 値が変わってきます。
300は書き込みの場合ですが、その場合は1分間あたり300回まで(各Categoryごとに)で合っています。

Categoryに関しては、ドキュメント上での各エンドポイントが分類されるCategoryとなります。(Analytics, Audiences, Campaign Management, Creatives, Measurement などの)

前田


#3

ご教示ありがとうございます。

今回の場合、下記のように制限がかかる認識であっていますでしょうか?

【カテゴリ:“Creatives”】
POST https://ads-api.twitter.com/4/accounts/:account_id/media_library
POST https://ads-api.twitter.com/4/accounts/:account_id/cards/website
POST https://ads-api.twitter.com/4/accounts/:account_id/cards/video_website
POSTなので、このカテゴリに属するこれらのAPI3種のエンドポイント併せて、1分あたり300まで

【カテゴリ”Campaign Management”】
POST https://ads-api.twitter.com/4/accounts/:account_id/tweet
POST https://ads-api.twitter.com/4/accounts/:account_id/promoted_tweets
POSTなので、このカテゴリに属するこの2種類のエンドポイントで併せて、1分あたり300まで

【カテゴリ”Campaign Management”】
GET https://ads-api.twitter.com/4/accounts/:account_id/scheduled_tweets
GETなので、「Account Reads (GET endpoints with :account_id)」に分類され、
この1種類のエンドポイントについて、15分あたり2000まで

また、五月雨の質問となり恐縮ですが、
レポートについては、下記の認識で合っていますでしょうか?

【カテゴリ"Analytics"】
GET https://ads-api.twitter.com/4/stats/accounts/:account_id/
1回あたり20件までしか取得できないため、
1回あたり20件まで×250= 5000件/15分
取得可能

よろしくお願いいたします。


#4

@dsds11843942

はい、そのような理解で問題ないと思います。
実際の利用に際して問題があるようでしたらご連絡ください。

以上、よろしくお願いいたします。

前田


#5

丁寧にご説明いただきありがとうございました。

また何かございましたら質問させて頂きます。

よろしくお願いいたします。