Sikayetvar APIsikayetvar.com ↗
Access brand profiles, paginated complaint feeds, and full complaint text with comments from sikayetvar.com via two structured JSON endpoints.
What is the Sikayetvar API?
The Sikayetvar.com API exposes 2 endpoints covering brand profiles and individual complaints from Turkey's largest consumer complaint platform. get_brand_page returns a brand's satisfaction score, AiVar report card, rated reviews, and up to 24 complaint cards per page. get_complaint returns the full complaint text, ISO-8601 timestamps, site-assigned keywords, upvote count, and all threaded comments for a single complaint.
curl -X GET 'https://api.parse.bot/scraper/a9f3e16c-691b-4bed-9b94-054db651e802/get_brand_page?brand_slug=star-tv' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns one page of a brand's complaint feed on sikayetvar.com together with the brand profile. One round trip per call. `complaints` holds up to 24 complaint cards per page in the site's feed order, one entry per card shown on the page, each with a numeric `id`, `url_path` (pass unchanged to get_complaint), author, view count, a truncated `excerpt`, `is_solved`, `is_hidden`, and, for rated complaints, the complainant's star rating (1-5) and thank-you note; `upvote_count`/`comment_count` are null when the site does not render them on the card. Resolved cards that the site shows only as a rating/thank-you have no `excerpt`; a card the site has hidden (`is_hidden` true) carries only id, author, date, view count, rating and `is_solved`, with `title`, `url_path` and `url` null. Cards whose complaint page is not search-indexed still get their `url_path`, and get_complaint resolves it. Brand profile details (`logo_url`, `address`, `satisfaction_score` 0-100, `rating_count`), the AiVar `report_card` (summary, resolution-success metrics, resolution breakdown, customer thanks, top complaint topics) and the rated `reviews` list are published by the site only on page 1; on later pages they come back null/empty. Paging: `page` defaults to 1; `has_more` is true when the site advertises a next page and `next_page` is the value to pass. Unknown brand slugs return a not-found error. Text is in Turkish as published; `published_at_label` is the site's Turkish date label.
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based page of the complaint feed. |
| brand_slugrequired | string | Brand slug as it appears in the brand's sikayetvar.com URL path (lowercase letters, digits and hyphens), e.g. star-tv. |
{
"type": "object",
"fields": {
"page": "integer page requested",
"brand": "object: slug, name, url, logo_url, external_links (brand's own site/social URLs), address {street, locality, region, country}, satisfaction_score (0-100), satisfaction_score_max, rating_count; profile fields are null on pages > 1",
"reviews": "array of rated reviews the site publishes for the brand: headline, body (truncated), date_published (YYYY-MM-DD), author_name, rating with rating_best/rating_worst",
"has_more": "boolean, true when the site advertises a following page",
"next_page": "integer page to request next, or null",
"complaints": "array of complaint cards in feed order: id (integer), title, url_path, url (title/url_path/url null when is_hidden), author_name, author_url, published_at_label, view_count, excerpt (null when the card shows no body text), upvote_count, comment_count, is_solved, is_hidden, complainant_rating, thank_you_note, image_url, video_poster_url",
"report_card": "AiVar report card object (summary text, metrics [{label, value}], resolution_breakdown [{label, percent}], customer_thanks [{author_name, author_url, text}], top_complaint_topics [{title, items}]) or null when not rendered"
},
"sample": {
"data": {
"page": 3,
"brand": {
"url": "https://www.sikayetvar.com/star-tv",
"name": "Star TV",
"slug": "star-tv",
"address": {
"region": null,
"street": null,
"country": null,
"locality": null
},
"logo_url": null,
"rating_count": null,
"external_links": [
"https://startv.com.tr",
"https://www.facebook.com/startv",
"https://www.instagram.com/startv"
],
"satisfaction_score": null,
"satisfaction_score_max": null
},
"reviews": [],
"has_more": false,
"next_page": null,
"complaints": [
{
"id": 35339977,
"url": "https://www.sikayetvar.com/star-tv/star-tv-dizisinde-alt-yazi-eksikligi-isitme-engellileri-icin-adil-degil",
"title": "Star TV Dizisinde Alt Yazı Eksikliği İşitme Engellileri İçin Adil Değil",
"excerpt": "Star TV’de yayımlanan “Sevgidim Sensin” dizisini severek takip etmek istiyorum ancak işitme engelli olduğum için dizide alt yazı olmadığı zaman hiçbir şey anlayamıyorum.",
"url_path": "/star-tv/star-tv-dizisinde-alt-yazi-eksikligi-isitme-engellileri-icin-adil-degil",
"image_url": null,
"is_hidden": false,
"is_solved": false,
"author_url": "https://www.sikayetvar.com/uye/pinar-16910055",
"view_count": 751,
"author_name": "Pınar",
"upvote_count": null,
"comment_count": null,
"thank_you_note": null,
"video_poster_url": null,
"complainant_rating": null,
"published_at_label": "2 Mart 2026 23:59"
},
{
"id": 35189480,
"url": null,
"title": null,
"excerpt": null,
"url_path": null,
"image_url": null,
"is_hidden": true,
"is_solved": true,
"author_url": "https://www.sikayetvar.com/uye/reyyan-13178823",
"view_count": 73,
"author_name": "Reyyan",
"upvote_count": null,
"comment_count": null,
"thank_you_note": null,
"video_poster_url": null,
"complainant_rating": 5,
"published_at_label": "14 Şubat 2026 23:26"
},
{
"id": 33897012,
"url": "https://www.sikayetvar.com/star-tv/sahipsizler-dizisinde-dini-degerlerin-yanlis-yansitilmasi-rahatsiz-etti",
"title": "Sahipsizler Dizisinde Dini Değerlerin Yanlış Yansıtılması Rahatsız Etti",
"excerpt": "08.10.2025 tarihinde Star TV’de yayımlanan Sahipsizler dizisinde, Zeliha karakterinin canlandırılması ve hoca karakteri ile Zeliha’nın kardeşinin evle",
"url_path": "/star-tv/sahipsizler-dizisinde-dini-degerlerin-yanlis-yansitilmasi-rahatsiz-etti",
"image_url": null,
"is_hidden": false,
"is_solved": true,
"author_url": "https://www.sikayetvar.com/uye/murat-16309572",
"view_count": 1707,
"author_name": "Murat",
"upvote_count": 1,
"comment_count": 0,
"thank_you_note": null,
"video_poster_url": null,
"complainant_rating": 5,
"published_at_label": "8 Ekim 2025 23:46"
}
],
"report_card": null
},
"status": "success"
}
}About the Sikayetvar API
Brand Profile and Complaint Feed
get_brand_page accepts a brand_slug (the lowercase slug from the brand's sikayetvar.com URL, e.g. star-tv) and an optional 1-based page integer. Each response includes a brand object with fields for name, logo_url, external_links, a structured address, and a satisfaction score. The report_card field contains the AiVar summary text, named metrics with values, a resolution breakdown as labeled percentages, and customer-thanks attributions. The complaints array holds up to 24 cards per page, each carrying a numeric id, title, url_path, author_name, published_at_label, view_count, excerpt, and upvote count. Pagination is signaled by has_more (boolean) and next_page (integer or null).
Individual Complaint Detail
get_complaint accepts a complaint_path in the form /<brand-slug>/<complaint-slug> exactly as emitted in complaints[*].url_path from get_brand_page. The response contains the full complaint text, title, brand_name, brand_slug, keywords (a site-assigned string, may be null), view_count, upvote_count (the site's "Destek" metric), and ISO-8601 created/published/modified timestamps using the Europe/Istanbul offset as published. The comments array returns each reply with its text, date_published, author_name, and author_url; it is empty when no comments exist.
Coverage Notes
The API covers public brand pages and public complaints on sikayetvar.com. Brand slugs must match the exact path segment used in sikayetvar.com URLs. Page indexing starts at 1, and results are ordered newest first. The reviews array on get_brand_page reflects rated reviews the site surfaces for the brand, each with a headline, truncated body, date_published, and author_name.
The Sikayetvar API is a managed, monitored endpoint for sikayetvar.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when sikayetvar.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official sikayetvar.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track a brand's satisfaction score and AiVar report-card metrics over time using repeated
get_brand_pagecalls - Aggregate complaint excerpts and upvote counts across all pages to identify the most-discussed issues for a brand
- Feed full complaint text from
get_complaintinto NLP pipelines for Turkish-language sentiment or topic classification - Monitor the
resolution_breakdownpercentages from the report card to benchmark how brands compare on complaint resolution - Collect
commentsarrays from individual complaints to study how brands respond publicly to consumer grievances - Build a brand-reputation dashboard combining
view_count,upvote_count, andpublished_attimestamps across paginated feeds - Extract
external_linksandaddressfields from brand profiles for B2B enrichment or contact data research
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does sikayetvar.com offer an official developer API?+
What does `get_brand_page` return beyond complaint cards?+
get_brand_page returns a full brand object (slug, name, logo URL, external links, address, satisfaction score), a reviews array of rated reviews with headlines and dates, and a report_card object containing an AiVar summary, named metrics with values, resolution percentages, and customer-thanks entries — all in one response alongside the paginated complaints array.Can I retrieve complaints in a language other than Turkish, or filter by date range or complaint status?+
Does the API return complaints for any brand, or only specific ones?+
brand_slug to get_brand_page. The slug must match the exact path segment in the brand's sikayetvar.com URL. Private or removed brand pages are not covered. If a brand you need is missing or returns no results, you can fork the API on Parse and revise it to handle alternate slug formats or additional brand discovery.Are complaint author identities or brand responses exposed in the data?+
author_name and author_url as published publicly on the site. The comments array on get_complaint includes replies with author name, URL, and date. Dedicated brand-side response metadata (e.g. a structured resolved/unresolved status field) is not a separate field in the current response shape. You can fork the API on Parse and revise it to surface additional comment-author role signals if the source exposes them.