{"openapi":"3.1.0","info":{"title":"1Lookup API","version":"1.0.0","summary":"Phone, email, IP, business, social and SEO data in one API.","description":"One API key and one shared credit balance across every product. Most lookups cost 1 credit and answer in under a second.\n\nEvery response uses the same envelope: `{ \"success\": true, \"data\": { ... } }` on success and\n`{ \"success\": false, \"error\": { \"message\", \"code\", \"type\" } }` on failure. Check `success` before reading `data`.\n\nAgents can also reach these lookups over the hosted MCP server instead of REST; see the MCP server card at\nhttps://www.1lookup.io/.well-known/mcp/server-card.json.","termsOfService":"https://www.1lookup.io/terms","contact":{"name":"1Lookup Support","url":"https://www.1lookup.io/contact"},"license":{"name":"Proprietary","url":"https://www.1lookup.io/terms"}},"servers":[{"url":"https://app.1lookup.io/api/v1","description":"Production"}],"externalDocs":{"description":"Full API documentation","url":"https://app.1lookup.io/api"},"tags":[{"name":"Phone","description":"Validate, classify and scrub phone numbers."},{"name":"Email","description":"Verify deliverability of email addresses."},{"name":"IP","description":"Geolocate IP addresses and flag proxies and VPNs."},{"name":"Business","description":"Verify and enrich business and property records."},{"name":"Enrichment","description":"Turn one identifier into a fuller contact or company record."},{"name":"Social","description":"Live public social-media data."},{"name":"SEO","description":"Search, keyword and backlink intelligence."},{"name":"Web","description":"Read and extract data from web pages."},{"name":"Content","description":"Transcribe audio and video."},{"name":"Account","description":"Plan, credit balance and usage."}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key as a bearer token: `Authorization: Bearer sk_live_...`. Create keys at https://app.1lookup.io/api-keys."}},"schemas":{"SuccessResponse":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","description":"Result payload. Its shape depends on the endpoint; see the linked documentation for per-endpoint fields.","additionalProperties":true}}},"ErrorResponse":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["message","code","type"],"properties":{"message":{"type":"string","description":"Human-readable description of what went wrong."},"code":{"type":"string","description":"Stable machine-readable error code.","enum":["UNAUTHORIZED","INSUFFICIENT_CREDITS","INVALID_REQUEST","MISSING_FIELD","INVALID_EMAIL","INVALID_PHONE","INVALID_IP","INVALID_URL","INVALID_INPUT","NOT_FOUND","RATE_LIMIT_EXCEEDED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"type":{"type":"string","enum":["api_error"]}}}}}}},"paths":{"/phone":{"post":{"operationId":"lookupPhone","summary":"Validate a phone number","description":"Confirms a phone number is real and active, and returns line type, carrier, location, reachability and a fraud score. Costs 1 credit.","tags":["Phone"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["phone_number"],"properties":{"phone_number":{"type":"string","description":"Phone number to validate. E.164 format recommended.","examples":["+14155552671"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"phone_number":"+14155552671"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/phone-spam":{"post":{"operationId":"lookupPhoneSpam","summary":"Check a phone number for spam or fraud history","description":"Reports whether a number is associated with spam or fraudulent activity. Costs 1 credit.","tags":["Phone"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["phone_number"],"properties":{"phone_number":{"type":"string","description":"Phone number to check.","examples":["+14155552671"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"phone_number":"+14155552671"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/phone-scrub":{"post":{"operationId":"lookupPhoneScrub","summary":"Scrub a phone number against DNC and litigator lists","description":"Checks a number against Do Not Call and known-litigator lists before you dial or text it. Costs 1 credit.","tags":["Phone"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["phone_number"],"properties":{"phone_number":{"type":"string","description":"Phone number to scrub.","examples":["+14155552671"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"phone_number":"+14155552671"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/hlr-lookup":{"post":{"operationId":"lookupHlr","summary":"HLR lookup for an international mobile number","description":"Queries the Home Location Register for live subscriber status, roaming state and network. Costs 1 credit.","tags":["Phone"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["phone_number"],"properties":{"phone_number":{"type":"string","description":"International mobile number in E.164 format.","examples":["+447700900123"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"phone_number":"+447700900123"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/mnp-lookup":{"post":{"operationId":"lookupMnp","summary":"Mobile number portability lookup","description":"Returns the network a number has been ported to, rather than the network its prefix implies. Costs 1 credit.","tags":["Phone"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["phone_number"],"properties":{"phone_number":{"type":"string","description":"International mobile number in E.164 format.","examples":["+447700900123"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"phone_number":"+447700900123"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/nt-lookup":{"post":{"operationId":"lookupNumberType","summary":"Number type lookup","description":"Classifies an international number as mobile, landline, VoIP or other. Costs 1 credit.","tags":["Phone"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["phone_number"],"properties":{"phone_number":{"type":"string","description":"International number in E.164 format.","examples":["+447700900123"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"phone_number":"+447700900123"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/reverse-phone-lookup":{"post":{"operationId":"reversePhoneLookup","summary":"Reverse phone lookup","description":"Returns the person or business associated with a phone number. Costs 1 credit.","tags":["Enrichment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["phone_number"],"properties":{"phone_number":{"type":"string","description":"Phone number to look up.","examples":["+14155552671"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"phone_number":"+14155552671"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/mobile-finder":{"post":{"operationId":"findMobile","summary":"Find a mobile number for a contact","description":"Takes an identifier for a contact and returns a mobile number where one is known. Costs 1 credit.","tags":["Enrichment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"string","description":"Identifier for the contact, such as an email address.","examples":["ada@example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"input":"ada@example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/phone-append":{"post":{"operationId":"skipTrace","summary":"Skip trace: append a phone number from name and address","description":"Matches a name and postal address to a phone number. Costs 1 credit.","tags":["Enrichment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"string","description":"Name and address of the contact to match.","examples":["Ada Lovelace, 1 Main St, Springfield, IL"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"input":"Ada Lovelace, 1 Main St, Springfield, IL"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/email":{"post":{"operationId":"verifyEmail","summary":"Verify an email address","description":"Checks that a mailbox exists and is deliverable, and flags disposable, role-based and risky addresses. Costs 1 credit.","tags":["Email"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","description":"Email address to verify.","examples":["ada@example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"email":"ada@example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/email-append":{"post":{"operationId":"appendEmail","summary":"Append an email address to a contact","description":"Returns a deliverable email address for a known contact. Costs 1 credit.","tags":["Enrichment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"string","description":"Identifier for the contact, such as a name and company.","examples":["Ada Lovelace, Analytical Engines Ltd"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"input":"Ada Lovelace, Analytical Engines Ltd"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/reverse-email-append":{"post":{"operationId":"reverseEmailAppend","summary":"Reverse email append","description":"Returns the person and company behind an email address. Costs 1 credit.","tags":["Enrichment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","description":"Email address to resolve.","examples":["ada@example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"email":"ada@example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/email-enrichment":{"post":{"operationId":"enrichEmail","summary":"Enrich a contact record from an email address","description":"Expands an email address into a fuller contact and company record. Costs 1 credit.","tags":["Enrichment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"string","description":"Email address to enrich.","examples":["ada@example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"input":"ada@example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/b2b-contact-append":{"post":{"operationId":"appendB2bContact","summary":"Append B2B contact details","description":"Returns business contact details for a work email address. Costs 1 credit.","tags":["Enrichment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","description":"Work email address.","examples":["ada@example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"email":"ada@example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/ip":{"post":{"operationId":"lookupIp","summary":"Look up an IP address","description":"Returns geolocation, connection type and proxy, VPN, Tor and datacenter flags with a fraud score. Costs 1 credit.","tags":["IP"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ip"],"properties":{"ip":{"type":"string","description":"IPv4 or IPv6 address.","examples":["8.8.8.8"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"ip":"8.8.8.8"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/reverse-ip-append":{"post":{"operationId":"reverseIpAppend","summary":"Reverse IP append","description":"Returns the company associated with an IP address. Costs 1 credit.","tags":["Enrichment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ip"],"properties":{"ip":{"type":"string","description":"IPv4 or IPv6 address.","examples":["8.8.8.8"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"ip":"8.8.8.8"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/business-verify":{"post":{"operationId":"verifyBusiness","summary":"Verify a business exists","description":"Confirms a business is real and returns registration details. Costs 1 credit.","tags":["Business"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["business_name"],"properties":{"business_name":{"type":"string","description":"Registered or trading name of the business.","examples":["Analytical Engines Ltd"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"business_name":"Analytical Engines Ltd"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/business-lookup":{"post":{"operationId":"lookupBusiness","summary":"Look up a business record","description":"Returns the firmographic record for a business by name. Costs 1 credit.","tags":["Business"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["business_name"],"properties":{"business_name":{"type":"string","description":"Registered or trading name of the business.","examples":["Analytical Engines Ltd"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"business_name":"Analytical Engines Ltd"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/company-profile-lookup":{"post":{"operationId":"lookupCompanyProfile","summary":"Look up a company profile by domain","description":"Returns the company profile behind a domain. Costs 1 credit.","tags":["Business"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"Company domain, without scheme.","examples":["example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"domain":"example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/company-firmographics":{"post":{"operationId":"lookupCompanyFirmographics","summary":"Look up company firmographics","description":"Returns size, industry, revenue band and location for a company domain. Costs 1 credit.","tags":["Business"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"Company domain, without scheme.","examples":["example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"domain":"example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/property-lookup":{"post":{"operationId":"lookupProperty","summary":"Look up a property record","description":"Returns the property record for a postal address. Costs 1 credit.","tags":["Business"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Postal address of the property.","examples":["1 Main St, Springfield, IL"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"address":"1 Main St, Springfield, IL"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/social-profile-check":{"post":{"operationId":"checkSocialProfile","summary":"Check a social profile by handle","description":"Reports whether a handle exists on the major social networks and returns its public profile. Costs 1 credit.","tags":["Social"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["handle"],"properties":{"handle":{"type":"string","description":"Social handle, without the leading @.","examples":["1lookup"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"handle":"1lookup"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/social-post-lookup":{"post":{"operationId":"lookupSocialPost","summary":"Look up a social post","description":"Returns the public content and engagement figures for a post URL. Costs 1 credit.","tags":["Social"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"URL of the social post.","examples":["https://www.instagram.com/p/EXAMPLE/"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"url":"https://www.instagram.com/p/EXAMPLE/"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/social-search":{"post":{"operationId":"searchSocial","summary":"Search public social content","description":"Searches public social posts and profiles for a query. Costs 1 credit.","tags":["Social"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Search query.","examples":["data validation"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"query":"data validation"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/audience-demographics":{"post":{"operationId":"lookupAudienceDemographics","summary":"Audience demographics for a social handle","description":"Returns the audience breakdown for a public social account. Costs 1 credit.","tags":["Social"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["handle"],"properties":{"handle":{"type":"string","description":"Social handle, without the leading @.","examples":["1lookup"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"handle":"1lookup"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/link-in-bio-lookup":{"post":{"operationId":"lookupLinkInBio","summary":"Expand a link-in-bio page","description":"Returns the destinations behind a link-in-bio URL. Costs 1 credit.","tags":["Social"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Link-in-bio page URL.","examples":["https://linktr.ee/example"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"url":"https://linktr.ee/example"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/ad-library-lookup":{"post":{"operationId":"lookupAdLibrary","summary":"Look up a company's public ads","description":"Returns ads a company is running from the public ad libraries. Costs 1 credit.","tags":["Social"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["company"],"properties":{"company":{"type":"string","description":"Company or advertiser name.","examples":["Analytical Engines Ltd"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"company":"Analytical Engines Ltd"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/video-transcript":{"post":{"operationId":"getVideoTranscript","summary":"Transcript for a public video","description":"Returns the transcript of a public video URL. Costs 1 credit.","tags":["Content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Public video URL.","examples":["https://www.youtube.com/watch?v=EXAMPLE"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"url":"https://www.youtube.com/watch?v=EXAMPLE"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/audio-transcription":{"post":{"operationId":"transcribeAudio","summary":"Transcribe an audio file","description":"Transcribes an audio file reachable at a URL. Costs 1 credit.","tags":["Content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["audio_url"],"properties":{"audio_url":{"type":"string","description":"URL of the audio file to transcribe.","examples":["https://example.com/call.mp3"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"audio_url":"https://example.com/call.mp3"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/website-scraper":{"post":{"operationId":"scrapeWebsite","summary":"Scrape a web page","description":"Returns the readable content of a page. Costs 1 credit.","tags":["Web"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Page URL to scrape.","examples":["https://example.com/pricing"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"url":"https://example.com/pricing"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/website-contacts-scraper":{"post":{"operationId":"scrapeWebsiteContacts","summary":"Find contact details on a website","description":"Returns the email addresses and phone numbers published on a domain. Costs 1 credit.","tags":["Web"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"Domain to scan, without scheme.","examples":["example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"domain":"example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/domain-age":{"post":{"operationId":"lookupDomainAge","summary":"Domain age","description":"Returns registration date and age for a domain. Costs 1 credit.","tags":["Web"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"Domain, without scheme.","examples":["example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"domain":"example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/domain-authority":{"post":{"operationId":"lookupDomainAuthority","summary":"Domain authority","description":"Returns authority and trust metrics for a domain. Costs 1 credit.","tags":["SEO"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"Domain, without scheme.","examples":["example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"domain":"example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/domain-seo-intelligence":{"post":{"operationId":"lookupDomainSeoIntelligence","summary":"SEO intelligence for a domain","description":"Returns traffic, keyword and ranking intelligence for a domain. Costs 1 credit.","tags":["SEO"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"Domain, without scheme.","examples":["example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"domain":"example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/backlink-overview":{"post":{"operationId":"lookupBacklinkOverview","summary":"Backlink overview for a domain","description":"Returns referring domains and backlink counts. Costs 1 credit.","tags":["SEO"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"Domain, without scheme.","examples":["example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"domain":"example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/keyword-metrics":{"post":{"operationId":"lookupKeywordMetrics","summary":"Keyword metrics","description":"Returns volume, difficulty and cost-per-click for a keyword. Costs 1 credit.","tags":["SEO"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["keyword"],"properties":{"keyword":{"type":"string","description":"Keyword to look up.","examples":["phone validation api"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"keyword":"phone validation api"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/search-intent-lookup":{"post":{"operationId":"lookupSearchIntent","summary":"Search intent for a query","description":"Classifies the intent behind a search query. Costs 1 credit.","tags":["SEO"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Search query to classify.","examples":["buy phone validation api"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"q":"buy phone validation api"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/audience-intelligence":{"post":{"operationId":"lookupAudienceIntelligence","summary":"Audience intelligence for a domain","description":"Returns audience composition and interests for a domain. Costs 1 credit.","tags":["SEO"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"Domain, without scheme.","examples":["example.com"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"domain":"example.com"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/prospect-search":{"post":{"operationId":"searchProspects","summary":"Search for B2B prospects","description":"Returns contacts matching a set of keywords. Costs 1 credit per returned contact.","tags":["Enrichment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["keywords"],"properties":{"keywords":{"type":"string","description":"Keywords describing the prospects to find.","examples":["head of engineering fintech london"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"keywords":"head of engineering fintech london"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/account-search":{"post":{"operationId":"searchAccounts","summary":"Search for B2B accounts","description":"Returns companies matching a set of keywords. Costs 1 credit per returned account.","tags":["Enrichment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["keywords"],"properties":{"keywords":{"type":"string","description":"Keywords describing the accounts to find.","examples":["series b fintech london"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"keywords":"series b fintech london"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/linkedin-profile-lookup":{"post":{"operationId":"lookupLinkedinProfile","summary":"Look up a LinkedIn profile","description":"Returns the public profile behind a LinkedIn URL. Costs 1 credit.","tags":["Enrichment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["profile_url"],"properties":{"profile_url":{"type":"string","description":"Public LinkedIn profile URL.","examples":["https://www.linkedin.com/in/example/"]},"bypass_cache":{"type":"boolean","default":false,"description":"Skip the 7-day result cache and force a fresh lookup. Costs a credit even when a cached result exists."}}},"examples":{"default":{"value":{"profile_url":"https://www.linkedin.com/in/example/"}}}}}},"responses":{"200":{"description":"Lookup succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"`INVALID_REQUEST` — Invalid request format or parameters; `MISSING_FIELD` — Required field is missing; `INVALID_EMAIL` — Invalid email format; `INVALID_PHONE` — Invalid phone number format; `INVALID_IP` — Invalid IP address format; `INVALID_URL` — Invalid URL or domain format; `INVALID_INPUT` — Input does not match the expected format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"`INSUFFICIENT_CREDITS` — Not enough credits for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the window."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix time, in seconds, when the window resets."}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"`SERVICE_UNAVAILABLE` — External service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/account":{"get":{"operationId":"getAccount","summary":"Account status and credit balance","description":"Returns the organization, subscription, credit balance and usage for the calling API key. Free: this call spends no credits.","tags":["Account"],"responses":{"200":{"description":"Account status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"`UNAUTHORIZED` — Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"`RATE_LIMIT_EXCEEDED` — Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"`INTERNAL_ERROR` — Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}