{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Rate limits","description":"Guides and API reference for the DataSift (REISift) Core API and SiftMap API."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"rate-limits","__idx":0},"children":["Rate limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Rate limits apply to all Open API key usage and are enforced, not guidance."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-limits","__idx":1},"children":["Request limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Limits are enforced per account. Account and record operations and SiftMap requests each have an independent counter:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["| Request type | Limit |"," ","|---|---|---|"," ","| Account and record operations | ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["120 requests/minute and 5,000 requests/hour"]}," |"," ","| SiftMap search and map filters | ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["120 requests/minute and 5,000 requests/hour"]}," |"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Requests in one group do not use the other group's capacity."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sustained-vs-burst-rate","__idx":2},"children":["Sustained vs. burst rate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Within each request group, the two caps interact: sustaining the full 120 requests per minute for a whole hour would total 7,200 requests, which exceeds the 5,000-per-hour cap. A process that runs continuously should target an average pace of roughly ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["80-85 requests per minute"]}," (5,000 / 60), reserving the 120-per-minute headroom for short bursts."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If you are building an agentic tool or automated process, build in delays between requests"]}," so your sustained throughput stays within the applicable limits, rather than firing requests as fast as possible and relying on retries after a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429"]},". These limits are enough to build a fairly complex, multi-step workflow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-you-exceed-a-limit","__idx":3},"children":["When you exceed a limit"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When either the per-minute or per-hour limit is exceeded, the API responds with:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"HTTP 429\nRequest was throttled. Expected available in X seconds.\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your client should recognize a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429"]},", wait the number of seconds in the message (or in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Retry-After"]}," header, when present), and retry. This is baseline expected client behavior, not an edge case."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"import re, time, requests\n\ndef get_with_backoff(url, headers, **kwargs):\n    while True:\n        r = requests.get(url, headers=headers, timeout=30, **kwargs)\n        if r.status_code != 429:\n            return r\n        m = re.search(r\"(\\d+)\\s*seconds\", r.text)\n        time.sleep(int(m.group(1)) + 1 if m else 30)\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DataSift also reviews API usage regularly, independent of the automated ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429"]}," response, and expects fair use; see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/acceptable-use"},"children":["Acceptable use"]},". For bulk jobs (imports, skip tracing, exports), also follow the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/bulk-operations"},"children":["Bulk operations"]}," limits. Limits may be adjusted as usage patterns evolve; changes are announced in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/changelog"},"children":["changelog"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"need-more","__idx":4},"children":["Need more?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If 120 requests/minute or 5,000 requests/hour isn't enough for your process, contact us - we're open to reconsidering these limits based on real use cases."]}]},"headings":[{"value":"Rate limits","id":"rate-limits","depth":1},{"value":"Request limits","id":"request-limits","depth":2},{"value":"Sustained vs. burst rate","id":"sustained-vs-burst-rate","depth":2},{"value":"When you exceed a limit","id":"when-you-exceed-a-limit","depth":2},{"value":"Need more?","id":"need-more","depth":2}],"frontmatter":{"seo":{"title":"Rate limits"}},"lastModified":"2026-10-30T09:27:33.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/rate-limits","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}