EveryData platform API
G2 API
G2 data here means G2 software products, vendors, reviews, categories, alternatives, and existing comparisons, divided among 7 G2 actions with explicit G2 target objects: `search`, `profile`, `reviews`.
Use G2 `search` with `keyword` to discover software records; switch to `profile` with `url` for one selected product page instead of carrying search assumptions into that detail response.
- Endpoint
- POST /api/v1/social
- Capabilities
- 7
- Per 1,000
- $1.389
Available capabilities
Compare the G2 actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on G2. Accepts these parameters: | keyword | sort | Sync delivery | Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | product_name · url · reviews_url · description · vendor_name · vendor_url · rating · rating_scale · rating_out_of_ten · review_count · pricing_type · item_type · rank · is_sponsored · image_url · categories · platform |
profileDetails Retrieve details from G2. Accepts these parameters: | url | sort | Sync delivery | — | $1.39 per 1,000 requests | slug · name · description · url · reviews_url · alternatives_url · vendor_name · vendor_url · rating · rating_scale · rating_out_of_ten · review_count · pricing_tiers · features_text · image_urls · platform |
reviewsReviews Retrieve public reviews from G2. Accepts these parameters: | url | sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | label · mentions · record_type · product_slug · url · aggregate_rating · total_reviews · summary_text · top_pros · top_cons · platform · id · title · text · rating · rating_scale · responses · author_name · author_job_title · author_business_size · product_name · posted_at |
vendorVendor Use the | url | slug, sort, vendor, vendor_url | Sync delivery | — | $1.39 per 1,000 requests | slug · name · url · description · founded · hq_location · ownership · total_revenue · employees · phone · product_count · total_reviews · products · platform · rating · rating_scale · review_count |
alternativesAlternatives Use the | url | sort | Sync delivery | Catalog values: defaultLimit=10, maxLimit=30. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | name · slug · url · description · vendor_name · rating · rating_scale · rating_out_of_ten · review_count · entry_level_price · rank · source_product_slug · image_url · platform |
compareProduct comparison Use the | slugs | combined_slug, products, sort, url | Sync delivery | — | $1.39 per 1,000 requests | url · combined_slug · product_count · products · ratings · alternatives_shown · platform · slug · name · vendor_name · rating · rating_scale · review_count · score · sample_size · note · criterion · per_product |
categoryCategory Retrieve public categories from G2. Accepts these parameters: | category | sort | Sync delivery | Catalog values: defaultLimit=10, maxLimit=40. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | name · slug · url · description · vendor_name · vendor_slug · category · category_slug · rating · rating_scale · rating_out_of_ten · review_count · entry_level_price · rank · page · is_sponsored · awards · image_url · platform |
What does each G2 action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the G2 search parameters mean?
Search public results on G2. Accepts these parameters: sort and keyword. Returns these fields: product_name, rating_out_of_ten, pricing_type, and rating_scale.
keywordRequired- Specifies the search query for discovering software product entries in G2. It matches product catalog entries rather than indexing review body text. Product comparisons, alternatives, and vendor profiles require their respective object identifiers instead.
sortOptional- Sorts reviews using allowed values: newest, relevance (default), or top_rated. Although accepted across shared object endpoints, passing this parameter does not guarantee that product profile details, vendor pages, or comparison lists will change their internal sorting order.Allowed values:
newestrelevancetop_rated
What do the G2 profile parameters mean?
Retrieve details from G2. Accepts these parameters: url and sort. Returns these fields: image_urls, description, vendor_url, and rating_out_of_ten.
urlRequired- Specifies the target G2 resource URL or bare slug. For profile, reviews, and alternatives, pass a /products/<slug> URL or product slug; for vendor, pass a /sellers/<slug> URL or seller slug. For compare, passing a full /compare/ URL overrides auto-generated paths, though the required slugs parameter must still be supplied.G2: Product Star Ratings and Research ScoresG2 star ratings are converted from likelihood-to-recommend responses, whereas the G2 Score also incorporates satisfaction and market presence data. Product star ratings, 10-point survey responses, and research scores represent distinct metrics.Checked
sortOptional- Sorts reviews using allowed values: newest, relevance (default), or top_rated. Although accepted across shared object endpoints, passing this parameter does not guarantee that product profile details, vendor pages, or comparison lists will change their internal sorting order.Allowed values:
newestrelevancetop_rated
What do the G2 reviews parameters mean?
Retrieve public reviews from G2. Accepts these parameters: url and sort. Returns these fields: record_type, total_reviews, title, and responses.
urlRequired- Specifies the target G2 resource URL or bare slug. For profile, reviews, and alternatives, pass a /products/<slug> URL or product slug; for vendor, pass a /sellers/<slug> URL or seller slug. For compare, passing a full /compare/ URL overrides auto-generated paths, though the required slugs parameter must still be supplied.
sortOptional- Sorts reviews using allowed values: newest, relevance (default), or top_rated. Although accepted across shared object endpoints, passing this parameter does not guarantee that product profile details, vendor pages, or comparison lists will change their internal sorting order.Allowed values:
newestrelevancetop_ratedG2: Review Sorting and Pros and ConsG2 default review sorting accounts for recency and feedback quality, alongside options to sort by newest or star rating. Pros and Cons are platform-aggregated summaries, not individual review bodies. This documentation does not expand the allowed values for this parameter.Checked
What do the G2 vendor parameters mean?
Use the vendor action on G2. Accepts these parameters: url, vendor_url, slug, vendor, and sort. Returns these fields: rating, ownership, description, and employees.
urlRequired- Specifies the target G2 resource URL or bare slug. For profile, reviews, and alternatives, pass a /products/<slug> URL or product slug; for vendor, pass a /sellers/<slug> URL or seller slug. For compare, passing a full /compare/ URL overrides auto-generated paths, though the required slugs parameter must still be supplied.
slugOptional- Specifies the path slug for the target resource: product actions accept the slug following /products/, while vendor accepts the vendor slug following /sellers/. Do not mix slugs across object types. Providing a slug does not waive the required url or category parameters for the given action.
sortOptional- Sorts reviews using allowed values: newest, relevance (default), or top_rated. Although accepted across shared object endpoints, passing this parameter does not guarantee that product profile details, vendor pages, or comparison lists will change their internal sorting order.Allowed values:
newestrelevancetop_rated vendorOptional- Specifies either the seller path slug from /sellers/ or a direct vendor page URL. It does not perform a free-text company name search, and vendor action calls must still include the required url parameter.
vendor_urlOptional- Provides the /sellers/<slug> vendor landing page URL as a compatibility input for vendor targeting. It does not replace the required url parameter on the vendor action.
What do the G2 alternatives parameters mean?
Use the alternatives action on G2. Accepts these parameters: sort and url. Returns these fields: entry_level_price, rating, description, and image_url.
urlRequired- Specifies the target G2 resource URL or bare slug. For profile, reviews, and alternatives, pass a /products/<slug> URL or product slug; for vendor, pass a /sellers/<slug> URL or seller slug. For compare, passing a full /compare/ URL overrides auto-generated paths, though the required slugs parameter must still be supplied.G2: Alternative Product Similarity CriteriaG2 orders alternatives based on shared categories, overlapping category reviews, and user comparison behavior. This indicates candidate similarity rather than feature equivalence or migration success guarantees.Checked
sortOptional- Sorts reviews using allowed values: newest, relevance (default), or top_rated. Although accepted across shared object endpoints, passing this parameter does not guarantee that product profile details, vendor pages, or comparison lists will change their internal sorting order.Allowed values:
newestrelevancetop_rated
What do the G2 compare parameters mean?
Use the compare action on G2. Accepts these parameters: products, sort, url, slugs, and combined_slug. Returns these fields: name, combined_slug, score, and rating.
slugsRequired- Specifies an array of product slugs or product URLs for the compare action, which are automatically joined with -vs- to construct the G2 comparison path. This parameter does not execute separate parallel queries or accept vendor names; choose product combinations with existing G2 comparison pages.
combined_slugOptional- Specifies the pre-joined comparison path slug following /compare/ for the compare action, taking precedence over auto-generated slug arrays. It does not accept single vendor-and-product identifiers, and passing an explicit url parameter takes higher precedence.
productsOptional- Acts as a compatibility array input for compare, accepting product slugs or product URLs. Requests must still include the required slugs parameter.
sortOptional- Sorts reviews using allowed values: newest, relevance (default), or top_rated. Although accepted across shared object endpoints, passing this parameter does not guarantee that product profile details, vendor pages, or comparison lists will change their internal sorting order.Allowed values:
newestrelevancetop_rated urlOptional- Specifies the target G2 resource URL or bare slug. For profile, reviews, and alternatives, pass a /products/<slug> URL or product slug; for vendor, pass a /sellers/<slug> URL or seller slug. For compare, passing a full /compare/ URL overrides auto-generated paths, though the required slugs parameter must still be supplied.
What do the G2 category parameters mean?
Retrieve public categories from G2. Accepts these parameters: sort and category. Returns these fields: rating, category_slug, rating_out_of_ten, and category.
categoryRequired- Specifies the G2 software category path slug or full /categories/<slug> URL copied directly from a category page. It does not accept product names or free-form keywords, and accepted values are not restricted to predefined example lists.G2: Category-Specific Comparison BoundariesG2 Scores evaluate products solely within the same category; a single product may receive different scores across different categories. Category ranking cannot be directly extrapolated to cross-category placement.Checked
sortOptional- Sorts reviews using allowed values: newest, relevance (default), or top_rated. Although accepted across shared object endpoints, passing this parameter does not guarantee that product profile details, vendor pages, or comparison lists will change their internal sorting order.Allowed values:
newestrelevancetop_rated
How to use the G2 API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"g2","action":"search","params":{"keyword":"<keyword>"}}'
G2 API questions
What can I retrieve with the G2 API?
Set platform to g2. The current catalog lists search, details, reviews, vendor, alternatives, and more. These action names identify different G2 objects or views; they are not interchangeable search modes.
Which input starts a G2 `search` request?
Specifies the search query for discovering software product entries in G2. It matches product catalog entries rather than indexing review body text. Product comparisons, alternatives, and vendor profiles require their respective object identifiers instead. Send it as keyword inside params.
Which fields can G2 `search` return?
Its declared schema includes product_name, reviews_url, description, and vendor_name. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every G2 action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.