# Search service providers by keyword. Search service providers by keyword. Filter by category, location or profile language. Each fresh request returns up to ten providers and uses the configured Profile Lookup Cost, including empty results. Use offsets from 0 to 990 in steps of ten. `GET https://api.envoapi.com/v1/search/services` Operation ID: `searchServicesByKeyword` ## Authentication See [Authentication](https://docs.envoapi.com/guides/authentication.md). Security alternatives (each object is one alternative): ```json [ { "BearerApiKey": [] } ] ``` BearerApiKey: ```json { "type": "http", "scheme": "bearer", "bearerFormat": "envo_<66 Base64url characters>" } ``` ## Credits Uses the current Profile base Credit cost. Check your dashboard for current costs; example charges are illustrative. ## Parameters ### keywords Location: query. Required: yes. Schema: {"type":"string","minLength":1,"maxLength":120} Example: ```json "web design" ``` ### offset Location: query. Required: no. Schema: {"default":0,"description":"Result offset, in multiples of 10. Up to 100 pages are accessible.","type":"integer","minimum":0,"maximum":990,"multipleOf":10} Example: ```json 0 ``` ### serviceCategory Location: query. Required: no. Schema: {"type":"string","minLength":1,"maxLength":1099,"description":"Category IDs from [Service category search](https://docs.envoapi.com/api/operations/searchservicecategories.md) (`data.serviceCategories[].id`). Separate IDs with commas."} Example: ```json "service_9FLmlB" ``` ### location Location: query. Required: no. Schema: {"type":"string","minLength":1,"maxLength":1099,"description":"Location IDs from [Location search](https://docs.envoapi.com/api/operations/searchlocationsbykeyword.md) (`data.locations[].id`). Separate IDs with commas."} Example: ```json "geo_6yITcz" ``` ### profileLanguage Location: query. Required: no. Schema: {"type":"string","minLength":1,"maxLength":1099,"description":"Profile language codes, separated by commas: cs, da, de, en, es, fr, in, it, ja, ko, ms, nl, no, pl, pt, ro, ru, sv, tr, zh, \_o. Use in for Indonesian, zh for Chinese, and \_o for other profile languages."} Example: ```json "en,fr" ``` ## Request example ```bash curl "https://api.envoapi.com/v1/search/services?keywords=web+design&offset=0" \ --header "Authorization: Bearer $ENVO_API_KEY" \ --header "Accept: application/json" ``` ## Responses ### 200 Service providers matching the keywords. Empty searches return an empty services array. Each fresh page uses the configured Profile Lookup Cost. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [ServiceSearchSuccess](https://docs.envoapi.com/api/schemas/ServiceSearchSuccess.md) | Field | Required | Schema | Description | | --------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | | data | yes | [ServiceSearchData](https://docs.envoapi.com/api/schemas/ServiceSearchData.md) | The result of the call. Fields we cannot fill are null. | | data.services | yes (when parent present) | {"maxItems":10,"type":"array","items":{"$ref":"#/components/schemas/ServiceSearchProvider"}} | | | meta | yes | {"type":"object","properties":{"paging":{"$ref":"#/components/schemas/ServiceSearchPaging"},"creditCost":{"$ref":"#/components/schemas/NonNegativeSafeInteger"}},"required":\["paging","creditCost"],"additionalProperties":false} | Information about the call itself. | | meta.paging | yes (when parent present) | [ServiceSearchPaging](https://docs.envoapi.com/api/schemas/ServiceSearchPaging.md) | | | meta.creditCost | yes (when parent present) | [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md) | How many credits this call used. | Response example: ```json { "data": { "services": [ { "name": "Louis E. Huynh", "headline": "Graphic Specialist | Concept Design | Typography & Calligraphy", "location": "Ho Chi Minh City, Vietnam", "description": "DAU's design&craft", "servicesPageUrl": "https://www.linkedin.com/services/page/5944b53248991b2057/", "services": [ "Web Design", "Brand Design", "Visual Design", "Packaging Design", "Graphic Design", "Print Design", "Logo Design", "Presentation Design" ], "averageRating": null, "totalReviews": null }, { "name": "Nam Lê Thành", "headline": "Web Design Freelancer | Chỉ là một người thích làm web thôi hà", "location": "Ho Chi Minh City", "description": "Tôi là Lê Thành Nam, một web designer với hơn 5 năm kinh nghiệm trong lĩnh vực thiết kế và phát triển website cho nhiều doanh nghiệp và thương hiệu lớn nhỏ. Với phong cách thiết kế tinh tế, sáng tạo và tập trung vào trải nghiệm người dùng, tôi luôn đặt mục tiêu mang đến những sản phẩm không chỉ đẹp mắt mà còn dễ sử dụng, giúp khách hàng tạo dựng sự khác biệt trên thị trường.", "servicesPageUrl": "https://www.linkedin.com/services/page/8540733131ab248ba9/", "services": [ "Web Design", "User Experience Design (UED)", "Web Development", "Search Engine Optimization (SEO)", "WordPress Design" ], "averageRating": 5, "totalReviews": 5 }, { "name": "Sobia Hashmi", "headline": "Accounts || Finance || Web Design || Web Development || Digital Marketing || Graphic Designing || Content Writing || Remote HR Still, Looking for a Good Opportunity related to Accounts & Finance!", "location": "Multan", "description": "Hi,\nHope you are doing well!\n\nWelcome there!\nIf you are looking for precise financial insights or compelling written material, I'm here to support your success.\nI provide a comprehensive range of services, including accounting and consulting to help businesses optimize their financial health. In addition, I specialize in content writing, copyediting, translation, hr, etc, and delivering high-quality, engaging, and polished content tailored to meet your unique needs.\n\nThank you!", "servicesPageUrl": "https://www.linkedin.com/services/page/800ba2331839603399/", "services": [ "Accounting", "Blogging", "Copywriting", "Editing", "Translation", "Data Entry", "Customer Support", "Virtual Assistance", "Bookkeeping", "Human Resources (HR)" ], "averageRating": null, "totalReviews": null }, { "name": "Ningyuan Z.", "headline": "Principal UX Researcher", "location": "Toronto, ON", "description": null, "servicesPageUrl": "https://www.linkedin.com/services/page/194898309427b2babb/", "services": [ "User Experience Design (UED)", "UX Research", "Diversity and Inclusion", "Public Speaking" ], "averageRating": null, "totalReviews": null }, { "name": "Farah Alzinati", "headline": "UX/UI Designer | Web & Mobile App Design | SaaS Specialist", "location": "Gaza", "description": "As a UX/UI designer, I offer comprehensive services in UX research, visual design, web design, and crafting seamless user experiences. I combine analytical research with creative design, ensuring every interface is intuitive, visually appealing, and user-focused. What sets me apart is my deep understanding of both user behavior and modern design trends, enabling me to deliver designs that not only captivate users but also improve usability and drive measurable results.", "servicesPageUrl": "https://www.linkedin.com/services/page/2813263321ba1245ba/", "services": [ "Web Design", "UX Research", "Visual Design", "User Experience Design (UED)" ], "averageRating": null, "totalReviews": null }, { "name": "Triet Trinh", "headline": "✅ Technical Architect | Solutions Architect | AWS | Scrum Master | Golang | Java | NodeJS | PHP | Remote", "location": "Vietnam", "description": null, "servicesPageUrl": "https://www.linkedin.com/services/page/85729b32a127b77331/", "services": [ "Android Development", "Application Development", "Cloud Management", "Information Security", "SaaS Development", "Web Development", "iOS Development", "Cybersecurity" ], "averageRating": null, "totalReviews": null }, { "name": "Anupam Mishra", "headline": "Enterprise Software Product Design & Storytelling", "location": "Bhopal", "description": "Helping SaaS product companies offload their UI UX design burdens to help them reduce cost and save time up to 40% in their existing design operations.\n\nIn case you are not too sure about whether you need a SaaS design outsourcing partner or if we are a good fit for you, I encourage you to take our Free, Zero-Obligation, 40-hour SaaS Design Pilot Project.\nhttps://xmoonshot.com/partnership/", "servicesPageUrl": "https://www.linkedin.com/services/page/28037a30a756511b57/", "services": [ "Web Design", "User Experience Design (UED)", "Interaction Design", "Brand Design", "Outsourcing", "UX Research" ], "averageRating": 5, "totalReviews": 1 }, { "name": "Jamiu Jimoh", "headline": "Product Designer | Mobile and Web Design | Expert in prototype design", "location": "Abuja", "description": "A user oriented UI/UX designer with solid experience in Saas and B2C products. Proficient in interaction design, User experience design and UI Design", "servicesPageUrl": "https://www.linkedin.com/services/page/b6846a319721759297/", "services": [ "User Experience Design (UED)", "Interaction Design", "Visual Design" ], "averageRating": null, "totalReviews": null }, { "name": "Maiane Gabriele", "headline": "Freelance Product Designer • Design Consultant • 14y+ experience • Making the web cool again", "location": "Brazil", "description": "My love for design and my 10 years of experience in the field have led me to a path of entrepreneurship and autonomy. As a result, I currently work on 3 fronts:\n\n👩🏻‍💻 Freelance UI/UX Designer.\n🙆🏻‍♀️ UI/UX Design consultant.\n👩🏻‍🏫 Training for companies.\n\nMy professional experience ranges from agencies, publishers, startups, entrepreneurship, training, and personal projects. A mixture of skills that make me technically capable of creating projects on various design fronts.", "servicesPageUrl": "https://www.linkedin.com/services/page/540aa43095661234b6/", "services": [ "Web Design", "Interaction Design", "User Experience Design (UED)", "Corporate Training", "Visual Design", "Editing", "UX Research", "Corporate Events" ], "averageRating": null, "totalReviews": null }, { "name": "Kainat Abbas", "headline": "•Shopify store Design •Website design (Elementor) 4+Years in Freelancing✅150+ project completed✅", "location": "Sahiwal Division", "description": "🔹 **AI Voice Agents & Chatbots** – Automate customer support, lead generation, and sales with intelligent AI-driven voice assistants and chatbots.\n\n🔹 **WordPress Development** – Build high-converting, SEO-friendly, and responsive websites using WordPress and Elementor.\n\n🚀 **Boost efficiency & scale your business with AI & WordPress solutions!**\n\n📩 Let’s connect to discuss how I can help.", "servicesPageUrl": "https://www.linkedin.com/services/page/7141a831b57a049460/", "services": [ "Web Development", "Lead Generation", "WordPress Design" ], "averageRating": null, "totalReviews": null } ] }, "meta": { "paging": { "offset": 0, "limit": 10, "returned": 10, "hasMore": true, "nextOffset": 10 }, "creditCost": 1 } } ``` ### 400 A request parameter is missing or invalid. A parameter is missing or has a value we cannot use. Read error.details, fix the value and try again. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. Content type: `application/json`. Schema: [InvalidRequestErrorResponse](https://docs.envoapi.com/api/schemas/InvalidRequestErrorResponse.md) ### 401 Your API key is invalid or inactive. Your API key is missing, wrong or switched off. Check it in your dashboard. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. Content type: `application/json`. Schema: [InvalidApiKeyErrorResponse](https://docs.envoapi.com/api/schemas/InvalidApiKeyErrorResponse.md) ### 402 Your account does not have enough credits. Your account has no credits left. Top up, then send a new call. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [InsufficientCreditsErrorResponse](https://docs.envoapi.com/api/schemas/InsufficientCreditsErrorResponse.md) ### 403 Your API key or account cannot access this endpoint. Your account is suspended or cannot use this endpoint. Resolve the account or its access first. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. Content type: `application/json`. Schema: [LookupForbiddenErrorResponse](https://docs.envoapi.com/api/schemas/LookupForbiddenErrorResponse.md) ### 404 The requested resource was not found. Nothing matched what you sent. Check it for typos. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [ResourceNotFoundErrorResponse](https://docs.envoapi.com/api/schemas/ResourceNotFoundErrorResponse.md) ### 405 Use GET for this endpoint. The route exists, but the request used a method other than GET. Use the method shown at the top of this page. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **Allow**: Required response header. Schema: {"type":"string","const":"GET"}. Content type: `application/json`. Schema: [MethodNotAllowedErrorResponse](https://docs.envoapi.com/api/schemas/MethodNotAllowedErrorResponse.md) ### 406 The response format in your Accept header is not supported. The Accept header asks for a format we do not send. Ask for JSON with a supported Accept value. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. Content type: `application/json`. Schema: [NotAcceptableErrorResponse](https://docs.envoapi.com/api/schemas/NotAcceptableErrorResponse.md) ### 415 The Content-Type in your request is not supported. The request declared a media type we do not accept. Remove the body or use the documented media type. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. Content type: `application/json`. Schema: [UnsupportedMediaTypeErrorResponse](https://docs.envoapi.com/api/schemas/UnsupportedMediaTypeErrorResponse.md) ### 429 Your account has sent too many requests. Too many calls in a short time. Honor Retry-After; use bounded retries with backoff and jitter. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **Retry-After**: Seconds to wait before you try again. Schema: [PositiveSafeInteger](https://docs.envoapi.com/api/schemas/PositiveSafeInteger.md). Content type: `application/json`. Schema: [RateLimitExceededErrorResponse](https://docs.envoapi.com/api/schemas/RateLimitExceededErrorResponse.md) ### 500 A server error prevented the request from completing. Something failed on our side. Retry only when error.retryable is true. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [InternalServerErrorResponse](https://docs.envoapi.com/api/schemas/InternalServerErrorResponse.md) ### 502 A data source returned an invalid response. A data source sent back something we could not use. Retry with bounded backoff. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [UpstreamErrorResponse](https://docs.envoapi.com/api/schemas/UpstreamErrorResponse.md) ### 503 The service is unavailable. Check error.retryable before retrying. Lookups are unavailable for a moment. Follow error.retryable, and Retry-After when it is present. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **Retry-After**: Seconds to wait before you try again. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [ServiceUnavailableErrorResponse](https://docs.envoapi.com/api/schemas/ServiceUnavailableErrorResponse.md) ### 504 The request timed out. The lookup ran out of time. Retry with bounded backoff. * **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md). * **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md). * **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md). * **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}. * **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). * **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md). Content type: `application/json`. Schema: [UpstreamTimeoutErrorResponse](https://docs.envoapi.com/api/schemas/UpstreamTimeoutErrorResponse.md) ## Related documentation * [Authentication](https://docs.envoapi.com/guides/authentication.md) * [Errors](https://docs.envoapi.com/guides/errors.md) * [Pagination](https://docs.envoapi.com/guides/pagination.md) * [Rate limits](https://docs.envoapi.com/guides/rate-limits.md) * [Find companies by website domain.](https://docs.envoapi.com/api/operations/searchcompaniesbydomain.md) * [Search companies by keyword.](https://docs.envoapi.com/api/operations/searchcompaniesbykeyword.md) * [Search schools by keyword.](https://docs.envoapi.com/api/operations/searchschoolsbykeyword.md) * [Search people by keyword.](https://docs.envoapi.com/api/operations/searchpeoplebykeyword.md) * [Search all result types by keyword.](https://docs.envoapi.com/api/operations/searchallresultsbykeyword.md) * [Search locations by keyword.](https://docs.envoapi.com/api/operations/searchlocationsbykeyword.md) * [Search industries by keyword.](https://docs.envoapi.com/api/operations/searchindustriesbykeyword.md) * [Search service categories.](https://docs.envoapi.com/api/operations/searchservicecategories.md) * [Get search suggestions.](https://docs.envoapi.com/api/operations/getsearchtypeahead.md) [Documentation index](https://docs.envoapi.com/llms.txt) · [All endpoints](https://docs.envoapi.com/api/index.md)