# The Hog ## Docs - [POST /api/companies/search](https://docs.thehog.ai/api/companies/search.md): Search companies by firmographics, technographics, and signals. Returns a paginated list of company cards with optional project context and metering data. - [POST /api/companies/search/estimate](https://docs.thehog.ai/api/companies/search-estimate.md): Get a worst-case credit estimate for a company search before running it. Returns estimatedMaxCredits, assumedRows, and creditsPerDomainTriple. No charge. - [POST /api/context](https://docs.thehog.ai/api/context.md): Retrieve assembled GTM context for a project: messaging guide, brand voice, ICP personas, competitive intel, and signals. Sync endpoint. - [POST /api/deep-research](https://docs.thehog.ai/api/deep-research.md): Start an async LLM research job with a prompt and JSON Schema. The Hog browses the web and returns structured data conforming to your schema. - [POST /api/generate/estimate](https://docs.thehog.ai/api/generate/estimate.md): Pre-flight credit estimate for content generation. Returns estimated credits and likely sync or async mode before committing to a generate request. - [POST /api/generate](https://docs.thehog.ai/api/generate/generate.md): Generate text, images, or structured data using AI. Supports prompt mode, social context mode, and AI mode with custom models and JSON Schema output. - [POST /api/generate/image](https://docs.thehog.ai/api/generate/image.md): Generate an image with Vertex AI Gemini and download it as a binary file. Returns raw image bytes with Content-Disposition: attachment. - [GET /api/operations/:id](https://docs.thehog.ai/api/operations/get.md): Poll the status of an async operation. Returns status, progress, result, and error. Used for enrich, generate, and deep research async jobs. - [POST /api/people/enrich](https://docs.thehog.ai/api/people/enrich.md): Enrich contacts with verified emails and phone numbers using a multi-provider waterfall. Control batch size, depth, and sync vs async delivery. - [POST /api/people/enrich/estimate](https://docs.thehog.ai/api/people/enrich-estimate.md): Pre-flight estimate for people enrichment. Returns estimated credit cost and likely sync or async mode before committing to a full enrich request. - [POST /api/people/researches](https://docs.thehog.ai/api/people/researches.md): Build detailed research dossiers for contacts via cross-platform identity resolution. Accepts LinkedIn URLs, email, or other identifiers. Sync, 2–30s. - [POST /api/people/researches/estimate](https://docs.thehog.ai/api/people/researches-estimate.md): Pre-flight cost estimate for people research. Returns estimated credits and expected latency range before running a research dossier request. - [POST /api/people/search](https://docs.thehog.ai/api/people/search.md): Search people by natural language query, job title, location, or company. Returns ICP-ranked person cards. Sync endpoint. - [POST /api/signals](https://docs.thehog.ai/api/signals.md): Get classified buying signals for your target accounts: job changes, hiring surges, funding rounds, growth indicators, and more. Sync endpoint. - [Authenticate with The Hog API](https://docs.thehog.ai/authentication.md): The Hog API uses Bearer token authentication. Pass your API key in the Authorization header on every request to access all endpoints. - [Company-First Search in The Hog](https://docs.thehog.ai/concepts/company-first-search.md): The Hog's company-first approach lets you find target accounts by firmographics and signals first, then drill into contacts — improving ICP match quality. - [Credits and Usage in The Hog](https://docs.thehog.ai/concepts/credits.md): The Hog charges credits for API calls that use third-party data providers. Use estimate endpoints to preview costs before running expensive operations. - [Using Project Context with The Hog](https://docs.thehog.ai/concepts/project-context.md): Project context scopes API responses to your brand voice, ICP personas, and competitive intel. Pass X-Project-Id header or projectId body field to activate it. - [Sync and Async Operations in The Hog](https://docs.thehog.ai/concepts/sync-vs-async.md): Fast API calls return 200 immediately. Long-running tasks return 202 with a poll URL. Learn when each pattern applies and how to poll for results. - [Run Deep Research with LLM-Powered Analysis](https://docs.thehog.ai/guides/deep-research.md): Submit a research prompt and JSON Schema to The Hog's deep research endpoint. Get back structured data matching your schema, extracted from web sources. - [Enrich Contacts with Emails and Phone Numbers](https://docs.thehog.ai/guides/enrich-contacts.md): Get verified email addresses and phone numbers for your prospects. Control enrichment depth and choose sync or async delivery for bulk batches. - [Find and Research People with The Hog](https://docs.thehog.ai/guides/find-people.md): Discover ICP-matched contacts with natural language queries, then build detailed research dossiers using cross-platform identity resolution. - [Generate Context-Aware Content with The Hog](https://docs.thehog.ai/guides/generate-content.md): Use The Hog's generate endpoint to create AI-powered text, social replies, and images grounded in your project's brand voice and GTM context. - [Search Companies by Firmographics and Tech Stack](https://docs.thehog.ai/guides/search-companies.md): Use The Hog's company search to find target accounts by industry, employee count, revenue, technology, and buying signals like hiring and funding. - [The Hog: GTM Intelligence API for Revenue Teams](https://docs.thehog.ai/introduction.md): The Hog is a REST API for go-to-market teams. Search companies, discover people, enrich contacts, detect signals, and generate content in one platform. - [Get Started with The Hog API](https://docs.thehog.ai/quickstart.md): Make your first The Hog API call in minutes. Search companies, find people, and enrich contacts with step-by-step examples. - [Error Handling and HTTP Status Codes](https://docs.thehog.ai/reference/error-handling.md): The Hog returns RFC 7807-style JSON error bodies for all failures. Learn the error shape, status codes, validation errors, and how to handle them. - [Idempotent Requests with The Hog API](https://docs.thehog.ai/reference/idempotency.md): Pass the Idempotency-Key header on async POST requests to safely retry without creating duplicate jobs. The key is scoped to your organization. - [Rate Limits for The Hog API](https://docs.thehog.ai/reference/rate-limits.md): The Hog enforces rate limits per organization to ensure fair usage. Polling operations has a separate dedicated throttle. Learn limits and retry behavior. - [API Response Shapes and Data Formats](https://docs.thehog.ai/reference/response-shapes.md): Every The Hog API response uses a consistent envelope. Learn the sync, async, estimate, and operation response shapes plus cost and meta fields. ## OpenAPI Specs - [openapi](https://docs.thehog.ai/api-reference/openapi.json)