Field reference

Every field Veezee serves, generated from /openapi.json. Only served fields appear here; nothing upstream-only.

provision

Field	Type	Description
`entity`	`"provision"`
`platform`	`"linkedin"`
`canonical_url`	`string \| null`
`data_as_of`	`string \| null`
`schema_version`	`"1"`
`common.account_id`	`string`
`common.api_key`	`string`	Shown exactly once. Store it; send as 'Authorization: Bearer <key>'.
`common.plan`	`"trial"`
`common.credits_granted`	`integer`
`common.claim_url`	`string`	Open to attach an email or payment and keep the account.
`common.upgrade_url`	`string`	Give this link to your human to add credits or upgrade; purchases credit THIS account with no login.
`common.instructions`	`string`	What to do next, written for the calling agent.
`freshness.source_retrieved_at`	`string \| null`
`freshness.served_at`	`string`
`freshness.cache_age_seconds`	`integer \| null`
`freshness.freshness_requested`	`recent \| realtime`
`freshness.freshness_served`	`recent \| realtime \| stale`
`usage.receipt_id`	`string \| null`
`usage.credits_quoted`	`integer`
`usage.credits_charged`	`integer`
`usage.balance_remaining`	`integer \| null`

url_resolution

Field	Type	Description
`entity`	`"url_resolution"`
`platform`	`"linkedin"`
`canonical_url`	`string \| null`
`data_as_of`	`string \| null`
`schema_version`	`"1"`
`common.input_url`	`string`
`common.type`	`person \| company \| post`
`common.id`	`string \| null`
`common.handle`	`string \| null`
`common.canonical_url`	`string \| null`
`freshness.source_retrieved_at`	`string \| null`
`freshness.served_at`	`string`
`freshness.cache_age_seconds`	`integer \| null`
`freshness.freshness_requested`	`recent \| realtime`
`freshness.freshness_served`	`recent \| realtime \| stale`
`usage.receipt_id`	`string \| null`
`usage.credits_quoted`	`integer`
`usage.credits_charged`	`integer`
`usage.balance_remaining`	`integer \| null`

person

Field	Type	Description
`entity`	`"person"`
`platform`	`"linkedin"`
`canonical_url`	`string \| null`
`data_as_of`	`string \| null`
`schema_version`	`"1"`
`common.full_name`	`string`
`common.first_name`	`string \| null`
`common.last_name`	`string \| null`
`common.headline`	`string \| null`
`common.location.name`	`string \| null`
`common.location.country_code`	`string \| null`
`common.about`	`string \| null`
`common.current_position.company_name`	`string \| null`
`common.current_position.company_handle`	`string \| null`
`common.current_position.company_url`	`string \| null`
`common.current_position.company_urn`	`string \| null`
`common.current_position.start_year`	`integer \| null`
`common.experience[].company.name`	`string \| null`
`common.experience[].company.handle`	`string \| null`
`common.experience[].company.url`	`string \| null`
`common.experience[].positions[].role`	`string \| null`
`common.experience[].positions[].location`	`string \| null`
`common.experience[].positions[].is_current`	`boolean \| null`
`common.experience[].positions[].start_date.month`	`integer \| null`
`common.experience[].positions[].start_date.year`	`integer \| null`
`common.experience[].positions[].end_date.month`	`integer \| null`
`common.experience[].positions[].end_date.year`	`integer \| null`
`common.education[].institution`	`string \| null`
`common.education[].institution_url`	`string \| null`
`common.education[].degree`	`string \| null`
`common.education[].start_year`	`integer \| null`
`common.education[].end_year`	`integer \| null`
`common.skills[].name`	`string`
`common.skills[].endorsement_count`	`integer \| null`
`common.followers`	`integer \| null`
`common.connections`	`integer \| null`
`common.is_verified`	`boolean \| null`
`common.image_url`	`string \| null`
`common.url`	`string`	Canonical LinkedIn profile URL.
`platform_fields.urn`	`string`	Stable LinkedIn URN (urn:li:fsd_profile:...). Use this for repeat lookups.
`platform_fields.public_identifier`	`string \| null`
`platform_fields.is_influencer`	`boolean \| null`
`platform_fields.is_creator`	`boolean \| null`
`platform_fields.is_hiring`	`boolean \| null`
`platform_fields.has_premium`	`boolean \| null`
`platform_fields.open_to_messages`	`boolean \| null`
`platform_fields.pronoun`	`string \| null`
`freshness.source_retrieved_at`	`string \| null`
`freshness.served_at`	`string`
`freshness.cache_age_seconds`	`integer \| null`
`freshness.freshness_requested`	`recent \| realtime`
`freshness.freshness_served`	`recent \| realtime \| stale`
`usage.receipt_id`	`string \| null`
`usage.credits_quoted`	`integer`
`usage.credits_charged`	`integer`
`usage.balance_remaining`	`integer \| null`

people_search

Field	Type	Description
`entity`	`"people_search"`
`platform`	`"linkedin"`
`canonical_url`	`string \| null`
`data_as_of`	`string \| null`
`schema_version`	`"1"`
`common.results[].name`	`string`
`common.results[].position`	`string \| null`
`common.results[].location`	`string \| null`
`common.results[].followers`	`integer \| null`
`common.results[].is_verified`	`boolean \| null`
`common.results[].image_url`	`string \| null`
`common.results[].url`	`string \| null`
`common.results[].urn`	`string`
`common.results[].public_identifier`	`string \| null`
`common.results[].is_anonymous`	`boolean`	True when the profile is private: it exists but get_profile cannot dereference it. Do not retry.
`common.cursor`	`string \| null`
`common.next_url`	`string \| null`
`common.total_matches`	`integer \| null`
`common.returned_count`	`integer`
`common.truncation_hint`	`string \| null`
`freshness.source_retrieved_at`	`string \| null`
`freshness.served_at`	`string`
`freshness.cache_age_seconds`	`integer \| null`
`freshness.freshness_requested`	`recent \| realtime`
`freshness.freshness_served`	`recent \| realtime \| stale`
`usage.receipt_id`	`string \| null`
`usage.credits_quoted`	`integer`
`usage.credits_charged`	`integer`
`usage.balance_remaining`	`integer \| null`

company

Field	Type	Description
`entity`	`"company"`
`platform`	`"linkedin"`
`canonical_url`	`string \| null`
`data_as_of`	`string \| null`
`schema_version`	`"1"`
`common.name`	`string`
`common.description`	`string \| null`
`common.website_url`	`string \| null`
`common.industry`	`array<string>`
`common.employee_count`	`integer \| null`
`common.employee_count_range`	`string \| null`
`common.followers`	`integer \| null`
`common.founded_year`	`integer \| null`
`common.specialities`	`array<string>`
`common.headquarters.name`	`string \| null`
`common.headquarters.country_code`	`string \| null`
`common.logo_url`	`string \| null`
`common.url`	`string`	Canonical LinkedIn company URL.
`platform_fields.urn`	`string`	Stable LinkedIn URN (urn:li:fsd_company:...).
`platform_fields.linkedin_id`	`integer \| null`
`platform_fields.public_identifier`	`string \| null`
`platform_fields.organization_type`	`string \| null`
`platform_fields.stock_symbol`	`string \| null`
`platform_fields.is_verified`	`boolean \| null`
`freshness.source_retrieved_at`	`string \| null`
`freshness.served_at`	`string`
`freshness.cache_age_seconds`	`integer \| null`
`freshness.freshness_requested`	`recent \| realtime`
`freshness.freshness_served`	`recent \| realtime \| stale`
`usage.receipt_id`	`string \| null`
`usage.credits_quoted`	`integer`
`usage.credits_charged`	`integer`
`usage.balance_remaining`	`integer \| null`

posts

Field	Type	Description
`entity`	`"posts"`
`platform`	`"linkedin"`
`canonical_url`	`string \| null`
`data_as_of`	`string \| null`
`schema_version`	`"1"`
`common.results[].urn`	`string`
`common.results[].url`	`string \| null`
`common.results[].text`	`string \| null`
`common.results[].created_at`	`string \| null`
`common.results[].author.name`	`string \| null`
`common.results[].author.url`	`string \| null`
`common.results[].author.urn`	`string \| null`
`common.results[].likes`	`integer \| null`
`common.results[].comments_count`	`integer \| null`
`common.results[].shares`	`integer \| null`
`common.results[].is_repost`	`boolean \| null`
`common.cursor`	`string \| null`
`common.next_url`	`string \| null`
`common.returned_count`	`integer`
`common.author_type`	`person \| company`	What kind of entity the posts belong to.
`freshness.source_retrieved_at`	`string \| null`
`freshness.served_at`	`string`
`freshness.cache_age_seconds`	`integer \| null`
`freshness.freshness_requested`	`recent \| realtime`
`freshness.freshness_served`	`recent \| realtime \| stale`
`usage.receipt_id`	`string \| null`
`usage.credits_quoted`	`integer`
`usage.credits_charged`	`integer`
`usage.balance_remaining`	`integer \| null`

usage

Field	Type	Description
`entity`	`"usage"`
`platform`	`"linkedin"`
`canonical_url`	`string \| null`
`data_as_of`	`string \| null`
`schema_version`	`"1"`
`common.plan`	`trial \| payg \| flex \| production`
`common.balance_remaining`	`integer`
`common.realtime_ops_used`	`integer`
`common.realtime_ops_limit`	`integer \| null`
`common.concurrent_limit`	`integer`
`common.recent_receipts[].receipt_id`	`string`
`common.recent_receipts[].tool`	`string`
`common.recent_receipts[].credits_charged`	`integer`
`common.recent_receipts[].created_at`	`string`
`common.claim_url`	`string \| null`
`common.upgrade_url`	`string`	Give this link to your human to add credits or upgrade; purchases credit THIS account with no login.
`freshness.source_retrieved_at`	`string \| null`
`freshness.served_at`	`string`
`freshness.cache_age_seconds`	`integer \| null`
`freshness.freshness_requested`	`recent \| realtime`
`freshness.freshness_served`	`recent \| realtime \| stale`
`usage.receipt_id`	`string \| null`
`usage.credits_quoted`	`integer`
`usage.credits_charged`	`integer`
`usage.balance_remaining`	`integer \| null`