# Up2Data API (/v1) > Up2Data's /v1 API is a usage-based B2B data API: real-time LinkedIn profile, company, post, and job enrichment, live people, company, job, and post search, Sales Navigator search, and asynchronous batch jobs, all through one `X-API-Key` header. Every /v1 capability is also batchable as an operation item, not just profile, company, and post enrich. Every call answers a `{data, meta}` envelope on success or an `{error}` envelope on failure. Sync enrich, activity, and a `profile`, `company`, `post`, or Sales Navigator batch item bill both when the target is found and when it comes back not found, private, deleted, or unreachable (`422 unprocessable_target`); every other batch operation refunds a `422` down to 0 once its queue settles. A call is only free when it fails with `400`, `401`, `402`, `429`, `500`, or `504`. Job search bills per job returned; people, company, and post search (Sales Navigator and standard alike) bill per page of up to 25 results, and empty pages are free. The base URL is `https://api.up2data.ai/v1`. Sync endpoints answer directly, typically in 2 to 8 seconds; submit `POST /batch` for volume and read results by webhook (`batch.completed`) or by polling `GET /batch/{job_id}`. Authentication is one header: `X-API-Key: YOUR_API_KEY`. The base URL is `https://api.up2data.ai/v1`. ## Guides - [Quickstart](https://up2data.ai/docs/v1/guides/quickstart.md): Make your first enrich call, then submit a batch, in under five minutes. - [Authentication](https://up2data.ai/docs/v1/guides/authentication.md): The X-API-Key header, where keys come from, and the 401/402 rows it can return. - [Credits](https://up2data.ai/docs/v1/guides/credits.md): The rate for every endpoint, and why a not-found target (422) is billed everywhere. - [Batch jobs](https://up2data.ai/docs/v1/guides/batch-jobs.md): Submit up to 1,000 mixed items in one call and read results by webhook or by polling. - [Errors](https://up2data.ai/docs/v1/guides/errors.md): Every error type, its status code, and whether it is billed. - [Rate limits](https://up2data.ai/docs/v1/guides/rate-limits.md): Per-key request limits, the per-organization search quota, and the headers that report them. - [Webhooks](https://up2data.ai/docs/v1/guides/webhooks.md): batch.completed delivery, signature verification, and the retry schedule. - [Migrating from legacy](https://up2data.ai/docs/v1/guides/migrating-from-legacy.md): Map every {legacy} open-refresh route to its /v1 equivalent. ## API reference - [All operations](https://up2data.ai/docs/v1/index.md): Every operation, its method, path, credit cost and mode. - [Enrich a profile](https://up2data.ai/docs/v1/api/profiles-enrich.md): Turn any LinkedIn profile URL into a full live record, scraped at request time. - [Get profile activity](https://up2data.ai/docs/v1/api/profiles-activity.md): Get one profile's authored posts, comments, reactions, or reposts, one kind per call. - [Get profile recommendations](https://up2data.ai/docs/v1/api/profiles-recommendations.md): Get the written recommendations a profile has received, given, or both. - [Get profile interests](https://up2data.ai/docs/v1/api/profiles-interests.md): Get what a profile follows: top voices, companies, groups, newsletters, and schools. - [Enrich a company](https://up2data.ai/docs/v1/api/companies-enrich.md): Turn any LinkedIn company URL, domain, or ID into live firmographics. - [Count company job openings](https://up2data.ai/docs/v1/api/companies-jobs-count.md): Return the number of active job postings a company has on LinkedIn. - [Get company posts](https://up2data.ai/docs/v1/api/companies-posts.md): List recent posts published by a company page. - [Find custom headcount](https://up2data.ai/docs/v1/api/companies-headcount.md): Count employees at a company matching title, seniority, location, or keyword filters. - [Enrich a job](https://up2data.ai/docs/v1/api/jobs-enrich.md): Fetch full details for a single LinkedIn job posting, including the description and company. - [Search jobs](https://up2data.ai/docs/v1/api/search-jobs.md): Live LinkedIn job postings by company, keyword, and filters. - [Enrich a post](https://up2data.ai/docs/v1/api/posts-enrich.md): Fetch one LinkedIn post by URL: full text plus live engagement. - [Search posts](https://up2data.ai/docs/v1/api/search-posts.md): Live LinkedIn post search by keyword, hashtag, or author. - [Get post comments](https://up2data.ai/docs/v1/api/posts-engagement-comments.md): Inbound engagement on a post - who commented, with profile stubs. - [Get post reactions](https://up2data.ai/docs/v1/api/posts-engagement-reactions.md): Inbound engagement on a post - who reacted, filterable by reaction type. - [Get post reposts](https://up2data.ai/docs/v1/api/posts-engagement-reposts.md): Inbound engagement on a post - who reposted it. - [Search people](https://up2data.ai/docs/v1/api/search-people.md): Live people search with structured filters. - [Search people (Sales Navigator)](https://up2data.ai/docs/v1/api/search-people-sales-nav.md): Search people with structured filters or a pasted Sales Navigator URL. - [Search people (standard)](https://up2data.ai/docs/v1/api/search-people-standard.md): People search on LinkedIn's regular search, not Sales Navigator. - [Search companies](https://up2data.ai/docs/v1/api/search-companies.md): Live company search with structured filters. - [Search companies (Sales Navigator)](https://up2data.ai/docs/v1/api/search-companies-sales-nav.md): Search companies with structured filters or a pasted Sales Navigator URL. - [Search companies (standard)](https://up2data.ai/docs/v1/api/search-companies-standard.md): Company search on LinkedIn's regular search, not Sales Navigator. - [Create a batch job](https://up2data.ai/docs/v1/api/batch-create.md): Submit up to 1,000 mixed enrich and operation items as one asynchronous job. - [Get a batch job](https://up2data.ai/docs/v1/api/batch-get.md): Poll a batch job for its status and accumulated results, for free. - [Get incremental batch result entries](https://up2data.ai/docs/v1/api/batch-results.md): Read a batch job's result entries as an incremental, cursor-paged feed. - [Get account](https://up2data.ai/docs/v1/api/account-get.md): Balance, tier, monthly credit usage, and rate limits, for free. ## Schemas - [Profile](https://up2data.ai/docs/v1/schemas/profile.md): A full live LinkedIn profile record, as returned by profile enrich and batch profile items. - [Company](https://up2data.ai/docs/v1/schemas/company.md): Live firmographics for a LinkedIn company page, as returned by company enrich and batch company items. - [Post](https://up2data.ai/docs/v1/schemas/post.md): A single LinkedIn post with live engagement counts, as returned by post enrich, batch post items, and profile activity (kind posts or reposts). - [LeadResult](https://up2data.ai/docs/v1/schemas/lead-result.md): One people search result from Sales Navigator, as returned by search people, Sales Navigator people search, and batch people search items. Pipe url into profile enrich for the full record. - [AccountResult](https://up2data.ai/docs/v1/schemas/account-result.md): One company search result from Sales Navigator, as returned by Sales Navigator company search and batch company search items. Pipe url into company enrich for the full record. - [SearchPerson](https://up2data.ai/docs/v1/schemas/search-person.md): One standard people search result: the identity and headline LinkedIn's regular search shows. Pipe url into profile enrich or a batch for the full record. - [SearchCompany](https://up2data.ai/docs/v1/schemas/search-company.md): One standard company search result: what LinkedIn's regular search shows. Pipe url into company enrich or a batch for the full record. - [JobPosting](https://up2data.ai/docs/v1/schemas/job-posting.md): One job search result. - [JobDetail](https://up2data.ai/docs/v1/schemas/job-detail.md): The data object returned by job enrich: the JobPosting fields plus the full description and posting state. - [Recommendation](https://up2data.ai/docs/v1/schemas/recommendation.md): One LinkedIn recommendation, nested under a Profile. - [ProfileRecommendationsResult](https://up2data.ai/docs/v1/schemas/profile-recommendations-result.md): The data object returned by profile recommendations: one block per requested direction. - [Interest](https://up2data.ai/docs/v1/schemas/interest.md): One entity a profile follows: a person, company, group, newsletter, or school. - [ProfileInterestsResult](https://up2data.ai/docs/v1/schemas/profile-interests-result.md): The data object returned by profile interests: one block per requested category. - [CompanyJobsCountResult](https://up2data.ai/docs/v1/schemas/company-jobs-count-result.md): The data object returned by count company job openings. - [CompanyPostsResult](https://up2data.ai/docs/v1/schemas/company-posts-result.md): The data object returned by get company posts. - [CompanyHeadcountResult](https://up2data.ai/docs/v1/schemas/company-headcount-result.md): The data object returned by find custom headcount. - [ProfileActivityResult](https://up2data.ai/docs/v1/schemas/profile-activity-result.md): The data object returned by profile activity: one profile's posts, comments, reactions, or reposts, for the requested kind. - [ActivityComment](https://up2data.ai/docs/v1/schemas/activity-comment.md): One comment a profile left on another member's post, returned by profile activity when kind is comments. - [ActivityReaction](https://up2data.ai/docs/v1/schemas/activity-reaction.md): One reaction a profile gave to another member's post, returned by profile activity when kind is reactions. - [ActivityTargetPost](https://up2data.ai/docs/v1/schemas/activity-target-post.md): The post a profile commented on, reacted to, or reposted, nested under ActivityComment and ActivityReaction. - [PostEngagementResult](https://up2data.ai/docs/v1/schemas/post-engagement-result.md): The data object returned by the post engagement endpoints: who commented on, reacted to, or reposted one post. Inbound engagement only - a profile's own comments, reactions, and reposts come from profile activity. - [EngagementActor](https://up2data.ai/docs/v1/schemas/engagement-actor.md): The member behind one comment, reaction, or repost on a post. - [PostComment](https://up2data.ai/docs/v1/schemas/post-comment.md): One comment left on a post, returned by posts/engagement/comments. - [PostReaction](https://up2data.ai/docs/v1/schemas/post-reaction.md): One reaction given to a post, returned by posts/engagement/reactions. - [PostRepost](https://up2data.ai/docs/v1/schemas/post-repost.md): One repost of a post, returned by posts/engagement/reposts. - [Pagination](https://up2data.ai/docs/v1/schemas/pagination.md): Pagination metadata on Sales Navigator search results, profile activity pages, and post engagement pages. - [BatchJob](https://up2data.ai/docs/v1/schemas/batch-job.md): A batch job just after submission: accepted, not yet resolved. Also the shape of the job field in the batch.completed webhook payload. - [BatchJobResult](https://up2data.ai/docs/v1/schemas/batch-job-result.md): A batch job with its accumulated results, as returned by polling GET /batch/{job_id}. - [BatchResultPage](https://up2data.ai/docs/v1/schemas/batch-result-page.md): A cursor page of immutable, first-seen batch result entries, as returned by GET /batch/{job_id}/results. - [Error](https://up2data.ai/docs/v1/schemas/error.md): The error envelope returned by every /v1 endpoint on failure. - [Account](https://up2data.ai/docs/v1/schemas/account.md): Account state returned by GET /account. - [Meta](https://up2data.ai/docs/v1/schemas/meta.md): The billing metadata object on every successful /v1 response.