# API: contacts endpoint **URL:** \ **Category:** APIs & Integrations\ **Tags:** contacts\ **Created:** [May 18, 2026, 3:51pm UTC](https://community.hubspot.com/t/api-contacts-endpoint/149449 "2026-05-18T15:51:59Z")\ **Posts on this page:** 5\ **Page:** 1
**Author:** ![MFerrari5](https://avatars.discourse-cdn.com/v4/letter/m/e495f1/32.png) [@MFerrari5](https://community.hubspot.com/u/MFerrari5)\ **Post date:** [May 18, 2026, 3:51pm UTC](https://community.hubspot.com/t/api-contacts-endpoint/149449/1 "2026-05-18T15:51:59Z")
Hi there! Quick question. Does anyone know how to improve API requests for the contacts endpoint? LInk: [Search the CRM - HubSpot docs](https://developers.hubspot.com/docs/api-reference/latest/crm/search-the-crm) I’ve been running into issues because I have hundreds of thousands of contacts, and with the page limit capped at 200, I need to paginate through them and make a very large number of requests. I tried filtering but there isn’t an specific filter that helps me out here Thanks! ---
**Author:** ![stassey](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/stassey/32/36_2.png) [@stassey](https://community.hubspot.com/u/stassey)\ **Post date:** [May 18, 2026, 9:02pm UTC](https://community.hubspot.com/t/api-contacts-endpoint/149449/2 "2026-05-18T21:02:30Z")
Hey @MFerrari5, Welcome to the Community! Currently the limits on the search endpoint are the following: - 200 records/page max - 10,000 total results per query (paging beyond returns 400) - 5 requests/second/account That said, I’d like to tag in some of our Top Contributors to see if they have any tips and tricks on this! Hey @SteveHTM, @Josh, [@Mike\_Eastwood](https://community.hubspot.com/t5/user/viewprofilepage/user-id/9259) -- Do you have any suggestions for @MFerrari5 on this? Thanks in advance! Sam, Community Manager ---
**Author:** ![MichaelMa](https://avatars.discourse-cdn.com/v4/letter/m/b5ac83/32.png) [@MichaelMa](https://community.hubspot.com/u/MichaelMa)\ **Post date:** [May 19, 2026, 6:00pm UTC](https://community.hubspot.com/t/api-contacts-endpoint/149449/3 "2026-05-19T18:00:32Z")
How often do you need to pull all the contacts? It’s probably easier to do an export and prefil your database instead of trying to API through all of them. I suppose you could use the export API to generate an export and then ingest that file if you need to constantly retrieve all the records. ---
**Author:** ![MFerrari5](https://avatars.discourse-cdn.com/v4/letter/m/e495f1/32.png) [@MFerrari5](https://community.hubspot.com/u/MFerrari5)\ **Post date:** [May 19, 2026, 6:09pm UTC](https://community.hubspot.com/t/api-contacts-endpoint/149449/4 "2026-05-19T18:09:56Z")
Hi @MichaelMa [@SamTassey](https://community.hubspot.com/t5/user/viewprofilepage/user-id/388334) In short, our process relies on the API. We retrieve contacts updated in the last three days, which results in approximately 30,000 contacts. Due to the 200-contact limit per request, this requires making over 150 API calls. So if there is like a field we could use to filter out some inactive contacts would be great Thanks! ---
**Author:** ![MichaelMa](https://avatars.discourse-cdn.com/v4/letter/m/b5ac83/32.png) [@MichaelMa](https://community.hubspot.com/u/MichaelMa)\ **Post date:** [May 19, 2026, 6:24pm UTC](https://community.hubspot.com/t/api-contacts-endpoint/149449/5 "2026-05-19T18:24:02Z")
Would it be possible to simply run the API more often so that it has to query less in a single time? How much data do you need from the contact record? You might be able to pull a bit more records using GraphQL (500 record limit, I believe?). > **[​Query complexity and account limits - Query HubSpot data using GraphQL -...](https://developers.hubspot.com/docs/cms/start-building/features/data-driven-content/graphql/query-hubspot-data-using-graphql#query-complexity-and-account-limits)** > > Supported products | Learn how to use GraphQL to query your HubSpot data Have you looked at creating a web hook and have HubSpot send the contact changes to your endpoint in “real-time” instead of doing an API pull?