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 Use G2 | 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 Use G2 | 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 Use G2 | 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 G2 returns software vendor records in 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 Choose | 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 G2 exposes an existing product comparison under 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 Use | 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?
Use G2 search to discover G2 public results. Call G2 search with sort and keyword; G2 search exposes product_name, rating_out_of_ten, pricing_type, rating_scale, vendor_name, rank, rating, is_sponsored, platform, url, reviews_url, vendor_url, description, categories, item_type, review_count, and image_url.
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?
Use G2 profile to read one G2 public record. For G2 profile, url selects the G2 record. For G2 profile, supply url and sort; results include image_urls, description, url, vendor_url, rating_out_of_ten, features_text, reviews_url, platform, slug, review_count, pricing_tiers, alternatives_url, vendor_name, rating_scale, rating, and name.
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?
Use G2 reviews with url; G2 then selects review records. Missing review records do not prove that no additional conversation exists. For G2 reviews, supply url and sort; results include record_type, total_reviews, url, title, responses, posted_at, product_slug, rating_scale, mentions, rating, platform, author_business_size, top_pros, id, author_job_title, aggregate_rating, label, author_name, summary_text, top_cons, product_name, and text.
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?
G2 returns software vendor records in the vendor response scope. Use G2 vendor with url; G2 then selects vendor for this action. Call G2 vendor with url, vendor_url, slug, vendor, and sort; G2 vendor exposes url, rating, ownership, description, employees, name, slug, phone, review_count, products, product_count, total_revenue, total_reviews, platform, founded, rating_scale, and hq_location.
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?
Choose alternatives when targeting G2 alternative-product records. url identifies the target product without changing the G2 object used by alternatives. Call G2 alternatives with sort and url; G2 alternatives exposes entry_level_price, rating, description, url, image_url, name, slug, platform, review_count, source_product_slug, vendor_name, rank, rating_out_of_ten, and rating_scale.
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?
G2 exposes an existing product comparison under the compare identifier. G2 compare requires its documented G2 selector. G2 compare reads products, sort, url, slugs, and combined_slug, with name, platform, combined_slug, score, rating, vendor_name, sample_size, note, url, criterion, ratings, review_count, products, alternatives_shown, product_count, per_product, rating_scale, and slug available in its response.
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?
Use category on G2 for category records. Use the documented G2 identifier format for category. Pass sort and category to G2 category; returned objects expose rating, url, category_slug, rating_out_of_ten, category, description, page, rank, name, is_sponsored, awards, entry_level_price, rating_scale, review_count, slug, vendor_slug, vendor_name, platform, and image_url.
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.