[{"data":1,"prerenderedAt":649},["ShallowReactive",2],{"navLinks":3,"sidebar_docs_navigation_\u002Fdocs\u002Fcredits-and-auth":124,"navigation":169,"navLinks_footer":186,"\u002Fdocs\u002Fcredits-and-auth\u002Frate-limits_page":216,"\u002Fdocs\u002Fcredits-and-auth\u002Frate-limits_surround":482,"\u002Fdocs\u002Fcredits-and-auth\u002Frate-limits":485},{"id":4,"extension":5,"links":6,"meta":121,"stem":122,"__hash__":123},"navigationMenu\u002Fnavigation.json","json",[7,57,62,103],{"label":8,"icon":9,"nested":10,"children":11},"API Products","i-lucide-box",true,[12,17,22,27,32,37,42,47,52],{"label":13,"to":14,"description":15,"icon":16},"Full IP Lookup","\u002Ffull-ip-lookup","Enrich any IP with complete intelligence","i-lucide-globe",{"label":18,"to":19,"description":20,"icon":21},"Proxy & VPN Detection","\u002Fproxy-vpn-detection","Identify proxies and VPN networks","i-lucide-shield-alert",{"label":23,"to":24,"description":25,"icon":26},"Tor Exit Nodes","\u002Ftor-exit-nodes","Block Tor anonymity network traffic","i-lucide-eye-off",{"label":28,"to":29,"description":30,"icon":31},"Granular Geolocation","\u002Fgranular-geolocation","Highly accurate location mapping","i-lucide-map-pin",{"label":33,"to":34,"description":35,"icon":36},"Threat Scoring System","\u002Fthreat-scoring-system","Unified traffic risk score","i-lucide-activity",{"label":38,"to":39,"description":40,"icon":41},"ASN & Carrier Data","\u002Fasn-carrier-data","Identify autonomous systems","i-lucide-server",{"label":43,"to":44,"description":45,"icon":46},"Disposable Email Check","\u002Fdisposable-email-check","Detect temporary email domains","i-lucide-mail",{"label":48,"to":49,"description":50,"icon":51},"User Agent Parser","\u002Fuser-agent-bot-parser","Parse messy HTTP headers","i-lucide-bot",{"label":53,"to":54,"description":55,"icon":56},"Verified Bots","\u002Fverified-bots-crawlers","Identify legitimate search engine crawlers","i-lucide-check-circle",{"label":58,"to":59,"icon":60,"nested":61},"Pricing","\u002Fpricing","i-lucide-credit-card",false,{"label":63,"to":64,"icon":65,"nested":10,"children":66},"Docs","\u002Fdocs","i-lucide-book-open",[67,71,76,81,86,91,95,98],{"label":68,"to":64,"description":69,"icon":70},"Getting Started","Learn how to setup and use IP Shield","i-lucide-rocket",{"label":72,"to":73,"description":74,"icon":75},"All Endpoints","\u002Fdocs\u002Fendpoints\u002Femail-domain-check","Reference for all IP Shield REST API endpoints","i-lucide-plug",{"label":77,"to":78,"description":79,"icon":80},"Network API","\u002Fdocs\u002Fendpoints\u002Fnetwork","Network intelligence and routing data","i-lucide-network",{"label":82,"to":83,"description":84,"icon":85},"Summary API","\u002Fdocs\u002Fendpoints\u002Fsummary","Full IP intelligence summary","i-lucide-bar-chart-2",{"label":87,"to":88,"description":89,"icon":90},"Lookup IP API","\u002Fdocs\u002Fendpoints\u002Flookup-ip","Single IP data lookup","i-lucide-search",{"label":92,"to":93,"description":94,"icon":31},"Geo Check API","\u002Fdocs\u002Fendpoints\u002Fgeo-check","Check geographic location",{"label":96,"to":73,"description":97,"icon":46},"Email Domain Check API","Verify disposable email domains",{"label":99,"to":100,"description":101,"icon":102},"User Agent Check API","\u002Fdocs\u002Fendpoints\u002Fuser-agent-check","Detect malicious user agents","i-lucide-monitor",{"label":104,"icon":105,"nested":10,"children":106},"Resources","i-lucide-library",[107,112,117],{"label":108,"to":109,"icon":110,"description":111},"About Us","\u002Fabout","i-lucide-info","Learn more about IP Shield and our mission",{"label":113,"to":114,"icon":115,"description":116},"Blog","\u002Fblog","i-lucide-newspaper","Latest news, updates, and security articles",{"label":118,"to":119,"description":120,"icon":46},"Contact Us","\u002Fcontact","Get in touch with our support team",{},"navigation","OH-Zj4UmYqVQJC8Ts6f4KeKRzXJYi5trdK22JpX9Y0Q",[125],{"title":63,"path":64,"stem":126,"children":127},"docs",[128,131,152],{"title":129,"path":64,"stem":130,"icon":110},"Introduction","docs\u002Findex",{"title":132,"icon":133,"path":134,"stem":135,"children":136,"page":61},"Credit & Authorization","i-lucide-key","\u002Fdocs\u002Fcredits-and-auth","docs\u002Fcredits-and-auth",[137,142,147],{"title":138,"path":139,"stem":140,"icon":141},"Authentication","\u002Fdocs\u002Fcredits-and-auth\u002Fauth","docs\u002Fcredits-and-auth\u002Fauth","i-lucide-shield-check",{"title":143,"path":144,"stem":145,"icon":146},"Credits & Usage","\u002Fdocs\u002Fcredits-and-auth\u002Fcredits-usage","docs\u002Fcredits-and-auth\u002Fcredits-usage","i-lucide-coins",{"title":148,"path":149,"stem":150,"icon":151},"Rate Limits","\u002Fdocs\u002Fcredits-and-auth\u002Frate-limits","docs\u002Fcredits-and-auth\u002Frate-limits","i-lucide-gauge",{"title":153,"icon":75,"path":154,"stem":155,"children":156,"page":61},"API Endpoints","\u002Fdocs\u002Fendpoints","docs\u002Fendpoints",[157,159,161,163,165,167],{"title":96,"path":73,"stem":158,"icon":46},"docs\u002Fendpoints\u002Femail-domain-check",{"title":92,"path":93,"stem":160,"icon":31},"docs\u002Fendpoints\u002Fgeo-check",{"title":87,"path":88,"stem":162,"icon":90},"docs\u002Fendpoints\u002Flookup-ip",{"title":77,"path":78,"stem":164,"icon":80},"docs\u002Fendpoints\u002Fnetwork",{"title":82,"path":83,"stem":166,"icon":85},"docs\u002Fendpoints\u002Fsummary",{"title":99,"path":100,"stem":168,"icon":102},"docs\u002Fendpoints\u002Fuser-agent-check",[170],{"title":63,"path":64,"stem":126,"children":171},[172,173,178],{"title":129,"path":64,"stem":130},{"title":132,"path":134,"stem":135,"children":174,"page":61},[175,176,177],{"title":138,"path":139,"stem":140},{"title":143,"path":144,"stem":145},{"title":148,"path":149,"stem":150},{"title":153,"path":154,"stem":155,"children":179,"page":61},[180,181,182,183,184,185],{"title":96,"path":73,"stem":158},{"title":92,"path":93,"stem":160},{"title":87,"path":88,"stem":162},{"title":77,"path":78,"stem":164},{"title":82,"path":83,"stem":166},{"title":99,"path":100,"stem":168},{"id":4,"extension":5,"links":187,"meta":215,"stem":122,"__hash__":123},[188,199,200,210],{"label":8,"icon":9,"nested":10,"children":189},[190,191,192,193,194,195,196,197,198],{"label":13,"to":14,"description":15,"icon":16},{"label":18,"to":19,"description":20,"icon":21},{"label":23,"to":24,"description":25,"icon":26},{"label":28,"to":29,"description":30,"icon":31},{"label":33,"to":34,"description":35,"icon":36},{"label":38,"to":39,"description":40,"icon":41},{"label":43,"to":44,"description":45,"icon":46},{"label":48,"to":49,"description":50,"icon":51},{"label":53,"to":54,"description":55,"icon":56},{"label":58,"to":59,"icon":60,"nested":61},{"label":63,"to":64,"icon":65,"nested":10,"children":201},[202,203,204,205,206,207,208,209],{"label":68,"to":64,"description":69,"icon":70},{"label":72,"to":73,"description":74,"icon":75},{"label":77,"to":78,"description":79,"icon":80},{"label":82,"to":83,"description":84,"icon":85},{"label":87,"to":88,"description":89,"icon":90},{"label":92,"to":93,"description":94,"icon":31},{"label":96,"to":73,"description":97,"icon":46},{"label":99,"to":100,"description":101,"icon":102},{"label":104,"icon":105,"nested":10,"children":211},[212,213,214],{"label":108,"to":109,"icon":110,"description":111},{"label":113,"to":114,"icon":115,"description":116},{"label":118,"to":119,"description":120,"icon":46},{},{"id":217,"title":148,"body":218,"description":475,"extension":476,"icon":151,"meta":477,"module":478,"navigation":10,"path":149,"rawbody":479,"seo":480,"stem":150,"__hash__":481},"docs\u002Fdocs\u002Fcredits-and-auth\u002Frate-limits.md",{"type":219,"value":220,"toc":470},"minimark",[221,225,233,244,247,252,259,263,271,278,419,428,432,439,445,458,466],[222,223,224],"p",{},"To ensure fast response times for all users and protect against abuse, IP Shield enforces rate limits.",[222,226,227,228,232],{},"These rate limits are measured in requests ",[229,230,231],"strong",{},"per second",", operate independently of your monthly credit quota, and increase based on your subscription plan.",[234,235,236],"note",{},[222,237,238,239,243],{},"If you require more usage, even if premium plans are not yet published, please ",[240,241,242],"a",{"href":119},"reach out"," to us.",[245,246],"hr",{},[248,249,251],"h2",{"id":250},"request-limits","Request Limits",[222,253,254,255,258],{},"When using your API key, you are allowed up to ",[229,256,257],{},"50 requests per second"," in the free plan. This limit applies across all endpoints tied to your account.",[248,260,262],{"id":261},"handling-rate-limits","Handling Rate Limits",[222,264,265,266,270],{},"If you send too many requests too quickly, the API will reject the request and return a ",[267,268,269],"code",{},"429 Too Many Requests"," status code.",[222,272,273,274,277],{},"The response will include a ",[267,275,276],{},"Retry-After"," header, which tells you exactly how many seconds you must wait before trying again, along with a JSON message:",[279,280,285],"pre",{"className":281,"code":282,"language":283,"meta":284,"style":284},"language-http shiki shiki-themes light-plus light-plus dracula","HTTP\u002F1.1 429 Too Many Requests\nRetry-After: 1\nContent-Type: application\u002Fjson\n\n{\n  \"ok\": false,\n  \"date\": \"2024-03-24T12:00:00.000Z\",\n  \"reason\": \"Too many requests. 50 reqs\u002Fsecond allowed\"\n}\n","http","",[267,286,287,311,323,334,340,346,370,393,413],{"__ignoreMap":284},[288,289,292,296,300,304,307],"span",{"class":290,"line":291},"line",1,[288,293,295],{"class":294},"sl46w","HTTP",[288,297,299],{"class":298},"sDd4n","\u002F",[288,301,303],{"class":302},"spgvN","1.1",[288,305,306],{"class":302}," 429",[288,308,310],{"class":309},"sFB1V"," Too Many Requests\n",[288,312,314,317,320],{"class":290,"line":313},2,[288,315,276],{"class":316},"scd-l",[288,318,319],{"class":294},":",[288,321,322],{"class":309}," 1\n",[288,324,326,329,331],{"class":290,"line":325},3,[288,327,328],{"class":316},"Content-Type",[288,330,319],{"class":294},[288,332,333],{"class":309}," application\u002Fjson\n",[288,335,337],{"class":290,"line":336},4,[288,338,339],{"emptyLinePlaceholder":10},"\n",[288,341,343],{"class":290,"line":342},5,[288,344,345],{"class":298},"{\n",[288,347,349,353,357,360,363,367],{"class":290,"line":348},6,[288,350,352],{"class":351},"saJyd","  \"",[288,354,356],{"class":355},"s_W10","ok",[288,358,359],{"class":351},"\"",[288,361,319],{"class":362},"saOXh",[288,364,366],{"class":365},"sjR7W"," false",[288,368,369],{"class":298},",\n",[288,371,373,375,378,380,382,386,389,391],{"class":290,"line":372},7,[288,374,352],{"class":351},[288,376,377],{"class":355},"date",[288,379,359],{"class":351},[288,381,319],{"class":362},[288,383,385],{"class":384},"sFkSl"," \"",[288,387,388],{"class":309},"2024-03-24T12:00:00.000Z",[288,390,359],{"class":384},[288,392,369],{"class":298},[288,394,396,398,401,403,405,407,410],{"class":290,"line":395},8,[288,397,352],{"class":351},[288,399,400],{"class":355},"reason",[288,402,359],{"class":351},[288,404,319],{"class":362},[288,406,385],{"class":384},[288,408,409],{"class":309},"Too many requests. 50 reqs\u002Fsecond allowed",[288,411,412],{"class":384},"\"\n",[288,414,416],{"class":290,"line":415},9,[288,417,418],{"class":298},"}\n",[420,421,422],"tip",{},[222,423,424,425,427],{},"We strongly recommend configuring your application to automatically pause and wait when it receives a ",[267,426,276],{}," header.",[248,429,431],{"id":430},"automated-bans","Automated Bans",[222,433,434,435,438],{},"If your application ignores the ",[267,436,437],{},"429"," status code and continues to aggressively spam the API while rate-limited, it will trigger an automated ban.",[222,440,441,442,444],{},"When a ban occurs, the ",[267,443,276],{}," wait time will double with each consecutive violation. This means a minor timeout can quickly escalate into being locked out for several minutes and hours.",[222,446,447,448,450,451,454,455,457],{},"If you receive a ",[267,449,269],{}," error, ",[229,452,453],{},"stop sending requests immediately"," and wait the amount of time specified in the ",[267,456,276],{}," header. Once you wait out the penalty, your access will automatically be restored.",[234,459,460],{},[222,461,462,465],{},[240,463,464],{"href":119},"Reach out"," if you encounter problems",[467,468,469],"style",{},"html pre.shiki code .sl46w, html code.shiki .sl46w{--shiki-light:#0000FF;--shiki-default:#0000FF;--shiki-dark:#FF79C6}html pre.shiki code .sDd4n, html code.shiki .sDd4n{--shiki-light:#000000;--shiki-default:#000000;--shiki-dark:#F8F8F2}html pre.shiki code .spgvN, html code.shiki .spgvN{--shiki-light:#098658;--shiki-default:#098658;--shiki-dark:#BD93F9}html pre.shiki code .sFB1V, html code.shiki .sFB1V{--shiki-light:#A31515;--shiki-default:#A31515;--shiki-dark:#F1FA8C}html pre.shiki code .scd-l, html code.shiki .scd-l{--shiki-light:#800000;--shiki-default:#800000;--shiki-dark:#FF79C6}html pre.shiki code .saJyd, html code.shiki .saJyd{--shiki-light:#0451A5;--shiki-default:#0451A5;--shiki-dark:#8BE9FE}html pre.shiki code .s_W10, html code.shiki .s_W10{--shiki-light:#0451A5;--shiki-default:#0451A5;--shiki-dark:#8BE9FD}html pre.shiki code .saOXh, html code.shiki .saOXh{--shiki-light:#000000;--shiki-default:#000000;--shiki-dark:#FF79C6}html pre.shiki code .sjR7W, html code.shiki .sjR7W{--shiki-light:#0000FF;--shiki-default:#0000FF;--shiki-dark:#BD93F9}html pre.shiki code .sFkSl, html code.shiki .sFkSl{--shiki-light:#A31515;--shiki-default:#A31515;--shiki-dark:#E9F284}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":284,"searchDepth":313,"depth":313,"links":471},[472,473,474],{"id":250,"depth":313,"text":251},{"id":261,"depth":313,"text":262},{"id":430,"depth":313,"text":431},"Details on the IP Shield API rate limits and how to handle them.","md",{},null,"---\ntitle: Rate Limits\ndescription: Details on the IP Shield API rate limits and how to handle them.\nicon: i-lucide-gauge\n---\n\nTo ensure fast response times for all users and protect against abuse, IP Shield enforces rate limits. \n\nThese rate limits are measured in requests **per second**, operate independently of your monthly credit quota, and increase based on your subscription plan.\n\n::note\nIf you require more usage, even if premium plans are not yet published, please [reach out](\u002Fcontact) to us.\n::\n\n---\n\n## Request Limits\n\nWhen using your API key, you are allowed up to **50 requests per second** in the free plan. This limit applies across all endpoints tied to your account.\n\n\n## Handling Rate Limits\n\nIf you send too many requests too quickly, the API will reject the request and return a `429 Too Many Requests` status code. \n\nThe response will include a `Retry-After` header, which tells you exactly how many seconds you must wait before trying again, along with a JSON message:\n\n```http\nHTTP\u002F1.1 429 Too Many Requests\nRetry-After: 1\nContent-Type: application\u002Fjson\n\n{\n  \"ok\": false,\n  \"date\": \"2024-03-24T12:00:00.000Z\",\n  \"reason\": \"Too many requests. 50 reqs\u002Fsecond allowed\"\n}\n```\n\n::tip\nWe strongly recommend configuring your application to automatically pause and wait when it receives a `Retry-After` header.\n::\n\n## Automated Bans\n\nIf your application ignores the `429` status code and continues to aggressively spam the API while rate-limited, it will trigger an automated ban.\n\nWhen a ban occurs, the `Retry-After` wait time will double with each consecutive violation. This means a minor timeout can quickly escalate into being locked out for several minutes and hours.\n\nIf you receive a `429 Too Many Requests` error, **stop sending requests immediately** and wait the amount of time specified in the `Retry-After` header. Once you wait out the penalty, your access will automatically be restored.\n\n::note\n[Reach out](\u002Fcontact) if you encounter problems\n::",{"title":148,"description":475},"CVJx7nsViaJW89riGyo6FTv-jaBgW_HmKOjQev1Imzc",[483,484],{"title":143,"path":144,"stem":145,"children":-1},{"title":96,"path":73,"stem":158,"children":-1},{"id":217,"title":148,"body":486,"description":475,"extension":476,"icon":151,"meta":647,"module":478,"navigation":10,"path":149,"rawbody":479,"seo":648,"stem":150,"__hash__":481},{"type":219,"value":487,"toc":642},[488,490,494,500,502,504,508,510,514,518,610,616,618,622,626,634,640],[222,489,224],{},[222,491,227,492,232],{},[229,493,231],{},[234,495,496],{},[222,497,238,498,243],{},[240,499,242],{"href":119},[245,501],{},[248,503,251],{"id":250},[222,505,254,506,258],{},[229,507,257],{},[248,509,262],{"id":261},[222,511,265,512,270],{},[267,513,269],{},[222,515,273,516,277],{},[267,517,276],{},[279,519,520],{"className":281,"code":282,"language":283,"meta":284,"style":284},[267,521,522,534,542,550,554,558,572,590,606],{"__ignoreMap":284},[288,523,524,526,528,530,532],{"class":290,"line":291},[288,525,295],{"class":294},[288,527,299],{"class":298},[288,529,303],{"class":302},[288,531,306],{"class":302},[288,533,310],{"class":309},[288,535,536,538,540],{"class":290,"line":313},[288,537,276],{"class":316},[288,539,319],{"class":294},[288,541,322],{"class":309},[288,543,544,546,548],{"class":290,"line":325},[288,545,328],{"class":316},[288,547,319],{"class":294},[288,549,333],{"class":309},[288,551,552],{"class":290,"line":336},[288,553,339],{"emptyLinePlaceholder":10},[288,555,556],{"class":290,"line":342},[288,557,345],{"class":298},[288,559,560,562,564,566,568,570],{"class":290,"line":348},[288,561,352],{"class":351},[288,563,356],{"class":355},[288,565,359],{"class":351},[288,567,319],{"class":362},[288,569,366],{"class":365},[288,571,369],{"class":298},[288,573,574,576,578,580,582,584,586,588],{"class":290,"line":372},[288,575,352],{"class":351},[288,577,377],{"class":355},[288,579,359],{"class":351},[288,581,319],{"class":362},[288,583,385],{"class":384},[288,585,388],{"class":309},[288,587,359],{"class":384},[288,589,369],{"class":298},[288,591,592,594,596,598,600,602,604],{"class":290,"line":395},[288,593,352],{"class":351},[288,595,400],{"class":355},[288,597,359],{"class":351},[288,599,319],{"class":362},[288,601,385],{"class":384},[288,603,409],{"class":309},[288,605,412],{"class":384},[288,607,608],{"class":290,"line":415},[288,609,418],{"class":298},[420,611,612],{},[222,613,424,614,427],{},[267,615,276],{},[248,617,431],{"id":430},[222,619,434,620,438],{},[267,621,437],{},[222,623,441,624,444],{},[267,625,276],{},[222,627,447,628,450,630,454,632,457],{},[267,629,269],{},[229,631,453],{},[267,633,276],{},[234,635,636],{},[222,637,638,465],{},[240,639,464],{"href":119},[467,641,469],{},{"title":284,"searchDepth":313,"depth":313,"links":643},[644,645,646],{"id":250,"depth":313,"text":251},{"id":261,"depth":313,"text":262},{"id":430,"depth":313,"text":431},{},{"title":148,"description":475},1782044522489]