ScrapeField

Response objects

Each platform in its own shape. A Google Maps place looks like a Google Maps place and a TikTok video like a TikTok video, named the way the platform itself names them.

The four platforms are four different systems. A place has opening hours and a price level; a video has a sound and a duet setting; a LinkedIn profile has experience and education. Forcing them into one “profile” and one “post” would hide exactly the fields you came for, so we don’t. Each object is named after the platform’s own developer API where one describes the same thing — if you have read those docs, you already know these fields:

  • Google Maps: named after Google's Places API.
  • LinkedIn: named after LinkedIn's own pages, since LinkedIn has no public data API.
  • Instagram: named after Instagram's Graph API.
  • TikTok: named after TikTok's Display and Research APIs.

What is the same everywhere

The conventions, not the shapes. The { data, meta } envelope and the error format. snake_case keys. Timestamps as ISO 8601 in UTC. The platform’s own ids, as strings, so you can join them to anything else you hold. Counts as integers.

Every key, every time. An object carries every field listed here on every call. A field is null when the platform does not show it — never 0, never a guess — and a list is empty rather than missing. You can index into a response without checking whether a key exists.

Nothing else. The fields below are an allowlist the gateway enforces: anything not on it is dropped before a response leaves, so a field never appears that is not documented here.

Google Maps

google_maps_place

One business or place, as its Google Maps listing shows it. Returned by google-maps/places, google-maps/place.

FieldWhat it is
place_id
string
Google's place ID — the same one the Places API and every Maps URL use.
name
string
As the listing shows it.
category
string · or null
The category printed under the name, e.g. "Coffee shop".
categories
array of strings
Every category on the listing, the main one first.
formatted_address
string · or null
The address as one line, as Google formats it.
address
object
The same address in parts.
address.street
string · or null
Street and number.
address.city
string · or null
address.region
string · or null
State, province or region.
address.postal_code
string · or null
address.country_code
string · or null
ISO 3166-1 alpha-2, e.g. US.
location
object
The pin.
location.lat
number
Latitude.
location.lng
number
Longitude.
plus_code
string · or null
The global plus code, e.g. 87G8P2QX+RV.
rating
number · or null
The star rating, 1.0–5.0. null until the place has ratings.
user_ratings_total
integer · or null
How many ratings the star rating is the average of.
rating_distribution
object · or null
How many ratings of each star value, as the listing's bar chart shows them.
rating_distribution.1
integer
rating_distribution.2
integer
rating_distribution.3
integer
rating_distribution.4
integer
rating_distribution.5
integer
price_level
integer · or null
0 (free) to 4 (very expensive), as the Places API counts it.
formatted_phone_number
string · or null
The phone number in local format.
international_phone_number
string · or null
With the country code, e.g. +1 718-555-0142.
website
URL · or null
The business's own site.
url
URL
The place on Google Maps.
business_status
string, one of
As the Places API reports it.
OPERATIONAL · CLOSED_TEMPORARILY · CLOSED_PERMANENTLY
opening_hours
object · or null
Regular opening hours. null when the listing has none.
opening_hours.weekday_text
array of strings
Seven lines, Monday first, as the listing prints them.
opening_hours.periods
array of objects
The same hours as data. A place open around the clock has one period with no close.
opening_hours.periods[].open
object
opening_hours.periods[].open.day
integer
0 is Sunday.
opening_hours.periods[].open.time
string
24-hour HHMM, local time.
opening_hours.periods[].close
object · or null
opening_hours.periods[].close.day
integer
0 is Sunday.
opening_hours.periods[].close.time
string
24-hour HHMM, local time.
popular_times
array of objects · or null
The "Popular times" chart. null for places too quiet to have one.
popular_times[].day
integer
0 is Sunday.
popular_times[].busyness
array of integers
Twenty-four values, midnight first, 0–100 relative to the place's busiest hour.
about
object, by heading
The listing's About tab, by heading: service_options, accessibility, amenities, payments and so on — only the headings the place has.
claimed
boolean · or null
Whether the owner has claimed the listing. Unclaimed ones offer "Own this business?".
photo
object · or null
The listing's main photo.
photo.url
URL
The image on Google's CDN. We do not rehost images.
photo.width
integer · or null
Pixels.
photo.height
integer · or null
Pixels.
photo.author_name
string · or null
Who uploaded it, as the listing credits them. null for the owner's own photos.
photo.author_url
URL · or null
Their Google Maps contributor page.

google_maps_review

One Google review of a place. Returned by google-maps/reviews.

FieldWhat it is
review_id
string
Google's id for the review.
place_id
string
The place it is about.
author
object
author.name
string
As shown on the review.
author.url
URL · or null
Their Google Maps contributor page.
author.profile_photo_url
URL · or null
author.is_local_guide
boolean
Whether they carry the Local Guide badge.
author.review_count
integer · or null
How many reviews they have written, as the review shows.
author.photo_count
integer · or null
How many photos they have posted.
rating
integer
1 to 5.
text
string · or null
null for a rating with no words.
language
string · or null
Two-letter code of the language it was written in.
publish_time
time, ISO 8601 UTC
When it was posted.
like_count
integer · or null
How many people marked it helpful.
photos
array of objects
Photos attached to the review.
photos[].url
URL
The image on Google's CDN. We do not rehost images.
photos[].width
integer · or null
Pixels.
photos[].height
integer · or null
Pixels.
photos[].author_name
string · or null
Who uploaded it, as the listing credits them. null for the owner's own photos.
photos[].author_url
URL · or null
Their Google Maps contributor page.
owner_response
object · or null
The "Response from the owner", where there is one.
owner_response.text
string
owner_response.publish_time
time, ISO 8601 UTC · or null

google_maps_photo

One photo on a place's listing. Returned by google-maps/photos.

FieldWhat it is
url
URL
The image on Google's CDN. We do not rehost images.
width
integer · or null
Pixels.
height
integer · or null
Pixels.
author_name
string · or null
Who uploaded it, as the listing credits them. null for the owner's own photos.
author_url
URL · or null
Their Google Maps contributor page.

LinkedIn

linkedin_profile

A public LinkedIn profile, as a logged-out visitor sees it. Returned by linkedin/profile.

FieldWhat it is
vanity_name
string
The part after /in/ in the profile URL.
url
URL
The profile.
full_name
string
first_name
string · or null
last_name
string · or null
headline
string · or null
The line under the name.
about
string · or null
The About section.
location
string · or null
As printed, e.g. "Berlin, Germany".
profile_picture_url
URL · or null
follower_count
integer · or null
connection_count
integer · or null
LinkedIn stops counting at 500: a value of 500 means "500+".
open_to_work
boolean · or null
Whether the profile shows the #OpenToWork frame.
current_company
object · or null
The employer shown at the top of the profile.
current_company.name
string
current_company.url
URL · or null
The company page, where it has one.
experience
array of objects
Positions, most recent first.
experience[].title
string
experience[].company
object
The employer.
experience[].company.name
string
experience[].company.url
URL · or null
The company page, where it has one.
experience[].employment_type
string · or null
As printed: "Full-time", "Contract", …
experience[].location
string · or null
experience[].start_date
string · or null
YYYY-MM, or YYYY where the profile gives only a year.
experience[].end_date
string · or null
YYYY-MM or YYYY; null for a current role, or where the profile gives no date.
experience[].description
string · or null
education
array of objects
Schools, most recent first.
education[].school
object
The school, and its LinkedIn page where it has one.
education[].school.name
string
education[].school.url
URL · or null
The company page, where it has one.
education[].degree
string · or null
education[].field_of_study
string · or null
education[].start_year
integer · or null
education[].end_year
integer · or null
skills
array of strings
As listed on the profile.

linkedin_company

A public LinkedIn company page. Returned by linkedin/company.

FieldWhat it is
company_id
string
LinkedIn's numeric id for the company.
vanity_name
string
The part after /company/ in the page URL.
url
URL
The company page.
name
string
tagline
string · or null
The line under the name.
description
string · or null
The About overview.
website
URL · or null
industry
string · or null
company_size
string · or null
The band LinkedIn prints, e.g. "51-200 employees".
employees_on_linkedin
integer · or null
How many members list it as their employer.
headquarters
object · or null
headquarters.city
string · or null
headquarters.geographic_area
string · or null
State or region.
headquarters.country
string · or null
ISO 3166-1 alpha-2.
company_type
string · or null
As printed: "Privately Held", "Public Company", …
founded
integer · or null
The year.
specialties
array of strings
follower_count
integer · or null
logo_url
URL · or null

linkedin_post

A public LinkedIn post. Returned by linkedin/posts.

FieldWhat it is
urn
string
LinkedIn's id for the post, e.g. urn:li:activity:7243….
url
URL
The post.
author
object
author.name
string
author.type
string, one of
person · company
author.headline
string · or null
The person's headline, or the company's follower line.
author.url
URL
Their profile or company page.
text
string · or null
The post's text.
published_at
time, ISO 8601 UTC
reaction_count
integer
All reactions together.
reactions
object · or null
By kind, where LinkedIn shows the breakdown.
reactions.like
integer
reactions.celebrate
integer
reactions.support
integer
reactions.love
integer
reactions.insightful
integer
reactions.funny
integer
comment_count
integer
repost_count
integer
images
array of URLs
Image URLs, in order.
video
object · or null
video.url
URL
video.duration
integer · or null
Seconds.
document
object · or null
An attached PDF or slide deck.
document.title
string
document.page_count
integer · or null
article
object · or null
A shared link.
article.title
string
article.url
URL
is_repost
boolean
Whether this is someone else's post reposted without comment.

linkedin_job

A public LinkedIn job posting. Returned by linkedin/jobs.

FieldWhat it is
job_id
string
LinkedIn's numeric id — the number in /jobs/view/….
url
URL
The posting.
title
string
company
object
Who is hiring.
company.name
string
company.url
URL · or null
The company page, where it has one.
location
string · or null
As printed, e.g. "Berlin, Germany".
workplace_type
string, one of · or null
On-site · Hybrid · Remote
employment_type
string · or null
"Full-time", "Part-time", "Contract", …
seniority_level
string · or null
"Entry level", "Mid-Senior level", …
salary
string · or null
As printed, where the posting shows one, e.g. "€70K/yr - €90K/yr".
listed_at
time, ISO 8601 UTC
When it was posted.
easy_apply
boolean · or null
Whether it takes applications on LinkedIn. null where the listing does not say.
description
string · or null
The full description, as text.

Instagram

instagram_profile

A public Instagram account. Returned by instagram/profile.

FieldWhat it is
id
string
Instagram's numeric id for the account.
username
string
Without the @.
name
string · or null
The display name.
biography
string · or null
website
URL · or null
The link in the bio.
bio_links
array of objects
Every link in the bio.
bio_links[].title
string · or null
bio_links[].url
URL
profile_picture_url
URL · or null
followers_count
integer
follows_count
integer
media_count
integer
Posts on the grid.
is_verified
boolean
is_private
boolean
A private account shows its counts and nothing else.
is_business_account
boolean
A business or creator account.
category
string · or null
The label under the name, e.g. "Bakery" or "Public figure".
business_email
string · or null
Behind the Email button, where a business account shows one.
business_phone_number
string · or null
Behind the Call button.
highlight_reel_count
integer
Story highlights on the profile.

instagram_post

A public Instagram post or Reel. Returned by instagram/posts, instagram/post, instagram/hashtag.

FieldWhat it is
id
string
Instagram's numeric id for the post.
shortcode
string
The code in the URL, e.g. C1a2B3c4D5e.
permalink
URL
The post.
media_type
string, one of
As the Graph API names them.
IMAGE · VIDEO · CAROUSEL_ALBUM
media_product_type
string, one of
A grid post or a Reel.
FEED · REELS
caption
string · or null
timestamp
time, ISO 8601 UTC
When it was posted.
username
string
Who posted it.
media_url
URL
The image, or the video file. A carousel's first item.
thumbnail_url
URL · or null
The cover of a video.
children
array of objects
A carousel's items, in order. Empty for a single image or video.
children[].media_type
string, one of
IMAGE · VIDEO
children[].media_url
URL
video_duration
number · or null
Seconds.
like_count
integer · or null
null when the owner has hidden it.
comments_count
integer
view_count
integer · or null
Views, for videos and Reels.
hashtags
array of strings
The caption's hashtags, without the #.
mentions
array of strings
The usernames the caption mentions, without the @.
location
object · or null
The location tag.
location.id
string
location.name
string
is_paid_partnership
boolean
Whether it carries the "Paid partnership" label.

instagram_comment

A comment on an Instagram post. Returned by instagram/comments.

FieldWhat it is
id
string
media_id
string
The post it is on.
parent_id
string · or null
The comment it replies to. null for a top-level comment.
username
string
text
string
timestamp
time, ISO 8601 UTC
like_count
integer
reply_count
integer

TikTok

tiktok_profile

A public TikTok account. Returned by tiktok/profile, tiktok/search.

FieldWhat it is
username
string
Without the @.
display_name
string · or null
bio_description
string · or null
bio_url
URL · or null
The link in the bio.
avatar_url
URL · or null
profile_url
URL
The profile.
is_verified
boolean
follower_count
integer
following_count
integer
likes_count
integer
Likes across all their videos.
video_count
integer

tiktok_video

A public TikTok video. Returned by tiktok/videos, tiktok/video, tiktok/search.

FieldWhat it is
id
string
TikTok's numeric id — the number at the end of the URL.
share_url
URL
The video.
username
string
Who posted it.
video_description
string · or null
The caption.
create_time
time, ISO 8601 UTC
When it was posted.
duration
integer
Seconds.
cover_image_url
URL · or null
play_url
URL · or null
The video file on TikTok's CDN. TikTok signs it and it stops working after a while, so fetch it soon. We do not rehost videos.
view_count
integer
like_count
integer
comment_count
integer
share_count
integer
favorites_count
integer · or null
Saves. null where the page does not show them.
hashtag_names
array of strings
Without the #.
region_code
string · or null
Where it was posted from, ISO 3166-1 alpha-2.
music
object · or null
The sound.
music.id
string
music.title
string
music.author
string · or null
music.original
boolean
An original sound rather than a track.
duet_enabled
boolean
stitch_enabled
boolean

tiktok_comment

A comment on a TikTok video. Returned by tiktok/comments.

FieldWhat it is
id
string
video_id
string
The video it is on.
parent_comment_id
string · or null
The comment it replies to. null for a top-level comment.
username
string
text
string
create_time
time, ISO 8601 UTC
like_count
integer
reply_count
integer

tiktok_hashtag

A TikTok hashtag, from a search. Returned by tiktok/search.

FieldWhat it is
hashtag_name
string
Without the #.
url
URL
The hashtag page.
video_count
integer · or null
view_count
integer · or null