{"article":{"id":115015933428,"url":"https://upwork.zendesk.com/api/v2/help_center/en-us/articles/115015933428.json","html_url":"https://support.upwork.com/hc/en-us/articles/115015933428-What-are-the-API-requests-limits","author_id":1503969378382,"comments_disabled":true,"draft":false,"promoted":false,"position":0,"vote_sum":-24,"vote_count":108,"upvote_count":42,"downvote_count":66,"section_id":115004138927,"created_at":"2017-12-22T04:00:02Z","updated_at":"2026-10-17T15:45:23Z","name":"What are the API requests limits?","title":"What are the API requests limits?","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2025-11-18T19:38:35Z","user_segment_id":null,"permission_group_id":9713219939859,"content_tag_ids":[],"label_names":["API","filter-cl","filter-fl","filter-api"],"body":"<p><em>Learn about Upwork API rate limits — 10 requests per second per IP — and get tips to prevent 429 errors using caching, throttling, and efficient API calls.</em></p><hr><div class=\"article-body\">\n<h2 id=\"h_01KAC3KYV36NRCN3XTJTY6C524\">In this article</h2>\n<ul>\n<li data-list-item-id=\"ed65d509e44f4e22f02936dcc4584f60a\"><a href=\"#what-are-the-api-request-limits\">What are the API request limits on Upwork?</a></li>\n<li data-list-item-id=\"ecf900bd09340a1b5ae51fb0a57f1858c\"><a href=\"#how-can-i-avoid-hitting-the-rate-limit\">How can I avoid hitting the rate limit?</a></li>\n</ul>\n<h2 id=\"what-are-the-api-request-limits\"> </h2>\n<h2 id=\"h_01KAC7KP88XDQE8PYPT28DDDE9\">What are the API request limits on Upwork?</h2>\n<p>The API allows up to 10 requests per second per IP address. If your app goes over that limit, you’ll get an HTTP 429 “Too Many Requests” error.</p>\n<p>Keep in mind:</p>\n<ul>\n<li data-list-item-id=\"ea5431632770881b483d459fb4365bce4\">Rate limits are enforced per IP, not per user or application</li>\n<li data-list-item-id=\"e69b76dcd3d358063e116f0420684bbc1\">Caching API responses for more than 24 hours is not allowed under Upwork’s <a href=\"http://upwork.com/legal\">Terms of Service</a>\n</li>\n</ul>\n<h2 id=\"how-can-i-avoid-hitting-the-rate-limit\"> </h2>\n<h2 id=\"h_01KAC7KP88P709G393RAFPXKT7\">How can I avoid hitting the rate limit?</h2>\n<p>To keep your integration running smoothly:</p>\n<ul>\n<li data-list-item-id=\"ec3612b5ed17a383a7cbc44067adb6c6f\">\n<strong>Use caching wisely:</strong> If your app shows the same data often (like user profiles or job listings), store it locally for up to 24 hours</li>\n<li data-list-item-id=\"e7a88641742f96ed4b2e14b6a6930cf72\">\n<strong>Avoid calling the API on every page load:</strong> Instead, call it once, cache the results, and serve that to your users</li>\n<li data-list-item-id=\"e2180bce6abf2d47535d4cb699bcbb479\">\n<strong>Throttle requests if needed:</strong> Adding a short delay between requests can help if you’re approaching the 10-per-second limit</li>\n</ul>\n<h2 id=\"what-happens-if-i-go-over-the-limit\"> </h2>\n</div>","user_segment_ids":[]}}