{"openapi":"3.0.3","info":{"title":"Scrapier API","version":"2.0.0","description":"Web scraping API. Every call is synchronous and returns {\"success\": true, \"data\": {...}}; paginate with `cursor`. Credits: cost_credit per successful call, however many results; failed calls are free. Docs: https://docs.scrapier.io"},"servers":[{"url":"https://api.scrapier.io/api/v2"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"Error":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"string"},"detail":{"type":"string"},"balance":{"type":"integer","description":"402 only: current credit balance."},"required":{"type":"integer","description":"402 only: credits one call needs."}}}},"responses":{"E400":{"description":"Invalid parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E401":{"description":"Missing API key (send it as X-API-Key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E402":{"description":"Not enough credits to cover this call. Failed calls are never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E403":{"description":"Invalid or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E404":{"description":"Unknown endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E429":{"description":"Too many requests. Back off and retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E500":{"description":"The scrape failed. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E502":{"description":"The scrape failed or timed out upstream. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E503":{"description":"At capacity. Retry after the Retry-After header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E504":{"description":"The scrape exceeded its time limit. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/airbnb-availability-calendar/":{"get":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Availability Calendar","operationId":"get_airbnb_availability_calendar","parameters":[{"name":"urls","in":"query","required":true,"description":"Airbnb room URL or numeric listing id (one listing per cursor). Required first call.","schema":{"type":"string","default":"https://www.airbnb.com/rooms/860663943931949474","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"First check-in date YYYY-MM-DD (empty = today). Locked in cursor.","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Last check-in date (empty = start_date + 89 days, max 366-day range). Locked in cursor.","schema":{"type":"string","format":"date"}},{"name":"stay_days","in":"query","required":false,"description":"Nights per stay. Locked in cursor.","schema":{"type":"integer","default":1,"minimum":1,"maximum":365}},{"name":"adults","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":2,"minimum":1,"maximum":16}},{"name":"children","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":0,"minimum":0,"maximum":15}},{"name":"infants","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":0,"minimum":0,"maximum":5}},{"name":"pets","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":0,"minimum":0,"maximum":5}},{"name":"currency","in":"query","required":false,"description":"ISO price currency. Locked in cursor.","schema":{"type":"string"}},{"name":"enrich_with_pricing","in":"query","required":false,"description":"Add price, fees and cancellation policy per date (slower). Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Availability Calendar","operationId":"post_airbnb_availability_calendar","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.airbnb.com/rooms/860663943931949474","format":"uri","description":"Airbnb room URL or numeric listing id (one listing per cursor). Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"start_date":{"type":"string","format":"date","description":"First check-in date YYYY-MM-DD (empty = today). Locked in cursor."},"end_date":{"type":"string","format":"date","description":"Last check-in date (empty = start_date + 89 days, max 366-day range). Locked in cursor."},"stay_days":{"type":"integer","default":1,"minimum":1,"maximum":365,"description":"Nights per stay. Locked in cursor."},"adults":{"type":"integer","default":2,"minimum":1,"maximum":16,"description":"Locked in cursor."},"children":{"type":"integer","default":0,"minimum":0,"maximum":15,"description":"Locked in cursor."},"infants":{"type":"integer","default":0,"minimum":0,"maximum":5,"description":"Locked in cursor."},"pets":{"type":"integer","default":0,"minimum":0,"maximum":5,"description":"Locked in cursor."},"currency":{"type":"string","description":"ISO price currency. Locked in cursor."},"enrich_with_pricing":{"type":"boolean","default":false,"description":"Add price, fees and cancellation policy per date (slower). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/airbnb-images/":{"get":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Images","operationId":"get_airbnb_images","parameters":[{"name":"urls","in":"query","required":true,"description":"Airbnb room URL or numeric listing id. Lookup endpoint -- next_cursor null.","schema":{"type":"string","default":"https://www.airbnb.com/rooms/782682596976136912","format":"uri"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Images","operationId":"post_airbnb_images","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.airbnb.com/rooms/782682596976136912","format":"uri","description":"Airbnb room URL or numeric listing id. Lookup endpoint -- next_cursor null."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/airbnb-listings/":{"get":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Listing Search","operationId":"get_airbnb_listings","parameters":[{"name":"query","in":"query","required":true,"description":"Location to search (city, neighborhood, etc.). Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"London"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"checkin","in":"query","required":false,"description":"Check-in date (YYYY-MM-DD). Locked into the cursor on first call.","schema":{"type":"string","default":"2026-12-01","format":"date"}},{"name":"checkout","in":"query","required":false,"description":"Check-out date (YYYY-MM-DD). Locked into the cursor on first call.","schema":{"type":"string","default":"2026-12-08","format":"date"}},{"name":"currency","in":"query","required":false,"description":"Currency code (USD, EUR, GBP, ...). Locked into the cursor.","schema":{"type":"string","default":"USD"}},{"name":"locale","in":"query","required":false,"description":"Locale (en-US, fr-FR, ...). Locked into the cursor.","schema":{"type":"string","default":"en-US"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Listing Search","operationId":"post_airbnb_listings","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"London","description":"Location to search (city, neighborhood, etc.). Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"checkin":{"type":"string","default":"2026-12-01","format":"date","description":"Check-in date (YYYY-MM-DD). Locked into the cursor on first call."},"checkout":{"type":"string","default":"2026-12-08","format":"date","description":"Check-out date (YYYY-MM-DD). Locked into the cursor on first call."},"currency":{"type":"string","default":"USD","description":"Currency code (USD, EUR, GBP, ...). Locked into the cursor."},"locale":{"type":"string","default":"en-US","description":"Locale (en-US, fr-FR, ...). Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["query"]}}}}}},"/airbnb-occupancy/":{"get":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Occupancy / Availability","operationId":"get_airbnb_occupancy","parameters":[{"name":"room_id","in":"query","required":true,"description":"Airbnb listing ID (or a /rooms/<id> URL). Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"569049214818933247"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"month","in":"query","required":false,"description":"Starting month (1–12). Cursor advances this by 1 each page.","schema":{"type":"integer","default":12,"minimum":1,"maximum":12}},{"name":"year","in":"query","required":false,"description":"Starting year. Cursor handles the month → year rollover automatically.","schema":{"type":"integer","default":2026,"minimum":2024,"maximum":2030}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Occupancy / Availability","operationId":"post_airbnb_occupancy","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"room_id":{"type":"string","default":"569049214818933247","description":"Airbnb listing ID (or a /rooms/<id> URL). Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"month":{"type":"integer","default":12,"minimum":1,"maximum":12,"description":"Starting month (1–12). Cursor advances this by 1 each page."},"year":{"type":"integer","default":2026,"minimum":2024,"maximum":2030,"description":"Starting year. Cursor handles the month → year rollover automatically."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["room_id"]}}}}}},"/airbnb-price-tracker/":{"get":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Price Tracker","operationId":"get_airbnb_price_tracker","parameters":[{"name":"url","in":"query","required":true,"description":"Airbnb listing URL. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"https://www.airbnb.com/rooms/569049214818933247","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"check_in_date","in":"query","required":false,"description":"Starting check-in date (YYYY-MM-DD). Cursor advances this by 30 days per page.","schema":{"type":"string","default":"2026-12-01","format":"date"}},{"name":"stay_days","in":"query","required":false,"description":"Length (nights) of each daily quote. Locked into the cursor.","schema":{"type":"integer","default":3}},{"name":"adults","in":"query","required":false,"description":"Adult guests","schema":{"type":"integer","default":2}},{"name":"children","in":"query","required":false,"description":"Child guests","schema":{"type":"integer","default":0}},{"name":"infants","in":"query","required":false,"description":"Infant guests","schema":{"type":"integer","default":0}},{"name":"pets","in":"query","required":false,"description":"Pet count","schema":{"type":"integer","default":0}},{"name":"currency","in":"query","required":false,"description":"Currency code","schema":{"type":"string","default":"USD"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Price Tracker","operationId":"post_airbnb_price_tracker","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","default":"https://www.airbnb.com/rooms/569049214818933247","format":"uri","description":"Airbnb listing URL. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"check_in_date":{"type":"string","default":"2026-12-01","format":"date","description":"Starting check-in date (YYYY-MM-DD). Cursor advances this by 30 days per page."},"stay_days":{"type":"integer","default":3,"description":"Length (nights) of each daily quote. Locked into the cursor."},"adults":{"type":"integer","default":2,"description":"Adult guests"},"children":{"type":"integer","default":0,"description":"Child guests"},"infants":{"type":"integer","default":0,"description":"Infant guests"},"pets":{"type":"integer","default":0,"description":"Pet count"},"currency":{"type":"string","default":"USD","description":"Currency code"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["url"]}}}}}},"/airbnb-reviews/":{"get":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Reviews Scraper","operationId":"get_airbnb_reviews","parameters":[{"name":"url","in":"query","required":true,"description":"Airbnb listing URL. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"https://www.airbnb.com/rooms/946231329459150209","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Reviews Scraper","operationId":"post_airbnb_reviews","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","default":"https://www.airbnb.com/rooms/946231329459150209","format":"uri","description":"Airbnb listing URL. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["url"]}}}}}},"/airbnb-room-urls/":{"get":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Room URL Scraper","operationId":"get_airbnb_room_urls","parameters":[{"name":"url","in":"query","required":true,"description":"Airbnb listing URL. Returns full structured detail. This is a lookup endpoint — `next_cursor` is always null.","schema":{"type":"string","default":"https://www.airbnb.com/rooms/668146487515150072","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"currency","in":"query","required":false,"description":"Currency code","schema":{"type":"string","default":"USD"}},{"name":"locale","in":"query","required":false,"description":"Locale","schema":{"type":"string","default":"en-US"}},{"name":"adults","in":"query","required":false,"description":"Adults","schema":{"type":"integer","default":2}},{"name":"children","in":"query","required":false,"description":"Children","schema":{"type":"integer","default":0}},{"name":"pets","in":"query","required":false,"description":"Pets","schema":{"type":"integer","default":0}},{"name":"check_in","in":"query","required":false,"description":"Check-in (YYYY-MM-DD, optional)","schema":{"type":"string","format":"date"}},{"name":"check_out","in":"query","required":false,"description":"Check-out (YYYY-MM-DD, optional)","schema":{"type":"string","format":"date"}},{"name":"enrich_user_profiles","in":"query","required":false,"description":"Fetch host + co-host profiles (default true)","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["airbnb"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Airbnb Room URL Scraper","operationId":"post_airbnb_room_urls","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","default":"https://www.airbnb.com/rooms/668146487515150072","format":"uri","description":"Airbnb listing URL. Returns full structured detail. This is a lookup endpoint — `next_cursor` is always null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"currency":{"type":"string","default":"USD","description":"Currency code"},"locale":{"type":"string","default":"en-US","description":"Locale"},"adults":{"type":"integer","default":2,"description":"Adults"},"children":{"type":"integer","default":0,"description":"Children"},"pets":{"type":"integer","default":0,"description":"Pets"},"check_in":{"type":"string","format":"date","description":"Check-in (YYYY-MM-DD, optional)"},"check_out":{"type":"string","format":"date","description":"Check-out (YYYY-MM-DD, optional)"},"enrich_user_profiles":{"type":"boolean","default":true,"description":"Fetch host + co-host profiles (default true)"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["url"]}}}}}},"/alibaba-listing/":{"get":{"tags":["alibaba"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Alibaba Listing","operationId":"get_alibaba_listing","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword. Required on the first call; locked in cursor after.","schema":{"type":"string","default":"iphone"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["alibaba"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Alibaba Listing","operationId":"post_alibaba_listing","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"iphone","description":"Search keyword. Required on the first call; locked in cursor after."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/alibaba-search/":{"get":{"tags":["alibaba"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Alibaba Product Search","operationId":"get_alibaba_search","parameters":[{"name":"queries","in":"query","required":false,"description":"Search keyword. Use this OR urls. Required first call.","schema":{"type":"string","default":"men's jackets"}},{"name":"urls","in":"query","required":false,"description":"Alibaba keyword search URL (/trade/search or /search/page). Preserves category, country, price, MOQ and supplier filters. Category-only and sorted searches are unsupported. Locked in cursor.","schema":{"type":"string","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["alibaba"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Alibaba Product Search","operationId":"post_alibaba_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"men's jackets","description":"Search keyword. Use this OR urls. Required first call."},"urls":{"type":"string","format":"uri","description":"Alibaba keyword search URL (/trade/search or /search/page). Preserves category, country, price, MOQ and supplier filters. Category-only and sorted searches are unsupported. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/aliexpress-listings-scraper/":{"get":{"tags":["aliexpress"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"AliExpress Listings Scraper","operationId":"get_aliexpress_listings_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"AliExpress search/category/product URL or a plain keyword. Required first call.","schema":{"type":"string","default":"airpods max"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"currency","in":"query","required":false,"description":"Storefront currency. Locked in cursor.","schema":{"type":"string","default":"USD"}},{"name":"region","in":"query","required":false,"description":"Ship-to region code. Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"locale","in":"query","required":false,"description":"Storefront locale. Locked in cursor.","schema":{"type":"string","default":"en_US"}},{"name":"enrich_pdp","in":"query","required":false,"description":"Best-effort store/inStock via signed mtop (may be x5sec-blocked). Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["aliexpress"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"AliExpress Listings Scraper","operationId":"post_aliexpress_listings_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"airpods max","description":"AliExpress search/category/product URL or a plain keyword. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"currency":{"type":"string","default":"USD","description":"Storefront currency. Locked in cursor."},"region":{"type":"string","default":"US","description":"Ship-to region code. Locked in cursor."},"locale":{"type":"string","default":"en_US","description":"Storefront locale. Locked in cursor."},"enrich_pdp":{"type":"boolean","default":false,"description":"Best-effort store/inStock via signed mtop (may be x5sec-blocked). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/aliexpress-products/":{"get":{"tags":["aliexpress"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"AliExpress Products","operationId":"get_aliexpress_products","parameters":[{"name":"queries","in":"query","required":true,"description":"AliExpress search keyword OR ready search/category/item URL (auto-detected). Required first call. Aliases: searchQueries, q.","schema":{"type":"string","default":"wireless earbuds"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"default | price_asc | price_desc | orders. Locked in cursor.","schema":{"type":"string","default":"default","enum":["default","price_asc","price_desc","orders"]}},{"name":"currency","in":"query","required":false,"description":"Currency (pinned via cookie). Locked in cursor.","schema":{"type":"string","default":"USD"}},{"name":"region","in":"query","required":false,"description":"Region code. Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"locale","in":"query","required":false,"description":"Locale. Locked in cursor.","schema":{"type":"string","default":"en_US"}},{"name":"fetch_reviews","in":"query","required":false,"description":"Enrich reviewCount/rating per product (one extra request each; heavy, default off; time-boxed; rows not finished in time carry reviewsEnriched=false). Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["aliexpress"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"AliExpress Products","operationId":"post_aliexpress_products","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"wireless earbuds","description":"AliExpress search keyword OR ready search/category/item URL (auto-detected). Required first call. Aliases: searchQueries, q."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","default":"default","enum":["default","price_asc","price_desc","orders"],"description":"default | price_asc | price_desc | orders. Locked in cursor."},"currency":{"type":"string","default":"USD","description":"Currency (pinned via cookie). Locked in cursor."},"region":{"type":"string","default":"US","description":"Region code. Locked in cursor."},"locale":{"type":"string","default":"en_US","description":"Locale. Locked in cursor."},"fetch_reviews":{"type":"boolean","default":false,"description":"Enrich reviewCount/rating per product (one extra request each; heavy, default off; time-boxed; rows not finished in time carry reviewsEnriched=false). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/aliexpress-reviews/":{"get":{"tags":["aliexpress"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"AliExpress Reviews","operationId":"get_aliexpress_reviews","parameters":[{"name":"product_id","in":"query","required":true,"description":"AliExpress product id or full product URL. Required first call. Aliases: product_ids, url, urls.","schema":{"type":"string","default":"1005006079931969"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"filter","in":"query","required":false,"description":"all | 1-5 | image | additional | local. Locked in cursor.","schema":{"type":"string","default":"all","enum":["all","1","2","3","4","5","image","additional","local"]}},{"name":"sort","in":"query","required":false,"description":"default | newest. Locked in cursor.","schema":{"type":"string","default":"default","enum":["default","newest"]}},{"name":"country","in":"query","required":false,"description":"Reviewer country for filter=local. Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"lang","in":"query","required":false,"description":"Translation language ISO code (EN RU PT ES FR ...). Locked in cursor.","schema":{"type":"string","default":"EN"}},{"name":"label","in":"query","required":false,"description":"sentiment, issue, reports | none. Locked in cursor.","schema":{"type":"string","default":"issue"}},{"name":"reports","in":"query","required":false,"description":"Text for label=reports. Locked in cursor.","schema":{"type":"string"}},{"name":"written_only","in":"query","required":false,"description":"Drop rating-only rows. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["aliexpress"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"AliExpress Reviews","operationId":"post_aliexpress_reviews","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string","default":"1005006079931969","description":"AliExpress product id or full product URL. Required first call. Aliases: product_ids, url, urls."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"filter":{"type":"string","default":"all","enum":["all","1","2","3","4","5","image","additional","local"],"description":"all | 1-5 | image | additional | local. Locked in cursor."},"sort":{"type":"string","default":"default","enum":["default","newest"],"description":"default | newest. Locked in cursor."},"country":{"type":"string","default":"US","description":"Reviewer country for filter=local. Locked in cursor."},"lang":{"type":"string","default":"EN","description":"Translation language ISO code (EN RU PT ES FR ...). Locked in cursor."},"label":{"type":"string","default":"issue","description":"sentiment, issue, reports | none. Locked in cursor."},"reports":{"type":"string","description":"Text for label=reports. Locked in cursor."},"written_only":{"type":"boolean","default":true,"description":"Drop rating-only rows. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["product_id"]}}}}}},"/aliexpress-search-hot/":{"get":{"tags":["aliexpress"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"AliExpress Search Hot","operationId":"get_aliexpress_search_hot","parameters":[{"name":"query","in":"query","required":false,"description":"Keyword. Empty browses most-sold items. Locked in cursor.","schema":{"type":"string","default":"xiaomi"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sortby","in":"query","required":false,"description":"price_low | price_high | most_sold. Empty + no query = most_sold (AliExpress has no anonymous curated hot feed).","schema":{"type":"string"}},{"name":"min_price","in":"query","required":false,"description":"Lowest price, smallest currency unit (cents for USD).","schema":{"type":"integer"}},{"name":"max_price","in":"query","required":false,"description":"Highest price, smallest currency unit (cents for USD).","schema":{"type":"integer"}},{"name":"category_id","in":"query","required":false,"description":"AliExpress category id (passed as CatId; filtering not independently verified).","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Ship-to country, 2-letter code.","schema":{"type":"string","default":"US"}},{"name":"currency","in":"query","required":false,"description":"USD GBP CAD EUR UAH MXN TRY RUB BRL AUD INR JPY IDR SEK KRW ILS THB CLP VND.","schema":{"type":"string","default":"USD"}},{"name":"language","in":"query","required":false,"description":"EN RU PT ES FR ID IT TH JA AR VI TR DE HE KO NL PL MX CL IN.","schema":{"type":"string","default":"EN"}},{"name":"enrich_reviews","in":"query","required":false,"description":"Back-fill reviews_count per product (one extra request each).","schema":{"type":"boolean","default":false}},{"name":"enrich_seller","in":"query","required":false,"description":"Best-effort seller/shop_url via signed mtop (x5sec-walled; usually null). One extra request each.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["aliexpress"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"AliExpress Search Hot","operationId":"post_aliexpress_search_hot","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"xiaomi","description":"Keyword. Empty browses most-sold items. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sortby":{"type":"string","description":"price_low | price_high | most_sold. Empty + no query = most_sold (AliExpress has no anonymous curated hot feed)."},"min_price":{"type":"integer","description":"Lowest price, smallest currency unit (cents for USD)."},"max_price":{"type":"integer","description":"Highest price, smallest currency unit (cents for USD)."},"category_id":{"type":"string","description":"AliExpress category id (passed as CatId; filtering not independently verified)."},"country":{"type":"string","default":"US","description":"Ship-to country, 2-letter code."},"currency":{"type":"string","default":"USD","description":"USD GBP CAD EUR UAH MXN TRY RUB BRL AUD INR JPY IDR SEK KRW ILS THB CLP VND."},"language":{"type":"string","default":"EN","description":"EN RU PT ES FR ID IT TH JA AR VI TR DE HE KO NL PL MX CL IN."},"enrich_reviews":{"type":"boolean","default":false,"description":"Back-fill reviews_count per product (one extra request each)."},"enrich_seller":{"type":"boolean","default":false,"description":"Best-effort seller/shop_url via signed mtop (x5sec-walled; usually null). One extra request each."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/amazon-asin-lookup/":{"get":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon ASIN Lookup","operationId":"get_amazon_asin_lookup","parameters":[{"name":"asins","in":"query","required":true,"description":"One 10-character ASIN or Amazon product URL. Returns one product; next_cursor is always null.","schema":{"type":"string","default":"B07GBZ4Q68"}},{"name":"domain","in":"query","required":false,"description":"Allowed marketplace override. Product URLs otherwise select their own marketplace.","schema":{"type":"string","default":"amazon.com"}},{"name":"language","in":"query","required":false,"description":"Storefront language code, e.g. en, en_US, de.","schema":{"type":"string","default":"en"}},{"name":"zip_code","in":"query","required":false,"description":"Optional delivery postal code; adds up to three setup requests per attempt.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon ASIN Lookup","operationId":"post_amazon_asin_lookup","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"asins":{"type":"string","default":"B07GBZ4Q68","description":"One 10-character ASIN or Amazon product URL. Returns one product; next_cursor is always null."},"domain":{"type":"string","default":"amazon.com","description":"Allowed marketplace override. Product URLs otherwise select their own marketplace."},"language":{"type":"string","default":"en","description":"Storefront language code, e.g. en, en_US, de."},"zip_code":{"type":"string","description":"Optional delivery postal code; adds up to three setup requests per attempt."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["asins"]}}}}}},"/amazon-bestsellers/":{"get":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Best Sellers","operationId":"get_amazon_bestsellers","parameters":[{"name":"url","in":"query","required":true,"description":"Amazon Best Sellers category URL (contains best-sellers / zgbs). Required on first call.","schema":{"type":"string","default":"https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"Optional Accept-Language primary tag (e.g. en-US, de-DE)","schema":{"type":"string"}},{"name":"depth_of_crawl","in":"query","required":false,"description":"1 = main category only; 2+ = also scrape subcategories (max 5)","schema":{"type":"integer","default":1}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Best Sellers","operationId":"post_amazon_bestsellers","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","default":"https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/","format":"uri","description":"Amazon Best Sellers category URL (contains best-sellers / zgbs). Required on first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"language":{"type":"string","description":"Optional Accept-Language primary tag (e.g. en-US, de-DE)"},"depth_of_crawl":{"type":"integer","default":1,"description":"1 = main category only; 2+ = also scrape subcategories (max 5)"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["url"]}}}}}},"/amazon-keyword-suggestion/":{"get":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Keyword Suggestion","operationId":"get_amazon_keyword_suggestion","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword. Lookup endpoint -- next_cursor null.","schema":{"type":"string","default":"iphone"}},{"name":"max_items","in":"query","required":false,"description":"","schema":{"type":"integer","default":50}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Keyword Suggestion","operationId":"post_amazon_keyword_suggestion","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"iphone","description":"Search keyword. Lookup endpoint -- next_cursor null."},"max_items":{"type":"integer","default":50,"description":""},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/amazon-product/":{"get":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Product Scraper","operationId":"get_amazon_product","parameters":[{"name":"query","in":"query","required":false,"description":"Search keyword. Builds the marketplace search URL (see location_name / se_domain) when url is omitted. Required first call unless url given. Aliases: queries, keyword, q.","schema":{"type":"string","default":"keyboard"}},{"name":"url","in":"query","required":false,"description":"Amazon search/category URL or product /dp/ URL. Takes precedence over query. Product URLs return a single result with next_cursor=null; search URLs paginate. Aliases: urls.","schema":{"type":"string","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"location_name","in":"query","required":false,"description":"Marketplace + delivery location. Sets the Amazon domain, currency and delivery ZIP (prices/delivery dates as a shopper there sees them). Aliases: location, location_code (e.g. 2840), country (ISO2).","schema":{"type":"string","default":"United States","enum":["United States","Australia","Belgium","Brazil","Canada","France","Germany","India","Italy","Japan","Mexico","Netherlands","Poland","Saudi Arabia","Singapore","Spain","Sweden","United Arab Emirates","Turkiye","Egypt","United Kingdom"]}},{"name":"language_name","in":"query","required":false,"description":"Storefront language, as a name (\"English (United States)\") or code (en_US). Default: the marketplace language. Aliases: language, language_code.","schema":{"type":"string","enum":["English (United States)","Arabic (Saudi Arabia)","Arabic (U.A.E.)","Chinese (Simplified)","Chinese (Traditional)","Czech (Czech Republic)","Dutch (Netherlands)","English (Australia)","English (Canada)","English (India)","English (U.A.E.)","English (United Kingdom)","French (Canada)","French (France)","German (Germany)","Hebrew (Israel)","Hindi (India)","Italian (Italy)","Japanese (Japan)","Korean (Korea)","Polish (Poland)","Portuguese (Brazil)","Spanish (Mexico)","Spanish (Spain)","Spanish (United States)","Swedish (Sweden)","Turkish (Turkey)"]}},{"name":"se_domain","in":"query","required":false,"description":"Amazon domain override (amazon.com, amazon.co.uk, amazon.de, …). Default: chosen from location_name.","schema":{"type":"string"}},{"name":"zip_code","in":"query","required":false,"description":"Delivery postal code override (default: the marketplace capital, e.g. 10001 for the US). Aliases: postal_code, zip.","schema":{"type":"string"}},{"name":"set_delivery_location","in":"query","required":false,"description":"Pin the session delivery location to zip_code before scraping (2 extra requests per session). false = whatever location Amazon infers from the proxy IP (off-country IPs may get no prices).","schema":{"type":"boolean","default":true}},{"name":"price_min","in":"query","required":false,"description":"Minimum product price (marketplace currency).","schema":{"type":"integer"}},{"name":"price_max","in":"query","required":false,"description":"Maximum product price (marketplace currency).","schema":{"type":"integer"}},{"name":"sort_by","in":"query","required":false,"description":"Result sorting. Default: Amazon's \"Featured\" order.","schema":{"type":"string","enum":["relevance","featured","price_low_to_high","price_high_to_low","avg_customer_review","newest_arrival","best_sellers"]}},{"name":"department","in":"query","required":false,"description":"Amazon department, e.g. \"Electronics\", \"Books\", \"Home & Kitchen\" (or a raw search alias like \"electronics\").","schema":{"type":"string"}},{"name":"search_param","in":"query","required":false,"description":"Extra Amazon search URL params, e.g. \"&rh=p_72:1248882011\". Ignored when price_min, price_max or sort_by is set.","schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"description":"Your own identifier (max 255 chars), echoed on every result.","schema":{"type":"string"}},{"name":"depth","in":"query","required":false,"description":"Max products across all pages, organic + sponsored (max 700). Pagination stops once reached. Locked in cursor. Alias: max_items.","schema":{"type":"integer","default":100}},{"name":"max_crawl_pages","in":"query","required":false,"description":"Max search-result pages to walk; next_cursor is null after this page. Locked in cursor. Alias: max_pages.","schema":{"type":"integer","default":7}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Product Scraper","operationId":"post_amazon_product","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"keyboard","description":"Search keyword. Builds the marketplace search URL (see location_name / se_domain) when url is omitted. Required first call unless url given. Aliases: queries, keyword, q."},"url":{"type":"string","format":"uri","description":"Amazon search/category URL or product /dp/ URL. Takes precedence over query. Product URLs return a single result with next_cursor=null; search URLs paginate. Aliases: urls."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"location_name":{"type":"string","default":"United States","enum":["United States","Australia","Belgium","Brazil","Canada","France","Germany","India","Italy","Japan","Mexico","Netherlands","Poland","Saudi Arabia","Singapore","Spain","Sweden","United Arab Emirates","Turkiye","Egypt","United Kingdom"],"description":"Marketplace + delivery location. Sets the Amazon domain, currency and delivery ZIP (prices/delivery dates as a shopper there sees them). Aliases: location, location_code (e.g. 2840), country (ISO2)."},"language_name":{"type":"string","enum":["English (United States)","Arabic (Saudi Arabia)","Arabic (U.A.E.)","Chinese (Simplified)","Chinese (Traditional)","Czech (Czech Republic)","Dutch (Netherlands)","English (Australia)","English (Canada)","English (India)","English (U.A.E.)","English (United Kingdom)","French (Canada)","French (France)","German (Germany)","Hebrew (Israel)","Hindi (India)","Italian (Italy)","Japanese (Japan)","Korean (Korea)","Polish (Poland)","Portuguese (Brazil)","Spanish (Mexico)","Spanish (Spain)","Spanish (United States)","Swedish (Sweden)","Turkish (Turkey)"],"description":"Storefront language, as a name (\"English (United States)\") or code (en_US). Default: the marketplace language. Aliases: language, language_code."},"se_domain":{"type":"string","description":"Amazon domain override (amazon.com, amazon.co.uk, amazon.de, …). Default: chosen from location_name."},"zip_code":{"type":"string","description":"Delivery postal code override (default: the marketplace capital, e.g. 10001 for the US). Aliases: postal_code, zip."},"set_delivery_location":{"type":"boolean","default":true,"description":"Pin the session delivery location to zip_code before scraping (2 extra requests per session). false = whatever location Amazon infers from the proxy IP (off-country IPs may get no prices)."},"price_min":{"type":"integer","description":"Minimum product price (marketplace currency)."},"price_max":{"type":"integer","description":"Maximum product price (marketplace currency)."},"sort_by":{"type":"string","enum":["relevance","featured","price_low_to_high","price_high_to_low","avg_customer_review","newest_arrival","best_sellers"],"description":"Result sorting. Default: Amazon's \"Featured\" order."},"department":{"type":"string","description":"Amazon department, e.g. \"Electronics\", \"Books\", \"Home & Kitchen\" (or a raw search alias like \"electronics\")."},"search_param":{"type":"string","description":"Extra Amazon search URL params, e.g. \"&rh=p_72:1248882011\". Ignored when price_min, price_max or sort_by is set."},"tag":{"type":"string","description":"Your own identifier (max 255 chars), echoed on every result."},"depth":{"type":"integer","default":100,"description":"Max products across all pages, organic + sponsored (max 700). Pagination stops once reached. Locked in cursor. Alias: max_items."},"max_crawl_pages":{"type":"integer","default":7,"description":"Max search-result pages to walk; next_cursor is null after this page. Locked in cursor. Alias: max_pages."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/amazon-review/":{"get":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Review","operationId":"get_amazon_review","parameters":[{"name":"asins","in":"query","required":true,"description":"Bare ASIN or amazon.com product URL (/dp/, /gp/product/, slugged). Single lookup -- next_cursor always null. CAP: logged-out Amazon serves only the product page's \"Top reviews\" card (up to 8 US + up to ~5 international reviews); the full paginated list requires sign-in (stated in the `warning` field). Unknown ASIN / no reviews -> 404; Amazon wall on every attempt -> 502; bad input -> 400.","schema":{"type":"string","default":"B0B2RM68G2"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Review","operationId":"post_amazon_review","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"asins":{"type":"string","default":"B0B2RM68G2","description":"Bare ASIN or amazon.com product URL (/dp/, /gp/product/, slugged). Single lookup -- next_cursor always null. CAP: logged-out Amazon serves only the product page's \"Top reviews\" card (up to 8 US + up to ~5 international reviews); the full paginated list requires sign-in (stated in the `warning` field). Unknown ASIN / no reviews -> 404; Amazon wall on every attempt -> 502; bad input -> 400."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["asins"]}}}}}},"/amazon-scraper/":{"get":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Scraper","operationId":"get_amazon_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"Amazon search URL, product URL, ASIN or keyword. Product/ASIN = single lookup (next_cursor null). Required first call.","schema":{"type":"string","default":"wireless keyboard"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"domain_code","in":"query","required":false,"description":"Marketplace for ASIN / keyword inputs: com, co.uk, de, fr, it, es, ca, in. URLs carry their own domain.","schema":{"type":"string","default":"com"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Scraper","operationId":"post_amazon_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"wireless keyboard","description":"Amazon search URL, product URL, ASIN or keyword. Product/ASIN = single lookup (next_cursor null). Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"domain_code":{"type":"string","default":"com","description":"Marketplace for ASIN / keyword inputs: com, co.uk, de, fr, it, es, ca, in. URLs carry their own domain."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/amazon-search/":{"get":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Search","operationId":"get_amazon_search","parameters":[{"name":"query","in":"query","required":true,"description":"Search keyword (required first call).","schema":{"type":"string","default":"Playstation"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"domain_code","in":"query","required":false,"description":"Amazon marketplace: com, co.uk, de, in, ca, it, es, fr (fr is AWS-WAF gated and may return 502). Locked in cursor.","schema":{"type":"string","default":"com","enum":["com","co.uk","de","in","ca","it","es","fr"]}},{"name":"sort_by","in":"query","required":false,"description":"Amazon sort key. Locked in cursor.","schema":{"type":"string","default":"relevanceblender","enum":["relevanceblender","price-asc-rank","price-desc-rank","review-rank","date-desc-rank","exact-aware-popularity-rank"]}},{"name":"category","in":"query","required":false,"description":"Search category (optional)","schema":{"type":"string"}},{"name":"browse_node","in":"query","required":false,"description":"Browse node ID (optional)","schema":{"type":"integer"}},{"name":"node_hierarchy","in":"query","required":false,"description":"Node hierarchy (optional)","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"description":"First call only: front-load this many Amazon result pages (capped at 10). Cursor calls return one page (plus a refill page when it comes back thin).","schema":{"type":"integer","default":1}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Search","operationId":"post_amazon_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"Playstation","description":"Search keyword (required first call)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"domain_code":{"type":"string","default":"com","enum":["com","co.uk","de","in","ca","it","es","fr"],"description":"Amazon marketplace: com, co.uk, de, in, ca, it, es, fr (fr is AWS-WAF gated and may return 502). Locked in cursor."},"sort_by":{"type":"string","default":"relevanceblender","enum":["relevanceblender","price-asc-rank","price-desc-rank","review-rank","date-desc-rank","exact-aware-popularity-rank"],"description":"Amazon sort key. Locked in cursor."},"category":{"type":"string","description":"Search category (optional)"},"browse_node":{"type":"integer","description":"Browse node ID (optional)"},"node_hierarchy":{"type":"string","description":"Node hierarchy (optional)"},"max_pages":{"type":"integer","default":1,"description":"First call only: front-load this many Amazon result pages (capped at 10). Cursor calls return one page (plus a refill page when it comes back thin)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["query"]}}}}}},"/amazon-seller-scraper/":{"get":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 3 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Seller Scraper","operationId":"get_amazon_seller_scraper","parameters":[{"name":"search_type","in":"query","required":false,"description":"keyword (default) = search term / search URL -> products with their buybox seller contact details. asin = DataForSEO-style Sellers lookup: queries are ASINs or product URLs; returns every offer (seller, price, condition, ships from, seller rating, delivery dates) with each seller profilebusiness name / phone / address, plus a product_info block.","schema":{"type":"string","default":"keyword","enum":["keyword","asin"]}},{"name":"queries","in":"query","required":true,"description":"Search term, Amazon search URL, product URL or bare ASIN. Required on the first call. A product URL / ASIN is a single lookup (next_cursor null) in keyword mode; with search_type=asin it pages through the ASIN offers, ~10 sellers per call (page 1 also returns product_info).","schema":{"type":"string","default":"laptop"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"location_name","in":"query","required":false,"description":"search_type=asin: marketplace + delivery location (default United States). Aliases: location, location_code, country.","schema":{"type":"string","default":"United States","enum":["United States","Australia","Belgium","Brazil","Canada","France","Germany","India","Italy","Japan","Mexico","Netherlands","Poland","Saudi Arabia","Singapore","Spain","Sweden","United Arab Emirates","Turkiye","Egypt","United Kingdom"]}},{"name":"language_name","in":"query","required":false,"description":"search_type=asin: storefront language, name or code (en_US). Aliases: language, language_code.","schema":{"type":"string","enum":["English (United States)","Arabic (Saudi Arabia)","Arabic (U.A.E.)","Chinese (Simplified)","Chinese (Traditional)","Czech (Czech Republic)","Dutch (Netherlands)","English (Australia)","English (Canada)","English (India)","English (U.A.E.)","English (United Kingdom)","French (Canada)","French (France)","German (Germany)","Hebrew (Israel)","Hindi (India)","Italian (Italy)","Japanese (Japan)","Korean (Korea)","Polish (Poland)","Portuguese (Brazil)","Spanish (Mexico)","Spanish (Spain)","Spanish (United States)","Swedish (Sweden)","Turkish (Turkey)"]}},{"name":"se_domain","in":"query","required":false,"description":"search_type=asin: Amazon domain override (amazon.co.uk, amazon.de, ...).","schema":{"type":"string"}},{"name":"zip_code","in":"query","required":false,"description":"search_type=asin: delivery postal code override (default: marketplace capital).","schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"description":"Your own identifier (max 255 chars), echoed on every result.","schema":{"type":"string"}},{"name":"max_offers","in":"query","required":false,"description":"search_type=asin: max offers (sellers) per ASIN, including the buybox offer (default 100, max 500).","schema":{"type":"integer","default":100}},{"name":"seller_details","in":"query","required":false,"description":"search_type=asin: fetch each seller profile for business name / phone / address (one extra request per seller).","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 3 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Seller Scraper","operationId":"post_amazon_seller_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"search_type":{"type":"string","default":"keyword","enum":["keyword","asin"],"description":"keyword (default) = search term / search URL -> products with their buybox seller contact details. asin = DataForSEO-style Sellers lookup: queries are ASINs or product URLs; returns every offer (seller, price, condition, ships from, seller rating, delivery dates) with each seller profilebusiness name / phone / address, plus a product_info block."},"queries":{"type":"string","default":"laptop","description":"Search term, Amazon search URL, product URL or bare ASIN. Required on the first call. A product URL / ASIN is a single lookup (next_cursor null) in keyword mode; with search_type=asin it pages through the ASIN offers, ~10 sellers per call (page 1 also returns product_info)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"location_name":{"type":"string","default":"United States","enum":["United States","Australia","Belgium","Brazil","Canada","France","Germany","India","Italy","Japan","Mexico","Netherlands","Poland","Saudi Arabia","Singapore","Spain","Sweden","United Arab Emirates","Turkiye","Egypt","United Kingdom"],"description":"search_type=asin: marketplace + delivery location (default United States). Aliases: location, location_code, country."},"language_name":{"type":"string","enum":["English (United States)","Arabic (Saudi Arabia)","Arabic (U.A.E.)","Chinese (Simplified)","Chinese (Traditional)","Czech (Czech Republic)","Dutch (Netherlands)","English (Australia)","English (Canada)","English (India)","English (U.A.E.)","English (United Kingdom)","French (Canada)","French (France)","German (Germany)","Hebrew (Israel)","Hindi (India)","Italian (Italy)","Japanese (Japan)","Korean (Korea)","Polish (Poland)","Portuguese (Brazil)","Spanish (Mexico)","Spanish (Spain)","Spanish (United States)","Swedish (Sweden)","Turkish (Turkey)"],"description":"search_type=asin: storefront language, name or code (en_US). Aliases: language, language_code."},"se_domain":{"type":"string","description":"search_type=asin: Amazon domain override (amazon.co.uk, amazon.de, ...)."},"zip_code":{"type":"string","description":"search_type=asin: delivery postal code override (default: marketplace capital)."},"tag":{"type":"string","description":"Your own identifier (max 255 chars), echoed on every result."},"max_offers":{"type":"integer","default":100,"description":"search_type=asin: max offers (sellers) per ASIN, including the buybox offer (default 100, max 500)."},"seller_details":{"type":"boolean","default":true,"description":"search_type=asin: fetch each seller profile for business name / phone / address (one extra request per seller)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/amazon-shop/":{"get":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Shop","operationId":"get_amazon_shop","parameters":[{"name":"urls","in":"query","required":true,"description":"Amazon influencer shop URL or bare handle. Required first call. Locked in cursor.","schema":{"type":"string","default":"https://www.amazon.com/shop/pattyy.p","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Shop","operationId":"post_amazon_shop","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.amazon.com/shop/pattyy.p","format":"uri","description":"Amazon influencer shop URL or bare handle. Required first call. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/amazon-todays-deals/":{"get":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Today's Deals","operationId":"get_amazon_todays_deals","parameters":[{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"department","in":"query","required":false,"description":"First call only (locked into the cursor). Optional department name (e.g. Electronics, Home & Kitchen, Books, Toys & Games) or Amazon browse-node id. Empty = all.","schema":{"type":"string"}},{"name":"deal_type","in":"query","required":false,"description":"First call only. all | best_deal | lightning_deal | coupon","schema":{"type":"string","default":"all","enum":["all","best_deal","lightning_deal","coupon"]}},{"name":"prime_exclusive","in":"query","required":false,"description":"First call only. Only Prime-exclusive deals","schema":{"type":"boolean","default":false}},{"name":"min_discount","in":"query","required":false,"description":"First call only. Minimum discount % (0-100)","schema":{"type":"integer"}},{"name":"max_discount","in":"query","required":false,"description":"First call only. Maximum discount % (0-100)","schema":{"type":"integer"}},{"name":"min_price","in":"query","required":false,"description":"First call only. Minimum price in USD","schema":{"type":"integer"}},{"name":"max_price","in":"query","required":false,"description":"First call only. Maximum price in USD","schema":{"type":"integer"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["amazon"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Amazon Today's Deals","operationId":"post_amazon_todays_deals","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"department":{"type":"string","description":"First call only (locked into the cursor). Optional department name (e.g. Electronics, Home & Kitchen, Books, Toys & Games) or Amazon browse-node id. Empty = all."},"deal_type":{"type":"string","default":"all","enum":["all","best_deal","lightning_deal","coupon"],"description":"First call only. all | best_deal | lightning_deal | coupon"},"prime_exclusive":{"type":"boolean","default":false,"description":"First call only. Only Prime-exclusive deals"},"min_discount":{"type":"integer","description":"First call only. Minimum discount % (0-100)"},"max_discount":{"type":"integer","description":"First call only. Maximum discount % (0-100)"},"min_price":{"type":"integer","description":"First call only. Minimum price in USD"},"max_price":{"type":"integer","description":"First call only. Maximum price in USD"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/app-store-app-info/":{"get":{"tags":["apple"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"App Store App Info","operationId":"get_app_store_app_info","parameters":[{"name":"urls","in":"query","required":true,"description":"App Store app URL or bare numeric app id. Lookup endpoint -- next_cursor null.","schema":{"type":"string","default":"https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO alpha-2 / full name / ISO numeric. Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"language","in":"query","required":false,"description":"Free-form -> ISO 639-1. Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["apple"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"App Store App Info","operationId":"post_app_store_app_info","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580","format":"uri","description":"App Store app URL or bare numeric app id. Lookup endpoint -- next_cursor null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"US","description":"ISO alpha-2 / full name / ISO numeric. Locked in cursor."},"language":{"type":"string","default":"en","description":"Free-form -> ISO 639-1. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/app-store-keywords-suggestion/":{"get":{"tags":["apple"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"App Store Keywords Suggestion","operationId":"get_app_store_keywords_suggestion","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword. Lookup endpoint -- next_cursor null.","schema":{"type":"string","default":"light"}},{"name":"max_items","in":"query","required":false,"description":"","schema":{"type":"integer","default":50}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["apple"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"App Store Keywords Suggestion","operationId":"post_app_store_keywords_suggestion","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"light","description":"Search keyword. Lookup endpoint -- next_cursor null."},"max_items":{"type":"integer","default":50,"description":""},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/apple-app-store/":{"get":{"tags":["apple"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Apple App Store","operationId":"get_apple_app_store","parameters":[{"name":"process","in":"query","required":false,"description":"Mode: ap (single app lookup) | se (search) | de (developer apps) | re (reviews — paginated) | li (collection) | pe (performance). Only `re` is cursor-paginated.","schema":{"type":"string","default":"se","enum":["ap","se","de","re","li","pe"]}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO country code (default us)","schema":{"type":"string","default":"us"}},{"name":"lang","in":"query","required":false,"description":"Language (default en)","schema":{"type":"string","default":"en"}},{"name":"appId","in":"query","required":false,"description":"Required for process=ap, pe, re","schema":{"type":"string","default":"1514844618"}},{"name":"queries","in":"query","required":false,"description":"Required for process=se","schema":{"type":"string","default":"Translate"}},{"name":"developerId","in":"query","required":false,"description":"Required for process=de","schema":{"type":"string","default":"284417353"}},{"name":"collection","in":"query","required":false,"description":"Required for process=li","schema":{"type":"string","default":"TOP_FREE_IOS"}},{"name":"sorting","in":"query","required":false,"description":"For process=re — sort.RECENT or sort.HELPFUL","schema":{"type":"string","default":"sort.RECENT","enum":["sort.RECENT","sort.HELPFUL"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["apple"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Apple App Store","operationId":"post_apple_app_store","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"process":{"type":"string","default":"se","enum":["ap","se","de","re","li","pe"],"description":"Mode: ap (single app lookup) | se (search) | de (developer apps) | re (reviews — paginated) | li (collection) | pe (performance). Only `re` is cursor-paginated."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"us","description":"ISO country code (default us)"},"lang":{"type":"string","default":"en","description":"Language (default en)"},"appId":{"type":"string","default":"1514844618","description":"Required for process=ap, pe, re"},"queries":{"type":"string","default":"Translate","description":"Required for process=se"},"developerId":{"type":"string","default":"284417353","description":"Required for process=de"},"collection":{"type":"string","default":"TOP_FREE_IOS","description":"Required for process=li"},"sorting":{"type":"string","default":"sort.RECENT","enum":["sort.RECENT","sort.HELPFUL"],"description":"For process=re — sort.RECENT or sort.HELPFUL"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/apple-app-store-review-scraper/":{"get":{"tags":["apple"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Apple App Store Review Scraper","operationId":"get_apple_app_store_review_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"App Store app URL (…/id<digits>) or bare numeric app id. Required first call.","schema":{"type":"string","default":"https://apps.apple.com/us/app/quicken-simplifi-budget-smart/id1449777194"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"2-letter storefront; a URL's /cc/ wins. Locked in cursor.","schema":{"type":"string","default":"us"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["apple"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Apple App Store Review Scraper","operationId":"post_apple_app_store_review_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://apps.apple.com/us/app/quicken-simplifi-budget-smart/id1449777194","description":"App Store app URL (…/id<digits>) or bare numeric app id. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"us","description":"2-letter storefront; a URL's /cc/ wins. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/baidu-search/":{"get":{"tags":["baidu"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Baidu Search Scraper","operationId":"get_baidu_search","parameters":[{"name":"query","in":"query","required":true,"description":"Search query (single keyword/phrase). Required on the first call. Ignored when `cursor` is supplied — the cursor carries the original query forward.","schema":{"type":"string","default":"机器学习"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"time_period","in":"query","required":false,"description":"Either stf=START,END|stftype=1 or JSON object with start_date/end_date (camelCase startDate/endDate accepted)","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"Shorthand: last N days (overrides time_period if > 0)","schema":{"type":"integer","default":0}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["baidu"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Baidu Search Scraper","operationId":"post_baidu_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"机器学习","description":"Search query (single keyword/phrase). Required on the first call. Ignored when `cursor` is supplied — the cursor carries the original query forward."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"time_period":{"type":"string","description":"Either stf=START,END|stftype=1 or JSON object with start_date/end_date (camelCase startDate/endDate accepted)"},"days":{"type":"integer","default":0,"description":"Shorthand: last N days (overrides time_period if > 0)"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["query"]}}}}}},"/bing-image-search/":{"get":{"tags":["bing"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bing Image Search","operationId":"get_bing_image_search","parameters":[{"name":"query","in":"query","required":true,"description":"Image search keyword.","schema":{"type":"string","default":"Coffee"}},{"name":"cc","in":"query","required":false,"description":"Country code for results (2 letters, e.g. US, GB, DE).","schema":{"type":"string","default":"US"}},{"name":"safe_search","in":"query","required":false,"description":"strict | moderate | off (Bing adult filter). Locked in cursor.","schema":{"type":"string","default":"moderate"}},{"name":"image_size","in":"query","required":false,"description":"small | medium | large | wallpaper Locked in cursor.","schema":{"type":"string"}},{"name":"image_type","in":"query","required":false,"description":"photo | clipart | linedrawing | animatedgif | transparent Locked in cursor.","schema":{"type":"string"}},{"name":"color","in":"query","required":false,"description":"coloronly | monochrome | black | blue | brown | gray | green | orange | pink | purple | red | teal | white | yellow Locked in cursor.","schema":{"type":"string"}},{"name":"license","in":"query","required":false,"description":"any | public | share | sharecommercially | modify | modifycommercially Locked in cursor.","schema":{"type":"string"}},{"name":"aspect","in":"query","required":false,"description":"square | wide | tall Locked in cursor.","schema":{"type":"string"}},{"name":"freshness","in":"query","required":false,"description":"day | week | month | year Locked in cursor.","schema":{"type":"string"}},{"name":"people","in":"query","required":false,"description":"face | portrait Locked in cursor.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["bing"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bing Image Search","operationId":"post_bing_image_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"Coffee","description":"Image search keyword."},"cc":{"type":"string","default":"US","description":"Country code for results (2 letters, e.g. US, GB, DE)."},"safe_search":{"type":"string","default":"moderate","description":"strict | moderate | off (Bing adult filter). Locked in cursor."},"image_size":{"type":"string","description":"small | medium | large | wallpaper Locked in cursor."},"image_type":{"type":"string","description":"photo | clipart | linedrawing | animatedgif | transparent Locked in cursor."},"color":{"type":"string","description":"coloronly | monochrome | black | blue | brown | gray | green | orange | pink | purple | red | teal | white | yellow Locked in cursor."},"license":{"type":"string","description":"any | public | share | sharecommercially | modify | modifycommercially Locked in cursor."},"aspect":{"type":"string","description":"square | wide | tall Locked in cursor."},"freshness":{"type":"string","description":"day | week | month | year Locked in cursor."},"people":{"type":"string","description":"face | portrait Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["query"]}}}}}},"/bing-videos/":{"get":{"tags":["bing"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bing Videos","operationId":"get_bing_videos","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword(s). POST: JSON array (one search per keyword). GET / v2: first only.","schema":{"type":"string","default":"gaming"}},{"name":"duration","in":"query","required":false,"description":"short (<4 min), medium (4-20 min) or long (>20 min).","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"day, week, month or year (added to the query as Bing keywords).","schema":{"type":"string"}},{"name":"quality","in":"query","required":false,"description":"low, 360, 480, 780 or 1080 (appended to the query text; Bing exposes no resolution data).","schema":{"type":"string"}},{"name":"price","in":"query","required":false,"description":"free or paid (appended to the query text only).","schema":{"type":"string"}},{"name":"source","in":"query","required":false,"description":"Limit to a source domain, e.g. youtube.com.","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma list of fields to keep (id, title, external, thumbnail, preview, duration, type, url, query; dot paths allowed).","schema":{"type":"string"}},{"name":"keep_empty","in":"query","required":false,"description":"Keep null/empty values in rows (default strips them).","schema":{"type":"boolean","default":false}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["bing"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bing Videos","operationId":"post_bing_videos","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"gaming","description":"Search keyword(s). POST: JSON array (one search per keyword). GET / v2: first only."},"duration":{"type":"string","description":"short (<4 min), medium (4-20 min) or long (>20 min)."},"date":{"type":"string","description":"day, week, month or year (added to the query as Bing keywords)."},"quality":{"type":"string","description":"low, 360, 480, 780 or 1080 (appended to the query text; Bing exposes no resolution data)."},"price":{"type":"string","description":"free or paid (appended to the query text only)."},"source":{"type":"string","description":"Limit to a source domain, e.g. youtube.com."},"fields":{"type":"string","description":"Comma list of fields to keep (id, title, external, thumbnail, preview, duration, type, url, query; dot paths allowed)."},"keep_empty":{"type":"boolean","default":false,"description":"Keep null/empty values in rows (default strips them)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/bing-web-search/":{"get":{"tags":["bing"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bing Web Search Scraper","operationId":"get_bing_web_search","parameters":[{"name":"query","in":"query","required":true,"description":"Web search term. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"python tutorial"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"cc","in":"query","required":false,"description":"Bing country code (e.g. US, GB, DE). Locked into the cursor on first call.","schema":{"type":"string","default":"US"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["bing"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bing Web Search Scraper","operationId":"post_bing_web_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"python tutorial","description":"Web search term. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"cc":{"type":"string","default":"US","description":"Bing country code (e.g. US, GB, DE). Locked into the cursor on first call."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["query"]}}}}}},"/bluesky-profile-info/":{"get":{"tags":["bluesky"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bluesky Profile Info","operationId":"get_bluesky_profile_info","parameters":[{"name":"handles","in":"query","required":true,"description":"The Bluesky account: a handle (\"espn.com\", \"@espn.com\"), a profile URL (https://bsky.app/profile/espn.com, any host with the /profile/<actor> path), a DID (\"did:plc:..\", \"did:web:..\") or an at:// URI -> ONE profile record (did, handle, display_name, bio, avatar_url, banner, verified, followers, following, posts_count, likes_count, joined_at, labels, associated / verification blocks) + computed{engagement_rate, language, content_category, estimated_reach}. Single lookup: next_cursor is always null. An unknown / deactivated / taken-down account answers a status record (not_found | account_deactivated | account_takedown | invalid_input).","schema":{"type":"string","default":"bsky.app"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"compute_metrics","in":"query","required":false,"description":"true (default) = sample the latest `feed_sample` original posts for computed.language / engagement_rate / content_category and resolve the amplifiers of the newest `reach_sample` posts for computed.estimated_reach. false = profile only (1 request; engagement_rate / estimated_reach null, language and category from the bio). Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"feed_sample","in":"query","required":false,"description":"Original posts sampled for the computed block (1..100, default 30). Locked in cursor.","schema":{"type":"integer","default":30,"minimum":1,"maximum":100}},{"name":"reach_sample","in":"query","required":false,"description":"Newest sampled posts whose reposters / quoters are resolved for estimated_reach. v2 CAP 5 (v1 default 10) so the sync call fits the timeout; 0 = skip. Locked in cursor.","schema":{"type":"integer","default":5,"minimum":0,"maximum":5}},{"name":"amplifier_pages","in":"query","required":false,"description":"Pages of 100 reposters / quoters read per sampled post before extrapolating. v2 CAP 1 (v1 default 2). Locked in cursor.","schema":{"type":"integer","default":1,"minimum":1,"maximum":1}},{"name":"count_likes","in":"query","required":false,"description":"true (default) = walk the post history (100 posts a call) and sum likeCount -> likes_count (likes received). false = likes_count null. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"likes_max_posts","in":"query","required":false,"description":"Cap on the likes walk. v2 CAP 1000 (= 10 calls; v1 default 5000): past it likes_count is a lower bound (stats.likes_count_complete false + warning). Locked in cursor.","schema":{"type":"integer","default":1000,"minimum":100,"maximum":1000}},{"name":"page_fallback","in":"query","required":false,"description":"true (default) = bsky.app og-meta partial profile when the AppView is unreachable; false = status fetch_failed. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["bluesky"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bluesky Profile Info","operationId":"post_bluesky_profile_info","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"handles":{"type":"string","default":"bsky.app","description":"The Bluesky account: a handle (\"espn.com\", \"@espn.com\"), a profile URL (https://bsky.app/profile/espn.com, any host with the /profile/<actor> path), a DID (\"did:plc:..\", \"did:web:..\") or an at:// URI -> ONE profile record (did, handle, display_name, bio, avatar_url, banner, verified, followers, following, posts_count, likes_count, joined_at, labels, associated / verification blocks) + computed{engagement_rate, language, content_category, estimated_reach}. Single lookup: next_cursor is always null. An unknown / deactivated / taken-down account answers a status record (not_found | account_deactivated | account_takedown | invalid_input)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"compute_metrics":{"type":"boolean","default":true,"description":"true (default) = sample the latest `feed_sample` original posts for computed.language / engagement_rate / content_category and resolve the amplifiers of the newest `reach_sample` posts for computed.estimated_reach. false = profile only (1 request; engagement_rate / estimated_reach null, language and category from the bio). Locked in cursor."},"feed_sample":{"type":"integer","default":30,"minimum":1,"maximum":100,"description":"Original posts sampled for the computed block (1..100, default 30). Locked in cursor."},"reach_sample":{"type":"integer","default":5,"minimum":0,"maximum":5,"description":"Newest sampled posts whose reposters / quoters are resolved for estimated_reach. v2 CAP 5 (v1 default 10) so the sync call fits the timeout; 0 = skip. Locked in cursor."},"amplifier_pages":{"type":"integer","default":1,"minimum":1,"maximum":1,"description":"Pages of 100 reposters / quoters read per sampled post before extrapolating. v2 CAP 1 (v1 default 2). Locked in cursor."},"count_likes":{"type":"boolean","default":true,"description":"true (default) = walk the post history (100 posts a call) and sum likeCount -> likes_count (likes received). false = likes_count null. Locked in cursor."},"likes_max_posts":{"type":"integer","default":1000,"minimum":100,"maximum":1000,"description":"Cap on the likes walk. v2 CAP 1000 (= 10 calls; v1 default 5000): past it likes_count is a lower bound (stats.likes_count_complete false + warning). Locked in cursor."},"page_fallback":{"type":"boolean","default":true,"description":"true (default) = bsky.app og-meta partial profile when the AppView is unreachable; false = status fetch_failed. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["handles"]}}}}}},"/bluesky-single-posts/":{"get":{"tags":["bluesky"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bluesky Single Posts","operationId":"get_bluesky_single_posts","parameters":[{"name":"urls","in":"query","required":true,"description":"The Bluesky post: its URL (https://bsky.app/profile/<handle|did>/post/<rkey>), an at:// URI (at://<did|handle>/app.bsky.feed.post/<rkey>) or a bare \"<handle>/post/<rkey>\" -> 50 rows per call over the flattened thread: page 1 = the post row (row_type \"post\": text, author, media, like / reply / repost / quote counts, full postView, computed {engagement_rate, language, content_category, estimated_reach}, stats) + its ancestors when it is a reply (row_type \"parent\") + the first replies in thread order (row_type \"reply\", depth, thread_index, parent_uri, root_uri); later pages = replies only. A deleted / not-found / blocked post answers one status row (next_cursor null). Required on the first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"depth","in":"query","required":false,"description":"Reply levels below the post (default 6). 0 = the post alone. Locked in cursor.","schema":{"type":"integer","default":6,"minimum":0,"maximum":1000}},{"name":"parent_height","in":"query","required":false,"description":"Ancestors included as \"parent\" rows on page 1 when the post is a reply (default 80; 0 = none). Locked in cursor.","schema":{"type":"integer","default":80,"minimum":0,"maximum":1000}},{"name":"max_replies","in":"query","required":false,"description":"Direct replies to deliver. v2: 0 (default) = 200 (the AppView's own cap, so the reply-index top-up only runs for threads the AppView shortened); an explicit value is capped at 500 (v1 default 0 = all). Trimmed after reply_sort. Locked in cursor.","schema":{"type":"integer","default":0,"minimum":0,"maximum":500}},{"name":"reply_index","in":"query","required":false,"description":"true (default) = top up direct replies past the AppView's cap from the public reply index (constellation.microcosm.blue + getPosts); false = the thread call alone. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"reply_sort","in":"query","required":false,"description":"api (default - the AppView's order) | newest | oldest | top (likes, then replies), applied at every level. Locked in cursor.","schema":{"type":"string","default":"api","enum":["api","newest","oldest","top"]}},{"name":"compute_metrics","in":"query","required":false,"description":"true (default) = getProfile on the author (page 1) -> author_followers_count, computed.engagement_rate, flags.pinned. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"estimate_reach","in":"query","required":false,"description":"true (default) = reposters + quoters follower counts (page 1) -> computed.estimated_reach. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"reach_max_amplifiers","in":"query","required":false,"description":"Amplifiers resolved for estimated_reach. v2 CAP 100 (v1 default 500) so the sync call fits the timeout; past it the estimate is flagged partial. Locked in cursor.","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"video_duration","in":"query","required":false,"description":"true (default) = a video post gets duration_seconds from its HLS playlist (page 1). Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["bluesky"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bluesky Single Posts","operationId":"post_bluesky_single_posts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d","description":"The Bluesky post: its URL (https://bsky.app/profile/<handle|did>/post/<rkey>), an at:// URI (at://<did|handle>/app.bsky.feed.post/<rkey>) or a bare \"<handle>/post/<rkey>\" -> 50 rows per call over the flattened thread: page 1 = the post row (row_type \"post\": text, author, media, like / reply / repost / quote counts, full postView, computed {engagement_rate, language, content_category, estimated_reach}, stats) + its ancestors when it is a reply (row_type \"parent\") + the first replies in thread order (row_type \"reply\", depth, thread_index, parent_uri, root_uri); later pages = replies only. A deleted / not-found / blocked post answers one status row (next_cursor null). Required on the first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"depth":{"type":"integer","default":6,"minimum":0,"maximum":1000,"description":"Reply levels below the post (default 6). 0 = the post alone. Locked in cursor."},"parent_height":{"type":"integer","default":80,"minimum":0,"maximum":1000,"description":"Ancestors included as \"parent\" rows on page 1 when the post is a reply (default 80; 0 = none). Locked in cursor."},"max_replies":{"type":"integer","default":0,"minimum":0,"maximum":500,"description":"Direct replies to deliver. v2: 0 (default) = 200 (the AppView's own cap, so the reply-index top-up only runs for threads the AppView shortened); an explicit value is capped at 500 (v1 default 0 = all). Trimmed after reply_sort. Locked in cursor."},"reply_index":{"type":"boolean","default":true,"description":"true (default) = top up direct replies past the AppView's cap from the public reply index (constellation.microcosm.blue + getPosts); false = the thread call alone. Locked in cursor."},"reply_sort":{"type":"string","default":"api","enum":["api","newest","oldest","top"],"description":"api (default - the AppView's order) | newest | oldest | top (likes, then replies), applied at every level. Locked in cursor."},"compute_metrics":{"type":"boolean","default":true,"description":"true (default) = getProfile on the author (page 1) -> author_followers_count, computed.engagement_rate, flags.pinned. Locked in cursor."},"estimate_reach":{"type":"boolean","default":true,"description":"true (default) = reposters + quoters follower counts (page 1) -> computed.estimated_reach. Locked in cursor."},"reach_max_amplifiers":{"type":"integer","default":100,"minimum":1,"maximum":100,"description":"Amplifiers resolved for estimated_reach. v2 CAP 100 (v1 default 500) so the sync call fits the timeout; past it the estimate is flagged partial. Locked in cursor."},"video_duration":{"type":"boolean","default":true,"description":"true (default) = a video post gets duration_seconds from its HLS playlist (page 1). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/bluesky-user-posts/":{"get":{"tags":["bluesky"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bluesky User Posts","operationId":"get_bluesky_user_posts","parameters":[{"name":"handles","in":"query","required":true,"description":"Bluesky account: a handle (\"espn.com\", \"@espn.com\"), a profile URL (https://bsky.app/profile/espn.com), an at:// URI or a DID (\"did:plc:x7d6j54pm22ufehkes6jo4jf\") -> ONE native getAuthorFeed page (30 posts) per call in feed order, each row with the post's text, author, media, like / reply / repost / quote counts, the full post record + embed and the computed block (engagement_rate, language, content_category). An unknown / deactivated / taken-down / blocked account or an empty feed answers one status row (next_cursor null). Required on the first call; ignored when `cursor` is supplied. A raw Bluesky cursor (a v1 row's pagination.next_cursor) passed as `cursor` on the first call starts the walk there.","schema":{"type":"string","default":"espn.com"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"filter","in":"query","required":false,"description":"posts_and_author_threads (default) | posts_no_replies | posts_with_replies | posts_with_media | posts_with_video - getAuthorFeed's own filter (applied by Bluesky after slicing, so a page can be shorter than 30). Locked in cursor.","schema":{"type":"string","default":"posts_and_author_threads","enum":["posts_and_author_threads","posts_no_replies","posts_with_replies","posts_with_media","posts_with_video"]}},{"name":"include_pins","in":"query","required":false,"description":"true (default) = the pinned post rides on top of page 1 (is_pinned_copy true, an extra item); false = chronological only. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"compute_metrics","in":"query","required":false,"description":"true (default) = getProfile on page 1 fills account_followers_count / account_posts_count and computed.engagement_rate (carried in the cursor for later pages). Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"video_duration","in":"query","required":false,"description":"true (default) = video posts get duration_seconds from their HLS playlist. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["bluesky"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bluesky User Posts","operationId":"post_bluesky_user_posts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"handles":{"type":"string","default":"espn.com","description":"Bluesky account: a handle (\"espn.com\", \"@espn.com\"), a profile URL (https://bsky.app/profile/espn.com), an at:// URI or a DID (\"did:plc:x7d6j54pm22ufehkes6jo4jf\") -> ONE native getAuthorFeed page (30 posts) per call in feed order, each row with the post's text, author, media, like / reply / repost / quote counts, the full post record + embed and the computed block (engagement_rate, language, content_category). An unknown / deactivated / taken-down / blocked account or an empty feed answers one status row (next_cursor null). Required on the first call; ignored when `cursor` is supplied. A raw Bluesky cursor (a v1 row's pagination.next_cursor) passed as `cursor` on the first call starts the walk there."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"filter":{"type":"string","default":"posts_and_author_threads","enum":["posts_and_author_threads","posts_no_replies","posts_with_replies","posts_with_media","posts_with_video"],"description":"posts_and_author_threads (default) | posts_no_replies | posts_with_replies | posts_with_media | posts_with_video - getAuthorFeed's own filter (applied by Bluesky after slicing, so a page can be shorter than 30). Locked in cursor."},"include_pins":{"type":"boolean","default":true,"description":"true (default) = the pinned post rides on top of page 1 (is_pinned_copy true, an extra item); false = chronological only. Locked in cursor."},"compute_metrics":{"type":"boolean","default":true,"description":"true (default) = getProfile on page 1 fills account_followers_count / account_posts_count and computed.engagement_rate (carried in the cursor for later pages). Locked in cursor."},"video_duration":{"type":"boolean","default":true,"description":"true (default) = video posts get duration_seconds from their HLS playlist. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["handles"]}}}}}},"/booking-hotels/":{"get":{"tags":["booking"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Booking.com Hotels","operationId":"get_booking_hotels","parameters":[{"name":"search","in":"query","required":false,"description":"Place to search (city, district, region, country, landmark or airport name). Required unless dest_id or hotel_ids/urls is given.","schema":{"type":"string","default":"Prague"}},{"name":"dest_id","in":"query","required":false,"description":"Booking destination id (skips name lookup), e.g. -553173 for Prague. Optional.","schema":{"type":"string"}},{"name":"dest_type","in":"query","required":false,"description":"With dest_id: city, district, region, country, airport, landmark or hotel.","schema":{"type":"string","default":"city"}},{"name":"hotel_ids","in":"query","required":false,"description":"Detail mode: Booking hotel id(s) -> one row each with rooms/prices/facilities. POST: JSON array; GET / v2: first only.","schema":{"type":"string"}},{"name":"urls","in":"query","required":false,"description":"Detail mode: booking.com hotel page URL(s), resolved to the hotel by name.","schema":{"type":"string","format":"uri"}},{"name":"check_in","in":"query","required":false,"description":"YYYY-MM-DD (default: today + 30 days). Booking needs dates to quote prices.","schema":{"type":"string"}},{"name":"check_out","in":"query","required":false,"description":"YYYY-MM-DD (default: check_in + 2 nights).","schema":{"type":"string"}},{"name":"rooms","in":"query","required":false,"description":"Rooms (1-10).","schema":{"type":"integer","default":1}},{"name":"adults","in":"query","required":false,"description":"Adults (1-30).","schema":{"type":"integer","default":2}},{"name":"children","in":"query","required":false,"description":"Children (0-10).","schema":{"type":"integer","default":0}},{"name":"stars","in":"query","required":false,"description":"Star rating filter: any, or a comma list such as 4,5.","schema":{"type":"string","default":"any"}},{"name":"property_type","in":"query","required":false,"description":"none, hotels, apartments, hostels, guest_houses, homestays, boats, bed_and_breakfasts, resorts, villas, motels, holiday_homes, campsites ... or a numeric Booking property_type id (comma list).","schema":{"type":"string","default":"none"}},{"name":"min_price","in":"query","required":false,"description":"Minimum total price for the stay, in `currency`. Optional.","schema":{"type":"integer"}},{"name":"max_price","in":"query","required":false,"description":"Maximum total price for the stay, in `currency`. Optional.","schema":{"type":"integer"}},{"name":"currency","in":"query","required":false,"description":"Currency of the price filter. Booking quotes each hotel in its own currency (see the row `currency`).","schema":{"type":"string","default":"USD"}},{"name":"min_review_score","in":"query","required":false,"description":"Minimum guest score 5-9.","schema":{"type":"string"}},{"name":"free_cancellation","in":"query","required":false,"description":"Only hotels with free cancellation.","schema":{"type":"boolean","default":false}},{"name":"breakfast_included","in":"query","required":false,"description":"Only hotels with breakfast included.","schema":{"type":"boolean","default":false}},{"name":"sort_by","in":"query","required":false,"description":"popularity, distance, stars_desc, stars_asc, review_score or price (price order is approximate).","schema":{"type":"string","default":"popularity"}},{"name":"include_details","in":"query","required":false,"description":"Add rooms, facilities, address, languages and gallery to every search row (one extra call per hotel; slower).","schema":{"type":"boolean","default":false}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["booking"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Booking.com Hotels","operationId":"post_booking_hotels","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"search":{"type":"string","default":"Prague","description":"Place to search (city, district, region, country, landmark or airport name). Required unless dest_id or hotel_ids/urls is given."},"dest_id":{"type":"string","description":"Booking destination id (skips name lookup), e.g. -553173 for Prague. Optional."},"dest_type":{"type":"string","default":"city","description":"With dest_id: city, district, region, country, airport, landmark or hotel."},"hotel_ids":{"type":"string","description":"Detail mode: Booking hotel id(s) -> one row each with rooms/prices/facilities. POST: JSON array; GET / v2: first only."},"urls":{"type":"string","format":"uri","description":"Detail mode: booking.com hotel page URL(s), resolved to the hotel by name."},"check_in":{"type":"string","description":"YYYY-MM-DD (default: today + 30 days). Booking needs dates to quote prices."},"check_out":{"type":"string","description":"YYYY-MM-DD (default: check_in + 2 nights)."},"rooms":{"type":"integer","default":1,"description":"Rooms (1-10)."},"adults":{"type":"integer","default":2,"description":"Adults (1-30)."},"children":{"type":"integer","default":0,"description":"Children (0-10)."},"stars":{"type":"string","default":"any","description":"Star rating filter: any, or a comma list such as 4,5."},"property_type":{"type":"string","default":"none","description":"none, hotels, apartments, hostels, guest_houses, homestays, boats, bed_and_breakfasts, resorts, villas, motels, holiday_homes, campsites ... or a numeric Booking property_type id (comma list)."},"min_price":{"type":"integer","description":"Minimum total price for the stay, in `currency`. Optional."},"max_price":{"type":"integer","description":"Maximum total price for the stay, in `currency`. Optional."},"currency":{"type":"string","default":"USD","description":"Currency of the price filter. Booking quotes each hotel in its own currency (see the row `currency`)."},"min_review_score":{"type":"string","description":"Minimum guest score 5-9."},"free_cancellation":{"type":"boolean","default":false,"description":"Only hotels with free cancellation."},"breakfast_included":{"type":"boolean","default":false,"description":"Only hotels with breakfast included."},"sort_by":{"type":"string","default":"popularity","description":"popularity, distance, stars_desc, stars_asc, review_score or price (price order is approximate)."},"include_details":{"type":"boolean","default":false,"description":"Add rooms, facilities, address, languages and gallery to every search row (one extra call per hotel; slower)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/booking-reviews/":{"get":{"tags":["booking"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Booking.com Reviews","operationId":"get_booking_reviews","parameters":[{"name":"urls","in":"query","required":false,"description":"Booking.com hotel page URL (…/hotel/<cc>/<slug>.html); resolved to the hotel id by name. Required unless hotel_id is given. Required on the first call.","schema":{"type":"string","default":"https://www.booking.com/hotel/us/hilton-garden-inn-new-york-west-35th-street.html","format":"uri"}},{"name":"hotel_id","in":"query","required":false,"description":"Numeric Booking hotel id - skips URL resolution (use when a URL cannot be resolved). Optional.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"2-letter hotel country (only used with hotel_id, e.g. us). Optional.","schema":{"type":"string"}},{"name":"sort_reviews_by","in":"query","required":false,"description":"Newest first (default, stable), Oldest first, Highest scores, Lowest scores, Most relevant (Booking reshuffles this order between calls, so repeats are dropped and fewer rows may return).","schema":{"type":"string","default":"Newest first"}},{"name":"review_scores","in":"query","required":false,"description":"Score band: ALL, wonderful (9+), good (7-9), fair (5-7), poor (3-5), very_poor (<3).","schema":{"type":"string","default":"ALL"}},{"name":"language","in":"query","required":false,"description":"Only reviews in this language code(s), e.g. en or en,de. Optional.","schema":{"type":"string"}},{"name":"traveler_type","in":"query","required":false,"description":"families, couples, group_of_friends, solo_travellers or business_travellers (comma list). Optional.","schema":{"type":"string"}},{"name":"search_text","in":"query","required":false,"description":"Only reviews whose text contains this word. Optional.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["booking"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Booking.com Reviews","operationId":"post_booking_reviews","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.booking.com/hotel/us/hilton-garden-inn-new-york-west-35th-street.html","format":"uri","description":"Booking.com hotel page URL (…/hotel/<cc>/<slug>.html); resolved to the hotel id by name. Required unless hotel_id is given. Required on the first call."},"hotel_id":{"type":"string","description":"Numeric Booking hotel id - skips URL resolution (use when a URL cannot be resolved). Optional."},"country":{"type":"string","description":"2-letter hotel country (only used with hotel_id, e.g. us). Optional."},"sort_reviews_by":{"type":"string","default":"Newest first","description":"Newest first (default, stable), Oldest first, Highest scores, Lowest scores, Most relevant (Booking reshuffles this order between calls, so repeats are dropped and fewer rows may return)."},"review_scores":{"type":"string","default":"ALL","description":"Score band: ALL, wonderful (9+), good (7-9), fair (5-7), poor (3-5), very_poor (<3)."},"language":{"type":"string","description":"Only reviews in this language code(s), e.g. en or en,de. Optional."},"traveler_type":{"type":"string","description":"families, couples, group_of_friends, solo_travellers or business_travellers (comma list). Optional."},"search_text":{"type":"string","description":"Only reviews whose text contains this word. Optional."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/duckduckgo-search/":{"get":{"tags":["duckduckgo"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"DuckDuckGo Search Scraper","operationId":"get_duckduckgo_search","parameters":[{"name":"query","in":"query","required":true,"description":"Search term. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"python programming"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"search_mode","in":"query","required":false,"description":"Result type: default (web) | images | videos | news. Locked into the cursor on first call.","schema":{"type":"string","default":"default","enum":["default","images","videos","news"]}},{"name":"region","in":"query","required":false,"description":"DuckDuckGo region code (e.g. wt-wt, us-en, uk-en). Locked into the cursor.","schema":{"type":"string","default":"wt-wt"}},{"name":"safe_search","in":"query","required":false,"description":"Safe-search level. Locked into the cursor.","schema":{"type":"string","default":"OFF","enum":["OFF","MODERATE","STRICT"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["duckduckgo"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"DuckDuckGo Search Scraper","operationId":"post_duckduckgo_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"python programming","description":"Search term. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"search_mode":{"type":"string","default":"default","enum":["default","images","videos","news"],"description":"Result type: default (web) | images | videos | news. Locked into the cursor on first call."},"region":{"type":"string","default":"wt-wt","description":"DuckDuckGo region code (e.g. wt-wt, us-en, uk-en). Locked into the cursor."},"safe_search":{"type":"string","default":"OFF","enum":["OFF","MODERATE","STRICT"],"description":"Safe-search level. Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["query"]}}}}}},"/ebay-kleinanzeigen-scraper/":{"get":{"tags":["ebay"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"eBay Kleinanzeigen Scraper","operationId":"get_ebay_kleinanzeigen_scraper","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword or Kleinanzeigen URL. Required first call.","schema":{"type":"string","default":"basecap"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["ebay"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"eBay Kleinanzeigen Scraper","operationId":"post_ebay_kleinanzeigen_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"basecap","description":"Search keyword or Kleinanzeigen URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/ebay-listing/":{"get":{"tags":["ebay"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"eBay Listings","operationId":"get_ebay_listing","parameters":[{"name":"url","in":"query","required":true,"description":"eBay search URL containing /sch/ (required first call).","schema":{"type":"string","default":"https://www.ebay.com/sch/i.html?_nkw=shoe&_sop=12","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"timeout","in":"query","required":false,"description":"HTTP timeout in seconds (5–120)","schema":{"type":"integer","default":30}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["ebay"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"eBay Listings","operationId":"post_ebay_listing","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","default":"https://www.ebay.com/sch/i.html?_nkw=shoe&_sop=12","format":"uri","description":"eBay search URL containing /sch/ (required first call)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"timeout":{"type":"integer","default":30,"description":"HTTP timeout in seconds (5–120)"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["url"]}}}}}},"/ebay-product-details-scraper/":{"get":{"tags":["ebay"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"eBay Product Details Scraper","operationId":"get_ebay_product_details_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"eBay item URL or bare 9-15 digit item id. One record per item.","schema":{"type":"string","default":"https://www.ebay.com/itm/396090328598"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["ebay"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"eBay Product Details Scraper","operationId":"post_ebay_product_details_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.ebay.com/itm/396090328598","description":"eBay item URL or bare 9-15 digit item id. One record per item."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/ebay-review-scraper/":{"get":{"tags":["ebay"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"eBay Review Scraper","operationId":"get_ebay_review_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"eBay item URL or bare item id. Required on the first call.","schema":{"type":"string","default":"https://www.ebay.com/itm/205347362955"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"RELEVANCEV2 (default) or TIME. Locked in cursor.","schema":{"type":"string","default":"RELEVANCEV2","enum":["RELEVANCEV2","TIME"]}},{"name":"rating_type","in":"query","required":false,"description":"Rating filter (last 12 months). Locked in cursor.","schema":{"type":"string","default":"All ratings","enum":["All ratings","Positive","Neutral","Negative"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["ebay"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"eBay Review Scraper","operationId":"post_ebay_review_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.ebay.com/itm/205347362955","description":"eBay item URL or bare item id. Required on the first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","default":"RELEVANCEV2","enum":["RELEVANCEV2","TIME"],"description":"RELEVANCEV2 (default) or TIME. Locked in cursor."},"rating_type":{"type":"string","default":"All ratings","enum":["All ratings","Positive","Neutral","Negative"],"description":"Rating filter (last 12 months). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/ebay-seller-scraper/":{"get":{"tags":["ebay"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"eBay Seller Scraper","operationId":"get_ebay_seller_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"eBay seller profile URL or username. Required first call.","schema":{"type":"string","default":"https://www.ebay.co.uk/usr/chrisjoh7639"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Listings per seller (locked in cursor).","schema":{"type":"integer","default":100}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["ebay"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"eBay Seller Scraper","operationId":"post_ebay_seller_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.ebay.co.uk/usr/chrisjoh7639","description":"eBay seller profile URL or username. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_items":{"type":"integer","default":100,"description":"Listings per seller (locked in cursor)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/ebay-store-scraper/":{"get":{"tags":["ebay"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"eBay Store Scraper","operationId":"get_ebay_store_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"Store URL or username. Required first call.","schema":{"type":"string","default":"https://www.ebay.com/usr/shakaexpress"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_details","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"min_delay","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"1.2"}},{"name":"max_delay","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"2.5"}},{"name":"max_retries","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":4}},{"name":"storefront_tries","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":4}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["ebay"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"eBay Store Scraper","operationId":"post_ebay_store_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.ebay.com/usr/shakaexpress","description":"Store URL or username. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_details":{"type":"boolean","default":true,"description":"Locked in cursor."},"min_delay":{"type":"string","default":"1.2","description":"Locked in cursor."},"max_delay":{"type":"string","default":"2.5","description":"Locked in cursor."},"max_retries":{"type":"integer","default":4,"description":"Locked in cursor."},"storefront_tries":{"type":"integer","default":4,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/ecosia-search/":{"get":{"tags":["ecosia"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Ecosia Search","operationId":"get_ecosia_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term on ecosia.org. Required first call.","schema":{"type":"string","default":"climate change"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Search region/market. Locked in cursor.","schema":{"type":"string","default":"en-us"}},{"name":"include_html","in":"query","required":false,"description":"Emit HTML-highlighted fields. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["ecosia"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Ecosia Search","operationId":"post_ecosia_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"climate change","description":"Search term on ecosia.org. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"region":{"type":"string","default":"en-us","description":"Search region/market. Locked in cursor."},"include_html":{"type":"boolean","default":true,"description":"Emit HTML-highlighted fields. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/etsy-product-info-by-url/":{"get":{"tags":["etsy"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Etsy Product Info by Url","operationId":"get_etsy_product_info_by_url","parameters":[{"name":"urls","in":"query","required":true,"description":"Etsy listing URL or bare listing id. One record per call.","schema":{"type":"string","default":"https://www.etsy.com/listing/1215970085/custom-air-freshener"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Ship-to country, ISO-2. Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"currency","in":"query","required":false,"description":"ISO 4217 price currency. Locked in cursor.","schema":{"type":"string","default":"USD"}},{"name":"language","in":"query","required":false,"description":"Listing copy language. Locked in cursor.","schema":{"type":"string","default":"en-US"}},{"name":"render","in":"query","required":false,"description":"auto = HTTP (no browser) with browser fallback; http = never a browser.","schema":{"type":"string","default":"auto","enum":["auto","http","browser"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["etsy"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Etsy Product Info by Url","operationId":"post_etsy_product_info_by_url","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.etsy.com/listing/1215970085/custom-air-freshener","description":"Etsy listing URL or bare listing id. One record per call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"US","description":"Ship-to country, ISO-2. Locked in cursor."},"currency":{"type":"string","default":"USD","description":"ISO 4217 price currency. Locked in cursor."},"language":{"type":"string","default":"en-US","description":"Listing copy language. Locked in cursor."},"render":{"type":"string","default":"auto","enum":["auto","http","browser"],"description":"auto = HTTP (no browser) with browser fallback; http = never a browser."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/etsy-product-reviews/":{"get":{"tags":["etsy"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Etsy Product Reviews","operationId":"get_etsy_product_reviews","parameters":[{"name":"urls","in":"query","required":true,"description":"Etsy listing URL / listing id (product reviews) or shop URL / shop name (shop reviews). Required on the first call (list -> first only). 24 reviews per page.","schema":{"type":"string","default":"RosysPatterns"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_option","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"Recency","enum":["Recency","Relevancy","Highest","Lowest"]}},{"name":"enrich_buyer_profiles","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"include_subratings","in":"query","required":false,"description":"Best-effort (DataDome-gated). Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["etsy"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Etsy Product Reviews","operationId":"post_etsy_product_reviews","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"RosysPatterns","description":"Etsy listing URL / listing id (product reviews) or shop URL / shop name (shop reviews). Required on the first call (list -> first only). 24 reviews per page."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_option":{"type":"string","default":"Recency","enum":["Recency","Relevancy","Highest","Lowest"],"description":"Locked in cursor."},"enrich_buyer_profiles":{"type":"boolean","default":false,"description":"Locked in cursor."},"include_subratings":{"type":"boolean","default":false,"description":"Best-effort (DataDome-gated). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/etsy-search-by-keyword/":{"get":{"tags":["etsy"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Etsy Search by Keyword","operationId":"get_etsy_search_by_keyword","parameters":[{"name":"queries","in":"query","required":true,"description":"Plain Etsy search keywords. Required on the first call (list -> first only). One Etsy result page (~35-48 organic listings) per call.","schema":{"type":"string","default":"handmade necklace"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"enable_fallback","in":"query","required":false,"description":"Web-search-index fallback for page 1 when the Etsy search API is unusable.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["etsy"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Etsy Search by Keyword","operationId":"post_etsy_search_by_keyword","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"handmade necklace","description":"Plain Etsy search keywords. Required on the first call (list -> first only). One Etsy result page (~35-48 organic listings) per call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"enable_fallback":{"type":"boolean","default":true,"description":"Web-search-index fallback for page 1 when the Etsy search API is unusable."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/etsy-search-suggestions/":{"get":{"tags":["etsy"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Etsy Search Suggestions","operationId":"get_etsy_search_suggestions","parameters":[{"name":"queries","in":"query","required":true,"description":"Partial Etsy search text. Required on the first call. 20 suggestions per page.","schema":{"type":"string","default":"leather"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"locale","in":"query","required":false,"description":"Etsy suggestion language. Locked in cursor.","schema":{"type":"string","default":"en-US","enum":["en-US","en-GB","en-CA","en-AU","en-IN","de","fr","es","it","nl","pt","pl","sv","ja","ru"]}},{"name":"country","in":"query","required":false,"description":"ISO-2 region. Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"expand","in":"query","required":false,"description":"Alphabet expansion for pages beyond the base list. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"expansion_alphabet","in":"query","required":false,"description":"Blank = a-z0-9. Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["etsy"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Etsy Search Suggestions","operationId":"post_etsy_search_suggestions","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"leather","description":"Partial Etsy search text. Required on the first call. 20 suggestions per page."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"locale":{"type":"string","default":"en-US","enum":["en-US","en-GB","en-CA","en-AU","en-IN","de","fr","es","it","nl","pt","pl","sv","ja","ru"],"description":"Etsy suggestion language. Locked in cursor."},"country":{"type":"string","default":"US","description":"ISO-2 region. Locked in cursor."},"expand":{"type":"boolean","default":true,"description":"Alphabet expansion for pages beyond the base list. Locked in cursor."},"expansion_alphabet":{"type":"string","description":"Blank = a-z0-9. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/etsy-shop-products/":{"get":{"tags":["etsy"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Etsy Shop Products","operationId":"get_etsy_shop_products","parameters":[{"name":"urls","in":"query","required":true,"description":"Etsy shop URL, bare shop name or numeric shop id. Required first call.","schema":{"type":"string","default":"https://www.etsy.com/shop/AceElegance"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"most_recent","enum":["most_recent","price_low","price_high","custom","relevance"]}},{"name":"currency","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"USD"}},{"name":"search_query","in":"query","required":false,"description":"In-shop keyword. Locked in cursor.","schema":{"type":"string"}},{"name":"include_details","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["etsy"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Etsy Shop Products","operationId":"post_etsy_shop_products","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.etsy.com/shop/AceElegance","description":"Etsy shop URL, bare shop name or numeric shop id. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort":{"type":"string","default":"most_recent","enum":["most_recent","price_low","price_high","custom","relevance"],"description":"Locked in cursor."},"currency":{"type":"string","default":"USD","description":"Locked in cursor."},"search_query":{"type":"string","description":"In-shop keyword. Locked in cursor."},"include_details":{"type":"boolean","default":true,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/etsy-similar-products/":{"get":{"tags":["etsy"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Etsy Similar Products","operationId":"get_etsy_similar_products","parameters":[{"name":"urls","in":"query","required":true,"description":"Etsy listing URL or numeric listing id. Required on the first call (list -> first only). 20 products per page.","schema":{"type":"string","default":"1215970085"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Ship-to country. Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"currency","in":"query","required":false,"description":"Price currency. Locked in cursor.","schema":{"type":"string","default":"USD"}},{"name":"locale","in":"query","required":false,"description":"Copy language. Locked in cursor.","schema":{"type":"string","default":"en-US"}},{"name":"include_unavailable","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"expand_similar","in":"query","required":false,"description":"Similar-of-similar expansion past ~40. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["etsy"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Etsy Similar Products","operationId":"post_etsy_similar_products","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"1215970085","description":"Etsy listing URL or numeric listing id. Required on the first call (list -> first only). 20 products per page."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"US","description":"Ship-to country. Locked in cursor."},"currency":{"type":"string","default":"USD","description":"Price currency. Locked in cursor."},"locale":{"type":"string","default":"en-US","description":"Copy language. Locked in cursor."},"include_unavailable":{"type":"boolean","default":false,"description":"Locked in cursor."},"expand_similar":{"type":"boolean","default":true,"description":"Similar-of-similar expansion past ~40. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-ad-library/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Ad Library","operationId":"get_facebook_ad_library","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook Ad Library URL (search or page)","schema":{"type":"string","default":"https://www.facebook.com/ZapierApp","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"ad_country","in":"query","required":false,"description":"Country filter. Locked in cursor.","schema":{"type":"string","default":"ALL"}},{"name":"ad_type","in":"query","required":false,"description":"Ad type filter, lowercase (e.g. 'all', 'political_and_issue_ads') -- Facebook's URL route is case-sensitive; 'ALL' uppercase silently narrows results. Now actually applied (was previously dropped before reaching v1). Locked in cursor.","schema":{"type":"string","default":"all"}},{"name":"ad_status","in":"query","required":false,"description":"Active / Inactive / ALL. Locked in cursor.","schema":{"type":"string","default":"ALL"}},{"name":"scrape_details","in":"query","required":false,"description":"Fetch full ad details per item (slower). Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true --","schema":{"type":"boolean","default":true}},{"name":"country","in":"query","required":false,"description":"Default country code (e.g., ALL, US, IN)","schema":{"type":"string","default":"ALL"}},{"name":"period","in":"query","required":false,"description":"Facebook date_preset filter (e.g., ALL, LAST_30_DAYS) — leave empty to use URL default","schema":{"type":"string"}},{"name":"active_status","in":"query","required":false,"description":"Ad activity filter: all, active, or inactive","schema":{"type":"string","default":"all"}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Ad Library","operationId":"post_facebook_ad_library","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/ZapierApp","format":"uri","description":"Facebook Ad Library URL (search or page)"},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"ad_country":{"type":"string","default":"ALL","description":"Country filter. Locked in cursor."},"ad_type":{"type":"string","default":"all","description":"Ad type filter, lowercase (e.g. 'all', 'political_and_issue_ads') -- Facebook's URL route is case-sensitive; 'ALL' uppercase silently narrows results. Now actually applied (was previously dropped before reaching v1). Locked in cursor."},"ad_status":{"type":"string","default":"ALL","description":"Active / Inactive / ALL. Locked in cursor."},"scrape_details":{"type":"boolean","default":false,"description":"Fetch full ad details per item (slower). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true --"},"country":{"type":"string","default":"ALL","description":"Default country code (e.g., ALL, US, IN)"},"period":{"type":"string","description":"Facebook date_preset filter (e.g., ALL, LAST_30_DAYS) — leave empty to use URL default"},"active_status":{"type":"string","default":"all","description":"Ad activity filter: all, active, or inactive"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-ad-library-leads/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Ad Library Leads","operationId":"get_facebook_ad_library_leads","parameters":[{"name":"urls","in":"query","required":true,"description":"Ad Library search URL or public Page URL. Required first call. Locked in cursor.","schema":{"type":"string","default":"https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=plumber&search_type=keyword_unordered","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"ALL"}},{"name":"active_status","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"active","enum":["active","inactive","all"]}},{"name":"period","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string"}},{"name":"max_landing_pages_per_advertiser","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":3}},{"name":"max_concurrent_sources","in":"query","required":false,"description":"","schema":{"type":"integer","default":3}},{"name":"max_concurrent_advertisers","in":"query","required":false,"description":"","schema":{"type":"integer","default":5}},{"name":"max_concurrent_crawls","in":"query","required":false,"description":"","schema":{"type":"integer","default":10}},{"name":"cookie_override","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Ad Library Leads","operationId":"post_facebook_ad_library_leads","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=plumber&search_type=keyword_unordered","format":"uri","description":"Ad Library search URL or public Page URL. Required first call. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"ALL","description":"Locked in cursor."},"active_status":{"type":"string","default":"active","enum":["active","inactive","all"],"description":"Locked in cursor."},"period":{"type":"string","description":"Locked in cursor."},"max_landing_pages_per_advertiser":{"type":"integer","default":3,"description":"Locked in cursor."},"max_concurrent_sources":{"type":"integer","default":3,"description":""},"max_concurrent_advertisers":{"type":"integer","default":5,"description":""},"max_concurrent_crawls":{"type":"integer","default":10,"description":""},"cookie_override":{"type":"string","description":""},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-ad-library-transcript/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 3 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Ad Library Ad Transcript","operationId":"get_facebook_ad_library_transcript","parameters":[{"name":"urls","in":"query","required":true,"description":"Ad Library URL or bare numeric ad_archive_id. Lookup endpoint -- next_cursor null.","schema":{"type":"string","default":"1700351324346955"}},{"name":"model_size","in":"query","required":false,"description":"","schema":{"type":"string","default":"base","enum":["tiny","base","small","medium","large-v3"]}},{"name":"language","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"beam_size","in":"query","required":false,"description":"","schema":{"type":"integer","default":2}},{"name":"vad_filter","in":"query","required":false,"description":"","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 3 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Ad Library Ad Transcript","operationId":"post_facebook_ad_library_transcript","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"1700351324346955","description":"Ad Library URL or bare numeric ad_archive_id. Lookup endpoint -- next_cursor null."},"model_size":{"type":"string","default":"base","enum":["tiny","base","small","medium","large-v3"],"description":""},"language":{"type":"string","description":""},"beam_size":{"type":"integer","default":2,"description":""},"vad_filter":{"type":"boolean","default":true,"description":""},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-comment-replies/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Comment Replies","operationId":"get_facebook_comment_replies","parameters":[{"name":"feedback_id","in":"query","required":true,"description":"The top-level comment's id from a facebook-comments row: its `feedback_id` (base64 \"feedback:<post_id>_<comment_id>\") or its `id` (base64 \"comment:...\"); a bare \"<post_id>_<comment_id>\" also works. A post's own feedback id is rejected (400). Required first call. Locked in cursor.","schema":{"type":"string","default":"ZmVlZGJhY2s6NjM3NTIxOTM0MjU1MjExMl8xOTEwNzI1NzMwMDg2NDU="}},{"name":"expansion_token","in":"query","required":false,"description":"Optional. The short-lived \"View N replies\" token; when omitted or expired a fresh one is resolved from feedback_id. Locked in cursor.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Comment Replies","operationId":"post_facebook_comment_replies","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"feedback_id":{"type":"string","default":"ZmVlZGJhY2s6NjM3NTIxOTM0MjU1MjExMl8xOTEwNzI1NzMwMDg2NDU=","description":"The top-level comment's id from a facebook-comments row: its `feedback_id` (base64 \"feedback:<post_id>_<comment_id>\") or its `id` (base64 \"comment:...\"); a bare \"<post_id>_<comment_id>\" also works. A post's own feedback id is rejected (400). Required first call. Locked in cursor."},"expansion_token":{"type":"string","description":"Optional. The short-lived \"View N replies\" token; when omitted or expired a fresh one is resolved from feedback_id. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["feedback_id"]}}}}}},"/facebook-comments/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Comments","operationId":"get_facebook_comments","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook post URL. Required first call.","schema":{"type":"string","default":"https://www.facebook.com/humansofnewyork/posts/pfbid0BbKbkisExKGSKuhee9a7i86RwRuMKFC8NSkKStB7CsM3uXJuAAfZLrkcJMXxhH4Yl","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_replies","in":"query","required":false,"description":"Fetch replies per comment when true; false skips replies entirely. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"max_reply_per_comment","in":"query","required":false,"description":"Max replies per top-level comment, or ALL (string) for no numeric cap. Locked in cursor.","schema":{"type":"integer","default":2}},{"name":"comments_sort_order","in":"query","required":false,"description":"Comment order: all (every comment, oldest first) | newest | most_relevant (ranked by relevance, not by reaction count). Applied server-side before paging, so cursor pages never overlap or skip. Locked in cursor.","schema":{"type":"string","default":"all","enum":["all","newest","most_relevant"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Comments","operationId":"post_facebook_comments","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/humansofnewyork/posts/pfbid0BbKbkisExKGSKuhee9a7i86RwRuMKFC8NSkKStB7CsM3uXJuAAfZLrkcJMXxhH4Yl","format":"uri","description":"Facebook post URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_replies":{"type":"boolean","default":false,"description":"Fetch replies per comment when true; false skips replies entirely. Locked in cursor."},"max_reply_per_comment":{"type":"integer","default":2,"description":"Max replies per top-level comment, or ALL (string) for no numeric cap. Locked in cursor."},"comments_sort_order":{"type":"string","default":"all","enum":["all","newest","most_relevant"],"description":"Comment order: all (every comment, oldest first) | newest | most_relevant (ranked by relevance, not by reaction count). Applied server-side before paging, so cursor pages never overlap or skip. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-event-scraper/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Event Search","operationId":"get_facebook_event_scraper","parameters":[{"name":"queries","in":"query","required":true,"description":"Event search keyword. Required first call.","schema":{"type":"string","default":"Comedy"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"location","in":"query","required":false,"description":"NOT functional: accepted for input compatibility but never sent to Facebook. Confirmed live -- anonymous events-search resolves a city through a separate typeahead endpoint this scraper doesn't have, and sending a raw city name/id is silently WORSE than omitting it (Facebook accepts it with no error but returns zero events). Locked in cursor.","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Event category (e.g. 'Comedy', 'Music and audio', 'Sports'). Matched live against Facebook's own category menu (case-insensitive, substring match) -- confirmed to change results. Locked in cursor.","schema":{"type":"string"}},{"name":"time_filter","in":"query","required":false,"description":"Date filter: a live preset label ('Today', 'Tomorrow', 'This week', 'This weekend', 'Next week', 'Next weekend', 'In the next month') or an explicit YYYY-MM-DD / YYYY-MM-DD~YYYY-MM-DD range. Confirmed live to change results. Locked in cursor.","schema":{"type":"string"}},{"name":"details","in":"query","required":false,"description":"true = also open each event's own page (+~150 KB each) for full description, address/geo, organizers, child events. false = search-listing fields only. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Event Search","operationId":"post_facebook_event_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"Comedy","description":"Event search keyword. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"location":{"type":"string","description":"NOT functional: accepted for input compatibility but never sent to Facebook. Confirmed live -- anonymous events-search resolves a city through a separate typeahead endpoint this scraper doesn't have, and sending a raw city name/id is silently WORSE than omitting it (Facebook accepts it with no error but returns zero events). Locked in cursor."},"category":{"type":"string","description":"Event category (e.g. 'Comedy', 'Music and audio', 'Sports'). Matched live against Facebook's own category menu (case-insensitive, substring match) -- confirmed to change results. Locked in cursor."},"time_filter":{"type":"string","description":"Date filter: a live preset label ('Today', 'Tomorrow', 'This week', 'This weekend', 'Next week', 'Next weekend', 'In the next month') or an explicit YYYY-MM-DD / YYYY-MM-DD~YYYY-MM-DD range. Confirmed live to change results. Locked in cursor."},"details":{"type":"boolean","default":false,"description":"true = also open each event's own page (+~150 KB each) for full description, address/geo, organizers, child events. false = search-listing fields only. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/facebook-follower-following/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Followers/Following","operationId":"get_facebook_follower_following","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook profile/page URL. Required first call.","schema":{"type":"string","default":"https://www.facebook.com/LeonardoDiCaprio","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"follow_type","in":"query","required":false,"description":"followers | following | both. Locked in cursor.","schema":{"type":"string","default":"both","enum":["followers","following","both"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Followers/Following","operationId":"post_facebook_follower_following","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/LeonardoDiCaprio","format":"uri","description":"Facebook profile/page URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"follow_type":{"type":"string","default":"both","enum":["followers","following","both"],"description":"followers | following | both. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-group-posts/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Group Posts","operationId":"get_facebook_group_posts","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook group URL. Required first call.","schema":{"type":"string","default":"https://www.facebook.com/groups/535363634111893","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"Alias for view_option (CHRONOLOGICAL / RECENT_ACTIVITY / TOP_POSTS / CHRONOLOGICAL_LISTINGS); wins over view_option when both given. Resolved on the first call, locked in cursor.","schema":{"type":"string","default":"RECENT_ACTIVITY"}},{"name":"keywords","in":"query","required":false,"description":"Optional keywords to filter posts by text (case-insensitive, comma-separated). Locked in cursor.","schema":{"type":"string"}},{"name":"view_option","in":"query","required":false,"description":"Sorting: CHRONOLOGICAL, RECENT_ACTIVITY, TOP_POSTS, CHRONOLOGICAL_LISTINGS. Locked in cursor.","schema":{"type":"string","default":"RECENT_ACTIVITY"}},{"name":"search_group_keyword","in":"query","required":false,"description":"Client-side filter by keyword/letter (single letter recommended) -- not a native Facebook search. Locked in cursor.","schema":{"type":"string"}},{"name":"search_group_year","in":"query","required":false,"description":"Filter posts by year (e.g., \"2024\")","schema":{"type":"string"}},{"name":"only_posts_newer_than","in":"query","required":false,"description":"Filter posts newer than date (YYYY-MM-DD, ISO, or relative like \"2 months\", \"1 days\")","schema":{"type":"string"}},{"name":"cookie_string","in":"query","required":false,"description":"Facebook cookie string for authentication (optional but recommended)","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Group Posts","operationId":"post_facebook_group_posts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/groups/535363634111893","format":"uri","description":"Facebook group URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","default":"RECENT_ACTIVITY","description":"Alias for view_option (CHRONOLOGICAL / RECENT_ACTIVITY / TOP_POSTS / CHRONOLOGICAL_LISTINGS); wins over view_option when both given. Resolved on the first call, locked in cursor."},"keywords":{"type":"string","description":"Optional keywords to filter posts by text (case-insensitive, comma-separated). Locked in cursor."},"view_option":{"type":"string","default":"RECENT_ACTIVITY","description":"Sorting: CHRONOLOGICAL, RECENT_ACTIVITY, TOP_POSTS, CHRONOLOGICAL_LISTINGS. Locked in cursor."},"search_group_keyword":{"type":"string","description":"Client-side filter by keyword/letter (single letter recommended) -- not a native Facebook search. Locked in cursor."},"search_group_year":{"type":"string","description":"Filter posts by year (e.g., \"2024\")"},"only_posts_newer_than":{"type":"string","description":"Filter posts newer than date (YYYY-MM-DD, ISO, or relative like \"2 months\", \"1 days\")"},"cookie_string":{"type":"string","description":"Facebook cookie string for authentication (optional but recommended)"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-group-profile/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Group Profile","operationId":"get_facebook_group_profile","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook group URL. Lookup endpoint — next_cursor is always null.","schema":{"type":"string","default":"https://www.facebook.com/groups/535363634111893","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Group Profile","operationId":"post_facebook_group_profile","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/groups/535363634111893","format":"uri","description":"Facebook group URL. Lookup endpoint — next_cursor is always null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-group-search/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Group Search","operationId":"get_facebook_group_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword. Required first call.","schema":{"type":"string","default":"bmw\nmercedes"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Group Search","operationId":"post_facebook_group_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"bmw\nmercedes","description":"Search keyword. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/facebook-marketplace/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Marketplace","operationId":"get_facebook_marketplace","parameters":[{"name":"urls","in":"query","required":true,"description":"Marketplace search URL (with '?query=<term>') or category/browse URL (e.g. /marketplace/category/vehicles, no query needed) — both return real listings fully anonymously. Required first call.","schema":{"type":"string","default":"https://www.facebook.com/marketplace/108479165840750/search/?query=phone","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"deepScrape","in":"query","required":false,"description":"Fetch detailed per-listing (PDP) data. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"cookie_string","in":"query","required":false,"description":"Optional Facebook session cookie (\"c_user=...; xs=...\") for a genuinely logged-in scrape. NOT required for baseline results. Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Marketplace","operationId":"post_facebook_marketplace","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/marketplace/108479165840750/search/?query=phone","format":"uri","description":"Marketplace search URL (with '?query=<term>') or category/browse URL (e.g. /marketplace/category/vehicles, no query needed) — both return real listings fully anonymously. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"deepScrape":{"type":"boolean","default":false,"description":"Fetch detailed per-listing (PDP) data. Locked in cursor."},"cookie_string":{"type":"string","description":"Optional Facebook session cookie (\"c_user=...; xs=...\") for a genuinely logged-in scrape. NOT required for baseline results. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-page/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Page","operationId":"get_facebook_page","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook page URL or username. Lookup endpoint — next_cursor is always null.","schema":{"type":"string","default":"copperkettleyqr","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Page","operationId":"post_facebook_page","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"copperkettleyqr","format":"uri","description":"Facebook page URL or username. Lookup endpoint — next_cursor is always null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-page-contact/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Page Contact Info","operationId":"get_facebook_page_contact","parameters":[{"name":"urls","in":"query","required":true,"description":"A single Facebook page URL/username → contact info. Lookup endpoint — next_cursor null. Aliases: url.","schema":{"type":"string","default":"https://www.facebook.com/copperkettleyqr/","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Page Contact Info","operationId":"post_facebook_page_contact","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/copperkettleyqr/","format":"uri","description":"A single Facebook page URL/username → contact info. Lookup endpoint — next_cursor null. Aliases: url."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-page-posts/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Page Posts","operationId":"get_facebook_page_posts","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook page URL. Required first call.","schema":{"type":"string","default":"https://www.facebook.com/LombardOlkusz","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"newer_than","in":"query","required":false,"description":"Optional ISO date or relative expression (e.g. \"2 months\") -- passed to Facebook's native afterTime timeline argument. Live-verified functional; most reliable when passed together with older_than as a bracket (Facebook's own profile \"jump to date\" UI always drives them together) — used alone with a mid-range value it can return an empty page even though newer posts exist. Locked in cursor.","schema":{"type":"string"}},{"name":"older_than","in":"query","required":false,"description":"Optional ISO date or relative expression (e.g. \"1 months\") -- passed to Facebook's native beforeTime timeline argument; live-verified to reliably shift results to posts created before this time. Locked in cursor.","schema":{"type":"string"}},{"name":"cookie_string","in":"query","required":false,"description":"Optional Facebook session cookie (\"c_user=...; xs=...\") for a logged-in scrape. NOT required for baseline results. Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Page Posts","operationId":"post_facebook_page_posts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/LombardOlkusz","format":"uri","description":"Facebook page URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"newer_than":{"type":"string","description":"Optional ISO date or relative expression (e.g. \"2 months\") -- passed to Facebook's native afterTime timeline argument. Live-verified functional; most reliable when passed together with older_than as a bracket (Facebook's own profile \"jump to date\" UI always drives them together) — used alone with a mid-range value it can return an empty page even though newer posts exist. Locked in cursor."},"older_than":{"type":"string","description":"Optional ISO date or relative expression (e.g. \"1 months\") -- passed to Facebook's native beforeTime timeline argument; live-verified to reliably shift results to posts created before this time. Locked in cursor."},"cookie_string":{"type":"string","description":"Optional Facebook session cookie (\"c_user=...; xs=...\") for a logged-in scrape. NOT required for baseline results. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-photos/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Photos","operationId":"get_facebook_photos","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook page/profile URL. Required first call.","schema":{"type":"string","default":"IamSRK","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Photos","operationId":"post_facebook_photos","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"IamSRK","format":"uri","description":"Facebook page/profile URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-posts/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Posts — profile-level","operationId":"get_facebook_posts","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook profile URL. Required first call.","schema":{"type":"string","default":"https://www.facebook.com/nytimes/","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"newer_than","in":"query","required":false,"description":"Optional ISO date filter. Locked in cursor.","schema":{"type":"string"}},{"name":"older_than","in":"query","required":false,"description":"Optional ISO date filter. Locked in cursor.","schema":{"type":"string"}},{"name":"captionText","in":"query","required":false,"description":"Include post text in the output (default: true)","schema":{"type":"boolean","default":true}},{"name":"onlyPostsNewerThan","in":"query","required":false,"description":"Filter: only posts newer than this date or relative period (e.g. 2024-01-01, 30 days)","schema":{"type":"string"}},{"name":"onlyPostsOlderThan","in":"query","required":false,"description":"Filter: only posts older than this date or relative period","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Posts — profile-level","operationId":"post_facebook_posts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/nytimes/","format":"uri","description":"Facebook profile URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"newer_than":{"type":"string","description":"Optional ISO date filter. Locked in cursor."},"older_than":{"type":"string","description":"Optional ISO date filter. Locked in cursor."},"captionText":{"type":"boolean","default":true,"description":"Include post text in the output (default: true)"},"onlyPostsNewerThan":{"type":"string","description":"Filter: only posts newer than this date or relative period (e.g. 2024-01-01, 30 days)"},"onlyPostsOlderThan":{"type":"string","description":"Filter: only posts older than this date or relative period"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-profile-albums/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Profile Albums","operationId":"get_facebook_profile_albums","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook profile/page URL, Photos/Albums tab, single album URL, username or id. Required on the first call.","schema":{"type":"string","default":"https://www.facebook.com/zuck"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"page_size","in":"query","required":false,"description":"Photos per page (max 100).","schema":{"type":"integer","default":20}},{"name":"photos_newer_than","in":"query","required":false,"description":"Date lower bound. Locked in cursor.","schema":{"type":"string"}},{"name":"photos_older_than","in":"query","required":false,"description":"Date upper bound. Locked in cursor.","schema":{"type":"string"}},{"name":"enrich_photos","in":"query","required":false,"description":"Extra per-photo engagement query. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Profile Albums","operationId":"post_facebook_profile_albums","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/zuck","description":"Facebook profile/page URL, Photos/Albums tab, single album URL, username or id. Required on the first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"page_size":{"type":"integer","default":20,"description":"Photos per page (max 100)."},"photos_newer_than":{"type":"string","description":"Date lower bound. Locked in cursor."},"photos_older_than":{"type":"string","description":"Date upper bound. Locked in cursor."},"enrich_photos":{"type":"boolean","default":false,"description":"Extra per-photo engagement query. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-profile-events/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Profile Events","operationId":"get_facebook_profile_events","parameters":[{"name":"urls","in":"query","required":true,"description":"One Facebook page/profile URL, username or numeric id. First only. Continue with the previous response next_cursor.","schema":{"type":"string","default":"https://www.facebook.com/RedRocksCO"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"scope","in":"query","required":false,"description":"Which collections to read. Locked in cursor.","schema":{"type":"string","default":"all","enum":["all","upcoming","past"]}},{"name":"newer_than","in":"query","required":false,"description":"Start-time window low bound. Locked in cursor.","schema":{"type":"string"}},{"name":"older_than","in":"query","required":false,"description":"Start-time window high bound. Locked in cursor.","schema":{"type":"string"}},{"name":"details","in":"query","required":false,"description":"Fetch per-event permalink extras. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"locale","in":"query","required":false,"description":"Facebook locale. Locked in cursor.","schema":{"type":"string","default":"en_US"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Profile Events","operationId":"post_facebook_profile_events","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/RedRocksCO","description":"One Facebook page/profile URL, username or numeric id. First only. Continue with the previous response next_cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"scope":{"type":"string","default":"all","enum":["all","upcoming","past"],"description":"Which collections to read. Locked in cursor."},"newer_than":{"type":"string","description":"Start-time window low bound. Locked in cursor."},"older_than":{"type":"string","description":"Start-time window high bound. Locked in cursor."},"details":{"type":"boolean","default":false,"description":"Fetch per-event permalink extras. Locked in cursor."},"locale":{"type":"string","default":"en_US","description":"Facebook locale. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-reels/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Reels","operationId":"get_facebook_reels","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook profile URL with reels. Required first call.","schema":{"type":"string","default":"mrbeast","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Reels","operationId":"post_facebook_reels","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"mrbeast","format":"uri","description":"Facebook profile URL with reels. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-reviews/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Reviews","operationId":"get_facebook_reviews","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook page URL (must have reviews enabled). Required first call.","schema":{"type":"string","default":"mrbeast","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Reviews","operationId":"post_facebook_reviews","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"mrbeast","format":"uri","description":"Facebook page URL (must have reviews enabled). Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-single-photo-scraper/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Single Photo Scraper","operationId":"get_facebook_single_photo_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook photo URL or bare fbid. One photo per call.","schema":{"type":"string","default":"https://www.facebook.com/photo/?fbid=1616406629842169&set=a.271269304355915"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"post_stats","in":"query","required":false,"description":"Also fetch containing-post comments/shares/reactions (default true).","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Single Photo Scraper","operationId":"post_facebook_single_photo_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/photo/?fbid=1616406629842169&set=a.271269304355915","description":"Facebook photo URL or bare fbid. One photo per call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"post_stats":{"type":"boolean","default":true,"description":"Also fetch containing-post comments/shares/reactions (default true)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-single-post-scraper/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Single Post Scraper","operationId":"get_facebook_single_post_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook post URL/id. Required. One post per call; next_cursor is always null.","schema":{"type":"string","default":"https://www.facebook.com/nytimes/posts/pfbid02WfD8kRLsDeXyaqA62K1p9eLE11SApY89ABXjNdNuiQKrizrJadhpxt67YfZ9Nkfl"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Single Post Scraper","operationId":"post_facebook_single_post_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/nytimes/posts/pfbid02WfD8kRLsDeXyaqA62K1p9eLE11SApY89ABXjNdNuiQKrizrJadhpxt67YfZ9Nkfl","description":"Facebook post URL/id. Required. One post per call; next_cursor is always null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-single-reel-scraper/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Single Reel Scraper","operationId":"get_facebook_single_reel_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook reel URL or bare id. One reel per call.","schema":{"type":"string","default":"https://www.facebook.com/reel/1819667115884682"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Single Reel Scraper","operationId":"post_facebook_single_reel_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/reel/1819667115884682","description":"Facebook reel URL or bare id. One reel per call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-url-to-id/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook URL to ID","operationId":"get_facebook_url_to_id","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook page/group/post URL. Required first call.","schema":{"type":"string","default":"https://www.facebook.com/NintendoAmerica"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Maximum post IDs per post URL (locked in cursor).","schema":{"type":"integer","default":10}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook URL to ID","operationId":"post_facebook_url_to_id","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/NintendoAmerica","description":"Facebook page/group/post URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_items":{"type":"integer","default":10,"description":"Maximum post IDs per post URL (locked in cursor)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-video-search/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Video Search","operationId":"get_facebook_video_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Video search keyword. Required first call.","schema":{"type":"string","default":"funny cats"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Video Search","operationId":"post_facebook_video_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"funny cats","description":"Video search keyword. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/facebook-video-transcript/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Video Transcript","operationId":"get_facebook_video_transcript","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook video URL. Lookup endpoint.","schema":{"type":"string","default":"https://www.facebook.com/reel/814948253914000","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Video Transcript","operationId":"post_facebook_video_transcript","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/reel/814948253914000","format":"uri","description":"Facebook video URL. Lookup endpoint."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/facebook-videos/":{"get":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Videos","operationId":"get_facebook_videos","parameters":[{"name":"urls","in":"query","required":true,"description":"Facebook video URL. Lookup endpoint (uses yt-dlp).","schema":{"type":"string","default":"https://www.facebook.com/reel/1661703928606267","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["facebook"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Facebook Videos","operationId":"post_facebook_videos","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.facebook.com/reel/1661703928606267","format":"uri","description":"Facebook video URL. Lookup endpoint (uses yt-dlp)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/glassdoor-jobs/":{"get":{"tags":["glassdoor"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Glassdoor Jobs","operationId":"get_glassdoor_jobs","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword. Required first call. Locked in cursor.","schema":{"type":"string","default":"Software Engineer"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"location","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string"}},{"name":"base_url","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"https://www.glassdoor.com","format":"uri"}},{"name":"radius","in":"query","required":false,"description":"","schema":{"type":"integer","default":18,"enum":[0,6,12,18,31,62,124]}},{"name":"include_no_salary_job","in":"query","required":false,"description":"","schema":{"type":"boolean","default":false}},{"name":"company_name","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string"}},{"name":"min_salary","in":"query","required":false,"description":"","schema":{"type":"integer","default":0}},{"name":"max_salary","in":"query","required":false,"description":"","schema":{"type":"integer","default":0}},{"name":"from_age","in":"query","required":false,"description":"","schema":{"type":"string","default":"ANY"}},{"name":"job_type","in":"query","required":false,"description":"","schema":{"type":"string","default":"all"}},{"name":"seniority_type","in":"query","required":false,"description":"","schema":{"type":"string","default":"all"}},{"name":"industry_type","in":"query","required":false,"description":"","schema":{"type":"string","default":"ALL"}},{"name":"domain_type","in":"query","required":false,"description":"","schema":{"type":"string","default":"ALL"}},{"name":"employer_sizes","in":"query","required":false,"description":"","schema":{"type":"string","default":"ALL"}},{"name":"application_type","in":"query","required":false,"description":"","schema":{"type":"string","default":"ALL"}},{"name":"remote_work_type","in":"query","required":false,"description":"","schema":{"type":"boolean","default":false}},{"name":"min_rating","in":"query","required":false,"description":"","schema":{"type":"string","default":"0"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["glassdoor"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Glassdoor Jobs","operationId":"post_glassdoor_jobs","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"Software Engineer","description":"Search keyword. Required first call. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"location":{"type":"string","description":"Locked in cursor."},"base_url":{"type":"string","default":"https://www.glassdoor.com","format":"uri","description":"Locked in cursor."},"radius":{"type":"integer","default":18,"enum":[0,6,12,18,31,62,124],"description":""},"include_no_salary_job":{"type":"boolean","default":false,"description":""},"company_name":{"type":"string","description":"Locked in cursor."},"min_salary":{"type":"integer","default":0,"description":""},"max_salary":{"type":"integer","default":0,"description":""},"from_age":{"type":"string","default":"ANY","description":""},"job_type":{"type":"string","default":"all","description":""},"seniority_type":{"type":"string","default":"all","description":""},"industry_type":{"type":"string","default":"ALL","description":""},"domain_type":{"type":"string","default":"ALL","description":""},"employer_sizes":{"type":"string","default":"ALL","description":""},"application_type":{"type":"string","default":"ALL","description":""},"remote_work_type":{"type":"boolean","default":false,"description":""},"min_rating":{"type":"string","default":"0","description":""},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/glassdoor-review-scraper/":{"get":{"tags":["glassdoor"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Glassdoor Review Scraper","operationId":"get_glassdoor_review_scraper","parameters":[{"name":"company_urls","in":"query","required":true,"description":"Glassdoor company URL or employer id. Required first call.","schema":{"type":"string","default":"https://www.glassdoor.com/Overview/Working-at-IBM-EI_IE354.11,14.htm"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_result","in":"query","required":false,"description":"Maximum reviews returned per company (locked in cursor).","schema":{"type":"integer","default":20}},{"name":"page_size","in":"query","required":false,"description":"GraphQL page size per request (max 100, locked in cursor).","schema":{"type":"integer","default":10}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["glassdoor"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Glassdoor Review Scraper","operationId":"post_glassdoor_review_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"company_urls":{"type":"string","default":"https://www.glassdoor.com/Overview/Working-at-IBM-EI_IE354.11,14.htm","description":"Glassdoor company URL or employer id. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_result":{"type":"integer","default":20,"description":"Maximum reviews returned per company (locked in cursor)."},"page_size":{"type":"integer","default":10,"description":"GraphQL page size per request (max 100, locked in cursor)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["company_urls"]}}}}}},"/google-ad-library-leads/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Ad Library Leads","operationId":"get_google_ad_library_leads","parameters":[{"name":"urls","in":"query","required":true,"description":"Google Ads Transparency Center advertiser URL. Single lookup -- next_cursor always null.","schema":{"type":"string","default":"https://adstransparency.google.com/advertiser/AR04619580580634296321","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":200}},{"name":"max_creatives_to_try","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":12}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Ad Library Leads","operationId":"post_google_ad_library_leads","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://adstransparency.google.com/advertiser/AR04619580580634296321","format":"uri","description":"Google Ads Transparency Center advertiser URL. Single lookup -- next_cursor always null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_items":{"type":"integer","default":200,"description":"Locked in cursor."},"max_creatives_to_try":{"type":"integer","default":12,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/google-ads-transparency/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Ad Transparency","operationId":"get_google_ads_transparency","parameters":[{"name":"urls","in":"query","required":true,"description":"Google Ad Transparency advertiser URL. Required first call.","schema":{"type":"string","default":"https://adstransparency.google.com/advertiser/AR04619580580634296321","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Ad Transparency","operationId":"post_google_ads_transparency","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://adstransparency.google.com/advertiser/AR04619580580634296321","format":"uri","description":"Google Ad Transparency advertiser URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/google-autocomplete/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Autocomplete","operationId":"get_google_autocomplete","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term(s). Required first call. Lookup endpoint.","schema":{"type":"string","default":"machine learning"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_prefix","in":"query","required":false,"description":"Add alpha prefixes (a-z) to each query for SEO expansion.","schema":{"type":"boolean","default":true}},{"name":"use_suffix","in":"query","required":false,"description":"Add alpha suffixes (a-z) to each query for SEO expansion.","schema":{"type":"boolean","default":true}},{"name":"language","in":"query","required":false,"description":"Language name or hl code (e.g. English, en, Spanish).","schema":{"type":"string","default":"English"}},{"name":"country","in":"query","required":false,"description":"Country name or gl code (e.g. Bangladesh, bd, us).","schema":{"type":"string","default":"United States"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Autocomplete","operationId":"post_google_autocomplete","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"machine learning","description":"Search term(s). Required first call. Lookup endpoint."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_prefix":{"type":"boolean","default":true,"description":"Add alpha prefixes (a-z) to each query for SEO expansion."},"use_suffix":{"type":"boolean","default":true,"description":"Add alpha suffixes (a-z) to each query for SEO expansion."},"language":{"type":"string","default":"English","description":"Language name or hl code (e.g. English, en, Spanish)."},"country":{"type":"string","default":"United States","description":"Country name or gl code (e.g. Bangladesh, bd, us)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/google-finance-scraper/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Finance Scraper","operationId":"get_google_finance_scraper","parameters":[{"name":"tickers","in":"query","required":true,"description":"Google Finance ticker. Required first call.","schema":{"type":"string","default":"GOOGL:NASDAQ"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"period","in":"query","required":false,"description":"Historical window (locked in cursor).","schema":{"type":"string","default":"1M","enum":["1D","5D","1M","6M","YTD","1Y","5Y"]}},{"name":"max_items","in":"query","required":false,"description":"Max rows per ticker (locked in cursor).","schema":{"type":"integer","default":200}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Finance Scraper","operationId":"post_google_finance_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tickers":{"type":"string","default":"GOOGL:NASDAQ","description":"Google Finance ticker. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"period":{"type":"string","default":"1M","enum":["1D","5D","1M","6M","YTD","1Y","5Y"],"description":"Historical window (locked in cursor)."},"max_items":{"type":"integer","default":200,"description":"Max rows per ticker (locked in cursor)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["tickers"]}}}}}},"/google-image-scraper/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Image Scraper","operationId":"get_google_image_scraper","parameters":[{"name":"queries","in":"query","required":true,"description":"Image search query. Required first call.","schema":{"type":"string","default":"Nature"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Maximum images per query (locked in cursor).","schema":{"type":"integer","default":100}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Image Scraper","operationId":"post_google_image_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"Nature","description":"Image search query. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_items":{"type":"integer","default":100,"description":"Maximum images per query (locked in cursor)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/google-jobs/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Jobs","operationId":"get_google_jobs","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term. Required first call.","schema":{"type":"string","default":"software engineer"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Country name or 2-letter code. Locked in cursor.","schema":{"type":"string","default":"us"}},{"name":"language","in":"query","required":false,"description":"2-letter language code. Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"radius","in":"query","required":false,"description":"Search radius in miles. Locked in cursor.","schema":{"type":"integer","default":300}},{"name":"job_type","in":"query","required":false,"description":"fulltime | parttime | contractor | intern. Locked in cursor.","schema":{"type":"string"}},{"name":"date_posted","in":"query","required":false,"description":"all | today | 3days | week | month. Locked in cursor.","schema":{"type":"string","default":"all"}},{"name":"keyword_filter","in":"query","required":false,"description":"Optional comma-separated terms; a job is kept only if one appears in its title/description/company. Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Jobs","operationId":"post_google_jobs","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"software engineer","description":"Search term. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"us","description":"Country name or 2-letter code. Locked in cursor."},"language":{"type":"string","default":"en","description":"2-letter language code. Locked in cursor."},"radius":{"type":"integer","default":300,"description":"Search radius in miles. Locked in cursor."},"job_type":{"type":"string","description":"fulltime | parttime | contractor | intern. Locked in cursor."},"date_posted":{"type":"string","default":"all","description":"all | today | 3days | week | month. Locked in cursor."},"keyword_filter":{"type":"string","description":"Optional comma-separated terms; a job is kept only if one appears in its title/description/company. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/google-maps/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Maps Places","operationId":"get_google_maps","parameters":[{"name":"queries","in":"query","required":true,"description":"Place search keyword. Required first call. 20 places per page, no duplicate place_ids across pages.","schema":{"type":"string","default":"coffee shops"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"location","in":"query","required":false,"description":"Geocode anchor for the search (city or address). Locked in cursor.","schema":{"type":"string","default":"Houston,Texas"}},{"name":"language","in":"query","required":false,"description":"Result language (Google hl code). Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"country","in":"query","required":false,"description":"Ignored -- country bias is derived from the geocoded location.","schema":{"type":"string","default":"us"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Maps Places","operationId":"post_google_maps","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"coffee shops","description":"Place search keyword. Required first call. 20 places per page, no duplicate place_ids across pages."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"location":{"type":"string","default":"Houston,Texas","description":"Geocode anchor for the search (city or address). Locked in cursor."},"language":{"type":"string","default":"en","description":"Result language (Google hl code). Locked in cursor."},"country":{"type":"string","default":"us","description":"Ignored -- country bias is derived from the geocoded location."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/google-news-scraper/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google News Scraper","operationId":"get_google_news_scraper","parameters":[{"name":"queries","in":"query","required":true,"description":"One news query, required on the first call. Cursor alone continues the saved search.","schema":{"type":"string","default":"OpenAI"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"page_size","in":"query","required":false,"description":"Articles per page, 1-100. Locked in cursor. Shared Redis snapshots expire after two hours. Follow next_cursor on short discovery pages.","schema":{"type":"integer","default":10}},{"name":"hl","in":"query","required":false,"description":"News language, e.g. en or bn (lr=lang_bn also accepted). Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"gl","in":"query","required":false,"description":"Two-letter edition country. Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"time_period","in":"query","required":false,"description":"UTC date filter; custom range at most 366 days. Locked in cursor.","schema":{"type":"string","default":"last_week","enum":["last_hour","last_day","last_week","last_month","last_year","custom"]}},{"name":"time_period_min","in":"query","required":false,"description":"Inclusive custom start date: YYYY-MM-DD or MM/DD/YYYY.","schema":{"type":"string"}},{"name":"time_period_max","in":"query","required":false,"description":"Inclusive custom end date: YYYY-MM-DD or MM/DD/YYYY.","schema":{"type":"string"}},{"name":"include_thumbnails","in":"query","required":false,"description":"Best-effort base64 thumbnails, up to 10 per page within 5s from trusted Google hosts. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google News Scraper","operationId":"post_google_news_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"OpenAI","description":"One news query, required on the first call. Cursor alone continues the saved search."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"page_size":{"type":"integer","default":10,"description":"Articles per page, 1-100. Locked in cursor. Shared Redis snapshots expire after two hours. Follow next_cursor on short discovery pages."},"hl":{"type":"string","default":"en","description":"News language, e.g. en or bn (lr=lang_bn also accepted). Locked in cursor."},"gl":{"type":"string","default":"US","description":"Two-letter edition country. Locked in cursor."},"time_period":{"type":"string","default":"last_week","enum":["last_hour","last_day","last_week","last_month","last_year","custom"],"description":"UTC date filter; custom range at most 366 days. Locked in cursor."},"time_period_min":{"type":"string","description":"Inclusive custom start date: YYYY-MM-DD or MM/DD/YYYY."},"time_period_max":{"type":"string","description":"Inclusive custom end date: YYYY-MM-DD or MM/DD/YYYY."},"include_thumbnails":{"type":"boolean","default":false,"description":"Best-effort base64 thumbnails, up to 10 per page within 5s from trusted Google hosts. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/google-patent-scraper/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Patent Scraper","operationId":"get_google_patent_scraper","parameters":[{"name":"queries","in":"query","required":true,"description":"One patent search query. Alternatively supply patent_numbers. Cursor-only calls continue the saved query and filters.","schema":{"type":"string","default":"machine learning"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"page_size","in":"query","required":false,"description":"Patents per page, 1-100; fixed by the cursor. Native Google pages, exact deduplication and replay in the shared cache. Cursors expire after two hours.","schema":{"type":"integer","default":10}},{"name":"patent_numbers","in":"query","required":false,"description":"Optional publication identifiers, string or JSON array up to 50. Adds an OR group to the search. Google may return related family publications.","schema":{"type":"string"}},{"name":"assignee","in":"query","required":false,"description":"Optional assignee name filter.","schema":{"type":"string"}},{"name":"inventor","in":"query","required":false,"description":"Optional inventor name filter.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Optional two-letter patent office, e.g. US, EP, or WO.","schema":{"type":"string"}},{"name":"date_from","in":"query","required":false,"description":"After this YYYY-MM-DD date, applied to date_type.","schema":{"type":"string"}},{"name":"date_to","in":"query","required":false,"description":"Before this YYYY-MM-DD date, applied to date_type.","schema":{"type":"string"}},{"name":"date_type","in":"query","required":false,"description":"Date field used by the after/before filters.","schema":{"type":"string","default":"priority","enum":["priority","filing","publication"]}},{"name":"patent_type","in":"query","required":false,"description":"PATENT: utility patents; APPLICATION: application status; DESIGN: design patents.","schema":{"type":"string","enum":["","PATENT","APPLICATION","DESIGN"]}},{"name":"include_full_text","in":"query","required":false,"description":"Fetch description text from each returned patent document. Opt-in extra request per patent.","schema":{"type":"boolean","default":false}},{"name":"include_claims","in":"query","required":false,"description":"Fetch patent claims. Shares one detail request with other enrichment options.","schema":{"type":"boolean","default":false}},{"name":"include_citations","in":"query","required":false,"description":"Fetch backward references and cited-by publication numbers.","schema":{"type":"boolean","default":false}},{"name":"include_patent_family","in":"query","required":false,"description":"Fetch related application/family publication numbers.","schema":{"type":"boolean","default":false}},{"name":"include_classifications","in":"query","required":false,"description":"Fetch actual leaf CPC/IPC codes. CPC is never relabeled as IPC.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use the platform-injected proxy (default true).","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Patent Scraper","operationId":"post_google_patent_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"machine learning","description":"One patent search query. Alternatively supply patent_numbers. Cursor-only calls continue the saved query and filters."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"page_size":{"type":"integer","default":10,"description":"Patents per page, 1-100; fixed by the cursor. Native Google pages, exact deduplication and replay in the shared cache. Cursors expire after two hours."},"patent_numbers":{"type":"string","description":"Optional publication identifiers, string or JSON array up to 50. Adds an OR group to the search. Google may return related family publications."},"assignee":{"type":"string","description":"Optional assignee name filter."},"inventor":{"type":"string","description":"Optional inventor name filter."},"country":{"type":"string","description":"Optional two-letter patent office, e.g. US, EP, or WO."},"date_from":{"type":"string","description":"After this YYYY-MM-DD date, applied to date_type."},"date_to":{"type":"string","description":"Before this YYYY-MM-DD date, applied to date_type."},"date_type":{"type":"string","default":"priority","enum":["priority","filing","publication"],"description":"Date field used by the after/before filters."},"patent_type":{"type":"string","enum":["","PATENT","APPLICATION","DESIGN"],"description":"PATENT: utility patents; APPLICATION: application status; DESIGN: design patents."},"include_full_text":{"type":"boolean","default":false,"description":"Fetch description text from each returned patent document. Opt-in extra request per patent."},"include_claims":{"type":"boolean","default":false,"description":"Fetch patent claims. Shares one detail request with other enrichment options."},"include_citations":{"type":"boolean","default":false,"description":"Fetch backward references and cited-by publication numbers."},"include_patent_family":{"type":"boolean","default":false,"description":"Fetch related application/family publication numbers."},"include_classifications":{"type":"boolean","default":false,"description":"Fetch actual leaf CPC/IPC codes. CPC is never relabeled as IPC."},"use_proxy":{"type":"boolean","default":true,"description":"Use the platform-injected proxy (default true)."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/google-play-reviews/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Play Reviews","operationId":"get_google_play_reviews","parameters":[{"name":"urls","in":"query","required":true,"description":"App package ID or Play Store URL. Required first call.","schema":{"type":"string","default":"com.supercell.brawlstars"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"most_relevant | newest (alias most_recent) | rating. Sent to Google Play (server-side sort). Locked in cursor.","schema":{"type":"string","default":"most_relevant"}},{"name":"rating","in":"query","required":false,"description":"Only reviews with this star rating (1-5), filtered server-side. Locked in cursor.","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Store/review language (hl), e.g. en, fr, pt-BR. Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"country","in":"query","required":false,"description":"Store country (gl), 2-letter code. Apps unavailable in that country return 400 not-found. Locked in cursor.","schema":{"type":"string","default":"us"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Play Reviews","operationId":"post_google_play_reviews","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"com.supercell.brawlstars","description":"App package ID or Play Store URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","default":"most_relevant","description":"most_relevant | newest (alias most_recent) | rating. Sent to Google Play (server-side sort). Locked in cursor."},"rating":{"type":"string","description":"Only reviews with this star rating (1-5), filtered server-side. Locked in cursor."},"lang":{"type":"string","default":"en","description":"Store/review language (hl), e.g. en, fr, pt-BR. Locked in cursor."},"country":{"type":"string","default":"us","description":"Store country (gl), 2-letter code. Apps unavailable in that country return 400 not-found. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/google-play-scraper/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Play Scraper","operationId":"get_google_play_scraper","parameters":[{"name":"action","in":"query","required":false,"description":"scrapeAppSearch | scrapeAppUrls | scrapeSimilarApps. Locked in cursor.","schema":{"type":"string","default":"scrapeAppSearch","enum":["scrapeAppSearch","scrapeAppUrls","scrapeSimilarApps"]}},{"name":"queries","in":"query","required":false,"description":"Search keyword (action=scrapeAppSearch). Required first call for that mode.","schema":{"type":"string","default":"chatgpt"}},{"name":"urls","in":"query","required":false,"description":"App URL / package id (action=scrapeAppUrls/scrapeSimilarApps). Required first call for those modes.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Storefront country. Locked in cursor.","schema":{"type":"string","default":"us"}},{"name":"language","in":"query","required":false,"description":"Language. Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Play Scraper","operationId":"post_google_play_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","default":"scrapeAppSearch","enum":["scrapeAppSearch","scrapeAppUrls","scrapeSimilarApps"],"description":"scrapeAppSearch | scrapeAppUrls | scrapeSimilarApps. Locked in cursor."},"queries":{"type":"string","default":"chatgpt","description":"Search keyword (action=scrapeAppSearch). Required first call for that mode."},"urls":{"type":"string","description":"App URL / package id (action=scrapeAppUrls/scrapeSimilarApps). Required first call for those modes."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"us","description":"Storefront country. Locked in cursor."},"language":{"type":"string","default":"en","description":"Language. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/google-play-search/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Play App Search","operationId":"get_google_play_search","parameters":[{"name":"queries","in":"query","required":true,"description":"App search keyword, package ID, or Play Store URL. Required first call.","schema":{"type":"string","default":"games"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Store country. Locked in cursor.","schema":{"type":"string","default":"us"}},{"name":"lang","in":"query","required":false,"description":"Language. Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Play App Search","operationId":"post_google_play_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"games","description":"App search keyword, package ID, or Play Store URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"us","description":"Store country. Locked in cursor."},"lang":{"type":"string","default":"en","description":"Language. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/google-scholar-scraper/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Scholar Scraper","operationId":"get_google_scholar_scraper","parameters":[{"name":"queries","in":"query","required":true,"description":"One scholarly query via OpenAlex, not Google Scholar rankings. Cursor-only calls retain query and filters.","schema":{"type":"string","default":"machine learning"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"page_size","in":"query","required":false,"description":"Papers per page, 1-100, fixed in cursor. Native source pagination with exact cached replay; two-hour cursor lifetime.","schema":{"type":"integer","default":10}},{"name":"sort_by","in":"query","required":false,"description":"OpenAlex search relevance or global citation-count descending order. Locked in cursor.","schema":{"type":"string","default":"relevance","enum":["relevance","cited_by_count"]}},{"name":"filter","in":"query","required":false,"description":"PDF requires an actual source PDF URL; open access uses the source OA flag. Recent years are current UTC year minus four through current year. Locked in cursor.","schema":{"type":"string","default":"all","enum":["all","has_pdf","open_access","recent_5_years"]}},{"name":"article_type","in":"query","required":false,"description":"Source-backed publication classification. Conference uses raw proceedings metadata and can produce short pages. Locked in cursor.","schema":{"type":"string","default":"any","enum":["any","journal","conference","book","preprint"]}},{"name":"include_abstract","in":"query","required":false,"description":"Include a reconstructed abstract when supplied by the source. No publisher fetch. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"fallback_to_semantic","in":"query","required":false,"description":"Use Semantic Scholar only if initial OpenAlex retrieval fails. Supports relevance and article_type=any; ranking/coverage differ and continuation stays on that provider. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use the platform-injected proxy, default true. Anonymous source API budgets are limited; server-side OPENALEX_API_KEY is recommended.","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Scholar Scraper","operationId":"post_google_scholar_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"machine learning","description":"One scholarly query via OpenAlex, not Google Scholar rankings. Cursor-only calls retain query and filters."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"page_size":{"type":"integer","default":10,"description":"Papers per page, 1-100, fixed in cursor. Native source pagination with exact cached replay; two-hour cursor lifetime."},"sort_by":{"type":"string","default":"relevance","enum":["relevance","cited_by_count"],"description":"OpenAlex search relevance or global citation-count descending order. Locked in cursor."},"filter":{"type":"string","default":"all","enum":["all","has_pdf","open_access","recent_5_years"],"description":"PDF requires an actual source PDF URL; open access uses the source OA flag. Recent years are current UTC year minus four through current year. Locked in cursor."},"article_type":{"type":"string","default":"any","enum":["any","journal","conference","book","preprint"],"description":"Source-backed publication classification. Conference uses raw proceedings metadata and can produce short pages. Locked in cursor."},"include_abstract":{"type":"boolean","default":false,"description":"Include a reconstructed abstract when supplied by the source. No publisher fetch. Locked in cursor."},"fallback_to_semantic":{"type":"boolean","default":false,"description":"Use Semantic Scholar only if initial OpenAlex retrieval fails. Supports relevance and article_type=any; ranking/coverage differ and continuation stays on that provider. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use the platform-injected proxy, default true. Anonymous source API budgets are limited; server-side OPENALEX_API_KEY is recommended."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/google-search/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Search","operationId":"get_google_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword (max 2048 characters). Required on every call.","schema":{"type":"string","default":"latest technology news"}},{"name":"page","in":"query","required":false,"description":"Google result page to fetch (1-50, 10 results per page). Request any page directly (1, 2, 3 ...) with the same query and filters; the response's `next_page` is null when there are no more results.","schema":{"type":"integer","default":1,"minimum":1,"maximum":50}},{"name":"countryCode","in":"query","required":false,"description":"Country code (e.g. us, gb, de).","schema":{"type":"string","default":"us"}},{"name":"languageCode","in":"query","required":false,"description":"UI language code (e.g. en, fr, de).","schema":{"type":"string","default":"en"}},{"name":"dateRange","in":"query","required":false,"description":"Only results from the last hour/day/week/month/year (empty = any time)","schema":{"type":"string","enum":["hour","day","week","month","year"]}},{"name":"site","in":"query","required":false,"description":"Restrict results to one site (adds `site:<domain>`), e.g. `github.com`","schema":{"type":"string"}},{"name":"includeUnfilteredResults","in":"query","required":false,"description":"Include omitted near-duplicate results (`filter=0`)","schema":{"type":"boolean","default":false}},{"name":"use_fallback","in":"query","required":false,"description":"When Google blocks a page, fall back to a real-browser rendered Google SERP","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Search","operationId":"post_google_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"latest technology news","description":"Search keyword (max 2048 characters). Required on every call."},"page":{"type":"integer","default":1,"minimum":1,"maximum":50,"description":"Google result page to fetch (1-50, 10 results per page). Request any page directly (1, 2, 3 ...) with the same query and filters; the response's `next_page` is null when there are no more results."},"countryCode":{"type":"string","default":"us","description":"Country code (e.g. us, gb, de)."},"languageCode":{"type":"string","default":"en","description":"UI language code (e.g. en, fr, de)."},"dateRange":{"type":"string","enum":["hour","day","week","month","year"],"description":"Only results from the last hour/day/week/month/year (empty = any time)"},"site":{"type":"string","description":"Restrict results to one site (adds `site:<domain>`), e.g. `github.com`"},"includeUnfilteredResults":{"type":"boolean","default":false,"description":"Include omitted near-duplicate results (`filter=0`)"},"use_fallback":{"type":"boolean","default":true,"description":"When Google blocks a page, fall back to a real-browser rendered Google SERP"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/google-shopping/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Shopping","operationId":"get_google_shopping","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term. Required first call.","schema":{"type":"string","default":"iPhone"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country_code","in":"query","required":false,"description":"2-letter country code. Locked in cursor.","schema":{"type":"string","default":"us"}},{"name":"include_comparison_prices","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"include_extra_product_details","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"include_sponsored_results","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Shopping","operationId":"post_google_shopping","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"iPhone","description":"Search term. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country_code":{"type":"string","default":"us","description":"2-letter country code. Locked in cursor."},"include_comparison_prices":{"type":"boolean","default":true,"description":"Locked in cursor."},"include_extra_product_details":{"type":"boolean","default":true,"description":"Locked in cursor."},"include_sponsored_results":{"type":"boolean","default":true,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/google-shopping-price-history/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Shopping Price History","operationId":"get_google_shopping_price_history","parameters":[{"name":"product_ids","in":"query","required":true,"description":"Google Shopping product id (catalogid:<id>, prds string, bare id, or URL). One record per call.","schema":{"type":"string","default":"catalogid:9402654696244930073"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO-2 market (gl=). Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"language","in":"query","required":false,"description":"Google hl=. Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"max_stores","in":"query","required":false,"description":"Extra stores to chart beyond the default chart. Locked in cursor.","schema":{"type":"integer","default":10,"minimum":0,"maximum":100}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Shopping Price History","operationId":"post_google_shopping_price_history","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"product_ids":{"type":"string","default":"catalogid:9402654696244930073","description":"Google Shopping product id (catalogid:<id>, prds string, bare id, or URL). One record per call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"US","description":"ISO-2 market (gl=). Locked in cursor."},"language":{"type":"string","default":"en","description":"Google hl=. Locked in cursor."},"max_stores":{"type":"integer","default":10,"minimum":0,"maximum":100,"description":"Extra stores to chart beyond the default chart. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["product_ids"]}}}}}},"/google-shopping-product-reviews/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Shopping Product Reviews","operationId":"get_google_shopping_product_reviews","parameters":[{"name":"products","in":"query","required":true,"description":"Google Shopping gid or product URL. Required on the first call.","schema":{"type":"string","default":"3591805395819257241"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"relevance","enum":["relevance","recency"]}},{"name":"star_rating","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"all","enum":["all","1","2","3","4","5"]}},{"name":"exclude_incentivized","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"country","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"language","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"judgments","in":"query","required":false,"description":"Sentiment + issue labels. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"labels","in":"query","required":false,"description":"reports,incentivized,injection | all | none. Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Shopping Product Reviews","operationId":"post_google_shopping_product_reviews","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"string","default":"3591805395819257241","description":"Google Shopping gid or product URL. Required on the first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","default":"relevance","enum":["relevance","recency"],"description":"Locked in cursor."},"star_rating":{"type":"string","default":"all","enum":["all","1","2","3","4","5"],"description":"Locked in cursor."},"exclude_incentivized":{"type":"boolean","default":false,"description":"Locked in cursor."},"country":{"type":"string","default":"US","description":"Locked in cursor."},"language":{"type":"string","default":"en","description":"Locked in cursor."},"judgments":{"type":"boolean","default":true,"description":"Sentiment + issue labels. Locked in cursor."},"labels":{"type":"string","description":"reports,incentivized,injection | all | none. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["products"]}}}}}},"/google-trend-scraper/":{"get":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Trend Scraper","operationId":"get_google_trend_scraper","parameters":[{"name":"search_terms","in":"query","required":true,"description":"One to five comparison terms, string or JSON array. All terms share one normalized Google Trends timeline. GET arrays must be one JSON-encoded query value; POST accepts native arrays.","schema":{"type":"string","default":"chatgpt"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"page_size","in":"query","required":false,"description":"Timeline points per page, 1-100, fixed by the cursor. One frozen source timeline; cursors expire after two hours.","schema":{"type":"integer","default":10}},{"name":"time_range","in":"query","required":false,"description":"now 1-H/4-H/1-d/7-d, today 1-m/3-m/12-m/5-y, all, or YYYY-MM-DD YYYY-MM-DD (2004 onward). Source chooses time resolution; fixed for cursor pages.","schema":{"type":"string","default":"today 3-m"}},{"name":"geo","in":"query","required":false,"description":"Empty for worldwide, two-letter country such as BD/US, or subdivision such as US-CA. Fixed in snapshot.","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Google Trends category ID; 0 means all categories.","schema":{"type":"integer","default":0}},{"name":"property","in":"query","required":false,"description":"Empty for web search; froogle means Shopping search.","schema":{"type":"string","enum":["","images","news","youtube","froogle"]}},{"name":"hl","in":"query","required":false,"description":"Source display language, e.g. en-US. Fixed in snapshot.","schema":{"type":"string","default":"en-US"}},{"name":"tz","in":"query","required":false,"description":"Google Trends timezone parameter in minutes, -840 to 840. Raw source convention, default 360; timestamps remain UTC.","schema":{"type":"integer","default":360}},{"name":"use_proxy","in":"query","required":false,"description":"Use the platform-injected proxy, default true. Cached pages make no outbound requests.","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["google"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Google Trend Scraper","operationId":"post_google_trend_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"search_terms":{"type":"string","default":"chatgpt","description":"One to five comparison terms, string or JSON array. All terms share one normalized Google Trends timeline. GET arrays must be one JSON-encoded query value; POST accepts native arrays."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"page_size":{"type":"integer","default":10,"description":"Timeline points per page, 1-100, fixed by the cursor. One frozen source timeline; cursors expire after two hours."},"time_range":{"type":"string","default":"today 3-m","description":"now 1-H/4-H/1-d/7-d, today 1-m/3-m/12-m/5-y, all, or YYYY-MM-DD YYYY-MM-DD (2004 onward). Source chooses time resolution; fixed for cursor pages."},"geo":{"type":"string","description":"Empty for worldwide, two-letter country such as BD/US, or subdivision such as US-CA. Fixed in snapshot."},"category":{"type":"integer","default":0,"description":"Google Trends category ID; 0 means all categories."},"property":{"type":"string","enum":["","images","news","youtube","froogle"],"description":"Empty for web search; froogle means Shopping search."},"hl":{"type":"string","default":"en-US","description":"Source display language, e.g. en-US. Fixed in snapshot."},"tz":{"type":"integer","default":360,"description":"Google Trends timezone parameter in minutes, -840 to 840. Raw source convention, default 360; timestamps remain UTC."},"use_proxy":{"type":"boolean","default":true,"description":"Use the platform-injected proxy, default true. Cached pages make no outbound requests."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["search_terms"]}}}}}},"/idealista/":{"get":{"tags":["idealista"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Idealista Property","operationId":"get_idealista","parameters":[{"name":"location","in":"query","required":true,"description":"Idealista location ID or place name. Required first call (or property_codes); locked in cursor.","schema":{"type":"string","default":"Madrid"}},{"name":"property_codes","in":"query","required":false,"description":"Comma-separated codes for direct-lookup mode.","schema":{"type":"string"}},{"name":"operation","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"sale","enum":["sale","rent"]}},{"name":"property_type","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"homes"}},{"name":"country","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"es","enum":["es","pt","it"]}},{"name":"sort_by","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"mostRecent"}},{"name":"fetch_details","in":"query","required":false,"description":"Per-listing _details. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"fetch_stats","in":"query","required":false,"description":"Per-listing _stats. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["idealista"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Idealista Property","operationId":"post_idealista","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string","default":"Madrid","description":"Idealista location ID or place name. Required first call (or property_codes); locked in cursor."},"property_codes":{"type":"string","description":"Comma-separated codes for direct-lookup mode."},"operation":{"type":"string","default":"sale","enum":["sale","rent"],"description":"Locked in cursor."},"property_type":{"type":"string","default":"homes","description":"Locked in cursor."},"country":{"type":"string","default":"es","enum":["es","pt","it"],"description":"Locked in cursor."},"sort_by":{"type":"string","default":"mostRecent","description":"Locked in cursor."},"fetch_details":{"type":"boolean","default":true,"description":"Per-listing _details. Locked in cursor."},"fetch_stats":{"type":"boolean","default":true,"description":"Per-listing _stats. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["location"]}}}}}},"/instagram-audio-reels/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Audio Reels","operationId":"get_instagram_audio_reels","parameters":[{"name":"audio_ids","in":"query","required":true,"description":"Numeric IG audio id. Required first call.","schema":{"type":"string","default":"1049332199830474"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Audio Reels","operationId":"post_instagram_audio_reels","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"audio_ids":{"type":"string","default":"1049332199830474","description":"Numeric IG audio id. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["audio_ids"]}}}}}},"/instagram-comment-replies/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Comment Replies","operationId":"get_instagram_comment_replies","parameters":[{"name":"url","in":"query","required":true,"description":"The Instagram post/reel URL the comment lives under. Required first call. Locked in cursor.","schema":{"type":"string","default":"https://www.instagram.com/reels/DZu3iOMNqv_/","format":"uri"}},{"name":"comment_id","in":"query","required":true,"description":"The top-level comment whose replies to fetch. Required first call. Locked in cursor.","schema":{"type":"string","default":"17968358201921469"}},{"name":"session_id","in":"query","required":true,"description":"A logged-in Instagram web sessionid cookie value. Required first call -- bring your own (throwaway account recommended). Locked in cursor.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_order","in":"query","required":false,"description":"The only ranking Instagram exposes for child comments today. Locked in cursor.","schema":{"type":"string","default":"popular","enum":["popular"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Comment Replies","operationId":"post_instagram_comment_replies","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","default":"https://www.instagram.com/reels/DZu3iOMNqv_/","format":"uri","description":"The Instagram post/reel URL the comment lives under. Required first call. Locked in cursor."},"comment_id":{"type":"string","default":"17968358201921469","description":"The top-level comment whose replies to fetch. Required first call. Locked in cursor."},"session_id":{"type":"string","description":"A logged-in Instagram web sessionid cookie value. Required first call -- bring your own (throwaway account recommended). Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_order":{"type":"string","default":"popular","enum":["popular"],"description":"The only ranking Instagram exposes for child comments today. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["url","comment_id","session_id"]}}}}}},"/instagram-comments/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Comments","operationId":"get_instagram_comments","parameters":[{"name":"urls","in":"query","required":true,"description":"Instagram post or reel URL (/p/, /reel/, /tv/).","schema":{"type":"string","default":"https://www.instagram.com/p/DTlCigBADky/","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_replies","in":"query","required":false,"description":"Include nested replies. Locked in cursor. Instagram serves reply threads only to logged-in sessions, so `replies` stays empty and a `warning` explains it (use instagram-comment-replies).","schema":{"type":"boolean","default":true}},{"name":"max_replies_per_comment","in":"query","required":false,"description":"Maximum replies per parent comment (no effect logged-out; see include_replies).","schema":{"type":"integer","default":5}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Comments","operationId":"post_instagram_comments","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.instagram.com/p/DTlCigBADky/","format":"uri","description":"Instagram post or reel URL (/p/, /reel/, /tv/)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_replies":{"type":"boolean","default":true,"description":"Include nested replies. Locked in cursor. Instagram serves reply threads only to logged-in sessions, so `replies` stays empty and a `warning` explains it (use instagram-comment-replies)."},"max_replies_per_comment":{"type":"integer","default":5,"description":"Maximum replies per parent comment (no effect logged-out; see include_replies)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/instagram-followers-count/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Followers Count","operationId":"get_instagram_followers_count","parameters":[{"name":"usernames","in":"query","required":true,"description":"Instagram username, @handle, or profile URL. Lookup endpoint.","schema":{"type":"string","default":"natgeo"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Followers Count","operationId":"post_instagram_followers_count","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"natgeo","description":"Instagram username, @handle, or profile URL. Lookup endpoint."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/instagram-hashtag-posts/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Hashtag Posts","operationId":"get_instagram_hashtag_posts","parameters":[{"name":"hashtag","in":"query","required":true,"description":"Hashtag, with or without #. Required first call. Aliases: hashtags, query.","schema":{"type":"string","default":"travel"}},{"name":"session_id","in":"query","required":true,"description":"Instagram web sessionid cookie — REQUIRED on every call (not stored in the cursor).","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"scrape_type","in":"query","required":false,"description":"recent | top | reels. Locked in cursor after call 1.","schema":{"type":"string","default":"recent","enum":["recent","top","reels"]}},{"name":"resolve_keyword","in":"query","required":false,"description":"Resolve a free-text keyword to the best-matching hashtag. First call only.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Hashtag Posts","operationId":"post_instagram_hashtag_posts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"hashtag":{"type":"string","default":"travel","description":"Hashtag, with or without #. Required first call. Aliases: hashtags, query."},"session_id":{"type":"string","description":"Instagram web sessionid cookie — REQUIRED on every call (not stored in the cursor)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"scrape_type":{"type":"string","default":"recent","enum":["recent","top","reels"],"description":"recent | top | reels. Locked in cursor after call 1."},"resolve_keyword":{"type":"boolean","default":false,"description":"Resolve a free-text keyword to the best-matching hashtag. First call only."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["hashtag","session_id"]}}}}}},"/instagram-highlight-details/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Highlight Details","operationId":"get_instagram_highlight_details","parameters":[{"name":"highlight_ids","in":"query","required":true,"description":"Bare numeric highlight id, \"highlight:ID\", or a stories/highlights URL. Lookup endpoint -- next_cursor null. Missing/deleted id -> 404, bad id -> 400, IG block -> 502.","schema":{"type":"string","default":"17975319242920589"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Highlight Details","operationId":"post_instagram_highlight_details","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"highlight_ids":{"type":"string","default":"17975319242920589","description":"Bare numeric highlight id, \"highlight:ID\", or a stories/highlights URL. Lookup endpoint -- next_cursor null. Missing/deleted id -> 404, bad id -> 400, IG block -> 502."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["highlight_ids"]}}}}}},"/instagram-highlights/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Highlights","operationId":"get_instagram_highlights","parameters":[{"name":"usernames","in":"query","required":true,"description":"Instagram username.","schema":{"type":"string","default":"mrbeast"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Highlights","operationId":"post_instagram_highlights","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"mrbeast","description":"Instagram username."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/instagram-influencer-engagement/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Influencer Engagement","operationId":"get_instagram_influencer_engagement","parameters":[{"name":"usernames","in":"query","required":true,"description":"Public Instagram username, no @. Lookup endpoint — next_cursor null. No login required.","schema":{"type":"string","default":"mrbeast"}},{"name":"posts_to_analyze","in":"query","required":false,"description":"Size of the recent-media window analyzed (max 500)","schema":{"type":"integer","default":20}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Influencer Engagement","operationId":"post_instagram_influencer_engagement","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"mrbeast","description":"Public Instagram username, no @. Lookup endpoint — next_cursor null. No login required."},"posts_to_analyze":{"type":"integer","default":20,"description":"Size of the recent-media window analyzed (max 500)"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/instagram-popular-search/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Popular Search","operationId":"get_instagram_popular_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword. Required first call. title/total_media_count/description are only populated on page 1 (SSR-only fields; null on later pages).","schema":{"type":"string","default":"ronaldo"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Popular Search","operationId":"post_instagram_popular_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"ronaldo","description":"Search keyword. Required first call. title/total_media_count/description are only populated on page 1 (SSR-only fields; null on later pages)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/instagram-post-scraper/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Single Post Scraper","operationId":"get_instagram_post_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"Instagram post/reel/tv URL or bare shortcode. One record, no pagination.","schema":{"type":"string","default":"https://www.instagram.com/p/DXHKcyvEWfr/"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"detail_level","in":"query","required":false,"description":"Full detail incl. comments. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"comments_per_post","in":"query","required":false,"description":"Latest comments kept. Locked in cursor.","schema":{"type":"integer","default":10}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Single Post Scraper","operationId":"post_instagram_post_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.instagram.com/p/DXHKcyvEWfr/","description":"Instagram post/reel/tv URL or bare shortcode. One record, no pagination."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"detail_level":{"type":"boolean","default":true,"description":"Full detail incl. comments. Locked in cursor."},"comments_per_post":{"type":"integer","default":10,"description":"Latest comments kept. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/instagram-profile/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Basic Profile Info","operationId":"get_instagram_profile","parameters":[{"name":"usernames","in":"query","required":true,"description":"Instagram username, @handle, or profile URL. Lookup endpoint.","schema":{"type":"string","default":"mrbeast"}},{"name":"include_about","in":"query","required":false,"description":"Include an about block (joinedDate/country) — usually null.","schema":{"type":"boolean","default":false}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Basic Profile Info","operationId":"post_instagram_profile","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"mrbeast","description":"Instagram username, @handle, or profile URL. Lookup endpoint."},"include_about":{"type":"boolean","default":false,"description":"Include an about block (joinedDate/country) — usually null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/instagram-profile-full/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Profile API","operationId":"get_instagram_profile_full","parameters":[{"name":"usernames","in":"query","required":true,"description":"Bare username, @handle, or profile URL. Lookup endpoint -- next_cursor null.","schema":{"type":"string","default":"mrbeast"}},{"name":"max_posts","in":"query","required":false,"description":"Recent posts embedded in the response.","schema":{"type":"integer","default":3}},{"name":"fetch_post_details","in":"query","required":false,"description":"Per-post like/comment counts.","schema":{"type":"boolean","default":true}},{"name":"include_related_profiles","in":"query","required":false,"description":"Include AYML related accounts.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Profile API","operationId":"post_instagram_profile_full","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"mrbeast","description":"Bare username, @handle, or profile URL. Lookup endpoint -- next_cursor null."},"max_posts":{"type":"integer","default":3,"description":"Recent posts embedded in the response."},"fetch_post_details":{"type":"boolean","default":true,"description":"Per-post like/comment counts."},"include_related_profiles":{"type":"boolean","default":true,"description":"Include AYML related accounts."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/instagram-profile-posts/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Profile Posts","operationId":"get_instagram_profile_posts","parameters":[{"name":"usernames","in":"query","required":true,"description":"Instagram username.","schema":{"type":"string","default":"mrbeast"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"pinned_mode","in":"query","required":false,"description":"include | skip | only — pinned-post filter. Locked in cursor.","schema":{"type":"string","default":"include","enum":["include","skip","only"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Profile Posts","operationId":"post_instagram_profile_posts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"mrbeast","description":"Instagram username."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"pinned_mode":{"type":"string","default":"include","enum":["include","skip","only"],"description":"include | skip | only — pinned-post filter. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/instagram-profile-reels/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Profile Reels","operationId":"get_instagram_profile_reels","parameters":[{"name":"usernames","in":"query","required":true,"description":"Instagram username.","schema":{"type":"string","default":"natgeo"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Profile Reels","operationId":"post_instagram_profile_reels","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"natgeo","description":"Instagram username."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/instagram-profile-search/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Search Profile","operationId":"get_instagram_profile_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword. Required first call.","schema":{"type":"string","default":"fitness coach"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_media_count","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Search Profile","operationId":"post_instagram_profile_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"fitness coach","description":"Search keyword. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_media_count":{"type":"boolean","default":true,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/instagram-reel-scraper/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Single Reel Scraper","operationId":"get_instagram_reel_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"Instagram reel/post/tv URL or bare shortcode. One record, no pagination.","schema":{"type":"string","default":"https://www.instagram.com/reel/DXHKcyvEWfr/"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_shares_count","in":"query","required":false,"description":"Attempt reshare_count. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"comments_per_post","in":"query","required":false,"description":"Latest comments kept. Locked in cursor.","schema":{"type":"integer","default":10}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Single Reel Scraper","operationId":"post_instagram_reel_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.instagram.com/reel/DXHKcyvEWfr/","description":"Instagram reel/post/tv URL or bare shortcode. One record, no pagination."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_shares_count":{"type":"boolean","default":false,"description":"Attempt reshare_count. Locked in cursor."},"comments_per_post":{"type":"integer","default":10,"description":"Latest comments kept. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/instagram-related-hashtag-stats/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Related Hashtag Stats","operationId":"get_instagram_related_hashtag_stats","parameters":[{"name":"hashtags","in":"query","required":true,"description":"Hashtag, #hashtag or HTTPS instagram.com/explore/tags/<tag>/ URL. Tag length 1-100. v1 POST accepts up to 100 inputs; v1 GET uses the first. v2 takes one hashtag per cursor walk.","schema":{"type":"string","default":"fitness"}},{"name":"include_estimates","in":"query","required":false,"description":"Include a clearly labelled total-posts / 3,650 daily-volume estimate. Actual posts_per_day remains null because Instagram search supplies no time series. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"max_retries","in":"query","required":false,"description":"Maximum attempts per upstream page, 1-3, within the call deadline.","schema":{"type":"integer","default":3,"minimum":1,"maximum":3}},{"name":"use_proxy","in":"query","required":false,"description":"Use the platform proxy, default true. Instagram may require login or throttle some exits. Cached cursor pages make no upstream requests.","schema":{"type":"boolean","default":true}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Related Hashtag Stats","operationId":"post_instagram_related_hashtag_stats","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"hashtags":{"type":"string","default":"fitness","description":"Hashtag, #hashtag or HTTPS instagram.com/explore/tags/<tag>/ URL. Tag length 1-100. v1 POST accepts up to 100 inputs; v1 GET uses the first. v2 takes one hashtag per cursor walk."},"include_estimates":{"type":"boolean","default":false,"description":"Include a clearly labelled total-posts / 3,650 daily-volume estimate. Actual posts_per_day remains null because Instagram search supplies no time series. Locked in cursor."},"max_retries":{"type":"integer","default":3,"minimum":1,"maximum":3,"description":"Maximum attempts per upstream page, 1-3, within the call deadline."},"use_proxy":{"type":"boolean","default":true,"description":"Use the platform proxy, default true. Instagram may require login or throttle some exits. Cached cursor pages make no upstream requests."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["hashtags"]}}}}}},"/instagram-search/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Search","operationId":"get_instagram_search","parameters":[{"name":"query","in":"query","required":true,"description":"Search term, hashtag, or location ID.","schema":{"type":"string","default":"travel"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"search_type","in":"query","required":false,"description":"hashtag | place | post. Locked in cursor.","schema":{"type":"string","default":"hashtag","enum":["hashtag","place","post"]}},{"name":"session_id","in":"query","required":true,"description":"Instagram web sessionid cookie (required)","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Search","operationId":"post_instagram_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"travel","description":"Search term, hashtag, or location ID."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"search_type":{"type":"string","default":"hashtag","enum":["hashtag","place","post"],"description":"hashtag | place | post. Locked in cursor."},"session_id":{"type":"string","description":"Instagram web sessionid cookie (required)"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["query","session_id"]}}}}}},"/instagram-suggested-users/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Related Person","operationId":"get_instagram_suggested_users","parameters":[{"name":"urls","in":"query","required":true,"description":"Instagram username or profile URL. Lookup endpoint.","schema":{"type":"string","default":"https://www.instagram.com/mrbeast/"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Related Person","operationId":"post_instagram_suggested_users","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.instagram.com/mrbeast/","description":"Instagram username or profile URL. Lookup endpoint."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/instagram-tagged-mentions/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Tagged & Mentions","operationId":"get_instagram_tagged_mentions","parameters":[{"name":"usernames","in":"query","required":true,"description":"Instagram username or profile URL. Required first call. Inbound mentions = posts by OTHER accounts that tag or @mention it.","schema":{"type":"string","default":"natgeo"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Tagged & Mentions","operationId":"post_instagram_tagged_mentions","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"natgeo","description":"Instagram username or profile URL. Required first call. Inbound mentions = posts by OTHER accounts that tag or @mention it."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/instagram-transcript/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Reel/Post Transcript","operationId":"get_instagram_transcript","parameters":[{"name":"urls","in":"query","required":true,"description":"Reel/post URL. Lookup endpoint — next_cursor null.","schema":{"type":"string","default":"https://www.instagram.com/reel/DXtvzz7B3dC/","format":"uri"}},{"name":"translate_to_english","in":"query","required":false,"description":"Translate transcript to English","schema":{"type":"boolean","default":false}},{"name":"model_size","in":"query","required":false,"description":"faster-whisper model size","schema":{"type":"string","default":"base","enum":["tiny","base","small","medium","large-v3"]}},{"name":"beam_size","in":"query","required":false,"description":"Beam search width (1-10)","schema":{"type":"integer","default":1}},{"name":"language","in":"query","required":false,"description":"ISO language code to force (default: auto-detect)","schema":{"type":"string"}},{"name":"max_duration_seconds","in":"query","required":false,"description":"Optional cap: videos longer than this many seconds are rejected up front (422). 0 = no cap (full transcript, or a typed 504 if it cannot finish in time)","schema":{"type":"integer","default":0}},{"name":"vad_filter","in":"query","required":false,"description":"Drop non-speech audio","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Reel/Post Transcript","operationId":"post_instagram_transcript","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.instagram.com/reel/DXtvzz7B3dC/","format":"uri","description":"Reel/post URL. Lookup endpoint — next_cursor null."},"translate_to_english":{"type":"boolean","default":false,"description":"Translate transcript to English"},"model_size":{"type":"string","default":"base","enum":["tiny","base","small","medium","large-v3"],"description":"faster-whisper model size"},"beam_size":{"type":"integer","default":1,"description":"Beam search width (1-10)"},"language":{"type":"string","description":"ISO language code to force (default: auto-detect)"},"max_duration_seconds":{"type":"integer","default":0,"description":"Optional cap: videos longer than this many seconds are rejected up front (422). 0 = no cap (full transcript, or a typed 504 if it cannot finish in time)"},"vad_filter":{"type":"boolean","default":true,"description":"Drop non-speech audio"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/instagram-trending-reels/":{"get":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Trending Reels","operationId":"get_instagram_trending_reels","parameters":[{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["instagram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Instagram Trending Reels","operationId":"post_instagram_trending_reels","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/linkedin-ad-library/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Ads","operationId":"get_linkedin_ad_library","parameters":[{"name":"urls","in":"query","required":true,"description":"Advertiser: company name (fuzzy match, as in the Ad Library UI), LinkedIn company URL or numeric company ID (exact match). One page of up to 24 ads per call; pass next_cursor for more.","schema":{"type":"string","default":"Google"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"countries","in":"query","required":false,"description":"Ad-library country filter: ISO 3166 alpha-2 code(s), comma-separated, or ALL (e.g. US, GB,DE)","schema":{"type":"string","default":"US"}},{"name":"dateOption","in":"query","required":false,"description":"Ad date range: last-30-days, current-month, current-year, last-year (aliases this-month, this-year)","schema":{"type":"string","default":"last-30-days"}},{"name":"maxThreads","in":"query","required":false,"description":"Parallel ad-detail fetches per page (1-32)","schema":{"type":"integer","default":5}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Ads","operationId":"post_linkedin_ad_library","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"Google","description":"Advertiser: company name (fuzzy match, as in the Ad Library UI), LinkedIn company URL or numeric company ID (exact match). One page of up to 24 ads per call; pass next_cursor for more."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"countries":{"type":"string","default":"US","description":"Ad-library country filter: ISO 3166 alpha-2 code(s), comma-separated, or ALL (e.g. US, GB,DE)"},"dateOption":{"type":"string","default":"last-30-days","description":"Ad date range: last-30-days, current-month, current-year, last-year (aliases this-month, this-year)"},"maxThreads":{"type":"integer","default":5,"description":"Parallel ad-detail fetches per page (1-32)"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/linkedin-company-about/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Company About","operationId":"get_linkedin_company_about","parameters":[{"name":"urls","in":"query","required":true,"description":"LinkedIn company URL or handle. Lookup endpoint.","schema":{"type":"string","default":"https://www.linkedin.com/company/google","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Company About","operationId":"post_linkedin_company_about","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.linkedin.com/company/google","format":"uri","description":"LinkedIn company URL or handle. Lookup endpoint."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/linkedin-company-detail/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Company Detail / No Cookies","operationId":"get_linkedin_company_detail","parameters":[{"name":"urls","in":"query","required":true,"description":"A single company slug / LinkedIn URL / numeric id → full company detail. Lookup endpoint — next_cursor null. Aliases: identifiers, url.","schema":{"type":"string","default":"google"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Company Detail / No Cookies","operationId":"post_linkedin_company_detail","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"google","description":"A single company slug / LinkedIn URL / numeric id → full company detail. Lookup endpoint — next_cursor null. Aliases: identifiers, url."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/linkedin-company-details-scraper/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Company Details Scraper","operationId":"get_linkedin_company_details_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"Public LinkedIn company / showcase / school URL(s) or slug(s). POST: JSON array. GET: first only.","schema":{"type":"string","default":"https://www.linkedin.com/company/netflix/","format":"uri"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Company Details Scraper","operationId":"post_linkedin_company_details_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.linkedin.com/company/netflix/","format":"uri","description":"Public LinkedIn company / showcase / school URL(s) or slug(s). POST: JSON array. GET: first only."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/linkedin-company-finder/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Company URL Finder","operationId":"get_linkedin_company_finder","parameters":[{"name":"queries","in":"query","required":true,"description":"A single company name to resolve to its LinkedIn page. Lookup endpoint — one record per call. Aliases: names, query, q.","schema":{"type":"string","default":"Tesla"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"DuckDuckGo region","schema":{"type":"string","default":"us-en"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Company URL Finder","operationId":"post_linkedin_company_finder","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"Tesla","description":"A single company name to resolve to its LinkedIn page. Lookup endpoint — one record per call. Aliases: names, query, q."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"region":{"type":"string","default":"us-en","description":"DuckDuckGo region"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/linkedin-company-jobs/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Company Jobs","operationId":"get_linkedin_company_jobs","parameters":[{"name":"company_input","in":"query","required":true,"description":"Company name, ID, or URL.","schema":{"type":"string","default":"Microsoft"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"location","in":"query","required":false,"description":"Location filter. Locked in cursor.","schema":{"type":"string","default":"United States"}},{"name":"title","in":"query","required":false,"description":"Job title filter. Locked in cursor.","schema":{"type":"string"}},{"name":"experience","in":"query","required":false,"description":"Experience level filter. Locked in cursor.","schema":{"type":"string"}},{"name":"contract_type","in":"query","required":false,"description":"Contract type filter. Locked in cursor.","schema":{"type":"string"}},{"name":"published_at","in":"query","required":false,"description":"Published date filter: r2592000 (30 days), r604800 (7 days), r86400 (24 hours)","schema":{"type":"string"}},{"name":"work_type","in":"query","required":false,"description":"Work type filter: 1 (On-site), 2 (Remote), 3 (Hybrid)","schema":{"type":"string"}},{"name":"experience_level","in":"query","required":false,"description":"Experience level filter: 1 (Internship), 2 (Entry level), 3 (Associate), 4 (Mid-Senior level), 5 (Director)","schema":{"type":"string"}},{"name":"geo_id","in":"query","required":false,"description":"Geographic ID filter","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Company Jobs","operationId":"post_linkedin_company_jobs","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"company_input":{"type":"string","default":"Microsoft","description":"Company name, ID, or URL."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"location":{"type":"string","default":"United States","description":"Location filter. Locked in cursor."},"title":{"type":"string","description":"Job title filter. Locked in cursor."},"experience":{"type":"string","description":"Experience level filter. Locked in cursor."},"contract_type":{"type":"string","description":"Contract type filter. Locked in cursor."},"published_at":{"type":"string","description":"Published date filter: r2592000 (30 days), r604800 (7 days), r86400 (24 hours)"},"work_type":{"type":"string","description":"Work type filter: 1 (On-site), 2 (Remote), 3 (Hybrid)"},"experience_level":{"type":"string","description":"Experience level filter: 1 (Internship), 2 (Entry level), 3 (Associate), 4 (Mid-Senior level), 5 (Director)"},"geo_id":{"type":"string","description":"Geographic ID filter"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["company_input"]}}}}}},"/linkedin-company-profile-finder/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Mass Company Profile Finder","operationId":"get_linkedin_company_profile_finder","parameters":[{"name":"query","in":"query","required":true,"description":"Search phrase to find company LinkedIn page(s) — a company name, domain, or free text. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"alma.fr"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Mass Company Profile Finder","operationId":"post_linkedin_company_profile_finder","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"alma.fr","description":"Search phrase to find company LinkedIn page(s) — a company name, domain, or free text. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["query"]}}}}}},"/linkedin-jobs/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Jobs Search","operationId":"get_linkedin_jobs","parameters":[{"name":"queries","in":"query","required":false,"description":"Job title / keywords. One page of jobs per call. Optional if a location is given.","schema":{"type":"string","default":"React Developer"}},{"name":"location","in":"query","required":false,"description":"Broad location / country. Locked in cursor.","schema":{"type":"string","default":"Canada"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"fetch_details","in":"query","required":false,"description":"Fetch each job detail page. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"experience","in":"query","required":false,"description":"Experience level filter. Locked in cursor.","schema":{"type":"string","enum":["Intern","Assistant","Junior","Mid-Senior","Director","Executive"]}},{"name":"employment_type","in":"query","required":false,"description":"Employment type filter. Locked in cursor.","schema":{"type":"string","enum":["Full-time","Part-time","Contract","Temporary","Volunteer","Internship","Other"]}},{"name":"work_arrangement","in":"query","required":false,"description":"On-site / Remote / Hybrid. Locked in cursor.","schema":{"type":"string","enum":["On-site","Remote","Hybrid"]}},{"name":"posted_within","in":"query","required":false,"description":"Date-posted filter. Locked in cursor.","schema":{"type":"string","default":"Any Time","enum":["Any Time","Past 24 hours","Past Week","Past Month"]}},{"name":"easy_apply","in":"query","required":false,"description":"Only Easy Apply jobs. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Jobs Search","operationId":"post_linkedin_jobs","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"React Developer","description":"Job title / keywords. One page of jobs per call. Optional if a location is given."},"location":{"type":"string","default":"Canada","description":"Broad location / country. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"fetch_details":{"type":"boolean","default":true,"description":"Fetch each job detail page. Locked in cursor."},"experience":{"type":"string","enum":["Intern","Assistant","Junior","Mid-Senior","Director","Executive"],"description":"Experience level filter. Locked in cursor."},"employment_type":{"type":"string","enum":["Full-time","Part-time","Contract","Temporary","Volunteer","Internship","Other"],"description":"Employment type filter. Locked in cursor."},"work_arrangement":{"type":"string","enum":["On-site","Remote","Hybrid"],"description":"On-site / Remote / Hybrid. Locked in cursor."},"posted_within":{"type":"string","default":"Any Time","enum":["Any Time","Past 24 hours","Past Week","Past Month"],"description":"Date-posted filter. Locked in cursor."},"easy_apply":{"type":"boolean","default":false,"description":"Only Easy Apply jobs. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/linkedin-lead-enrichment/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Lead Enrichment","operationId":"get_linkedin_lead_enrichment","parameters":[{"name":"urls","in":"query","required":true,"description":"A LinkedIn /in/ profile or /company/ URL. One record; next_cursor always null.","schema":{"type":"string","default":"https://www.linkedin.com/in/williamhgates","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"enrich_company","in":"query","required":false,"description":"Enrich profiles with their company page. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_wikidata","in":"query","required":false,"description":"Wikidata founded_year fallback. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Lead Enrichment","operationId":"post_linkedin_lead_enrichment","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.linkedin.com/in/williamhgates","format":"uri","description":"A LinkedIn /in/ profile or /company/ URL. One record; next_cursor always null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"enrich_company":{"type":"boolean","default":true,"description":"Enrich profiles with their company page. Locked in cursor."},"use_wikidata":{"type":"boolean","default":true,"description":"Wikidata founded_year fallback. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/linkedin-post-search/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Search Posts By Keyword","operationId":"get_linkedin_post_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword. Required first call.","schema":{"type":"string","default":"ai agents"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"date_posted","in":"query","required":false,"description":"Only posts within this window. Locked in cursor.","schema":{"type":"string","enum":["","last-hour","last-day","last-week","last-month","last-year"]}},{"name":"include_comments","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Search Posts By Keyword","operationId":"post_linkedin_post_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"ai agents","description":"Search keyword. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"date_posted":{"type":"string","enum":["","last-hour","last-day","last-week","last-month","last-year"],"description":"Only posts within this window. Locked in cursor."},"include_comments":{"type":"boolean","default":true,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/linkedin-post-transcript/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Post Transcript","operationId":"get_linkedin_post_transcript","parameters":[{"name":"urls","in":"query","required":true,"description":"Public LinkedIn post URL. Lookup endpoint -- next_cursor null.","schema":{"type":"string","default":"https://www.linkedin.com/posts/howtoliveonearth-ugcPost-7507342748765786112-liGI/","format":"uri"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Post Transcript","operationId":"post_linkedin_post_transcript","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.linkedin.com/posts/howtoliveonearth-ugcPost-7507342748765786112-liGI/","format":"uri","description":"Public LinkedIn post URL. Lookup endpoint -- next_cursor null."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/linkedin-posts/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Posts","operationId":"get_linkedin_posts","parameters":[{"name":"urls","in":"query","required":true,"description":"LinkedIn profile, company, or feed URL.","schema":{"type":"string","default":"https://www.linkedin.com/company/google/","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"scrape_until","in":"query","required":false,"description":"Optional ISO date — stop at older posts. Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Posts","operationId":"post_linkedin_posts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.linkedin.com/company/google/","format":"uri","description":"LinkedIn profile, company, or feed URL."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"scrape_until":{"type":"string","description":"Optional ISO date — stop at older posts. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/linkedin-profile/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Profile","operationId":"get_linkedin_profile","parameters":[{"name":"urls","in":"query","required":true,"description":"LinkedIn person profile URL. Lookup endpoint.","schema":{"type":"string","default":"https://www.linkedin.com/in/parrsam/","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Profile","operationId":"post_linkedin_profile","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.linkedin.com/in/parrsam/","format":"uri","description":"LinkedIn person profile URL. Lookup endpoint."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/linkedin-search-jobs/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Job Search","operationId":"get_linkedin_search_jobs","parameters":[{"name":"queries","in":"query","required":true,"description":"Job search keyword (optionally \"keyword, location\").","schema":{"type":"string","default":"Python Developer"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"location","in":"query","required":false,"description":"Location filter. Locked in cursor.","schema":{"type":"string","default":"United States"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Job Search","operationId":"post_linkedin_search_jobs","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"Python Developer","description":"Job search keyword (optionally \"keyword, location\")."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"location":{"type":"string","default":"United States","description":"Location filter. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/linkedin-single-post/":{"get":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Single Post","operationId":"get_linkedin_single_post","parameters":[{"name":"urls","in":"query","required":true,"description":"Public LinkedIn post URL. Lookup endpoint -- next_cursor null. Full post detail + transcript + top comments.","schema":{"type":"string","default":"https://www.linkedin.com/posts/williamhgates_we-have-an-opportunityand-an-obligationto-ugcPost-7508263354348793856-WvZC","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"includeComments","in":"query","required":false,"description":"Include the server-rendered top comments. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["linkedin"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"LinkedIn Single Post","operationId":"post_linkedin_single_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.linkedin.com/posts/williamhgates_we-have-an-opportunityand-an-obligationto-ugcPost-7508263354348793856-WvZC","format":"uri","description":"Public LinkedIn post URL. Lookup endpoint -- next_cursor null. Full post detail + transcript + top comments."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"includeComments":{"type":"boolean","default":true,"description":"Include the server-rendered top comments. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/n8n-template-search/":{"get":{"tags":["n8n"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"n8n Template Search API","operationId":"get_n8n_template_search","parameters":[{"name":"query","in":"query","required":false,"description":"Keywords (apps, roles, use cases). Empty = no keyword. Locked in cursor.","schema":{"type":"string","default":"Google"}},{"name":"category","in":"query","required":false,"description":"Template category (case-insensitive). Empty = all. Locked in cursor.","schema":{"type":"string","enum":["AI","SecOps","Sales","IT Ops","Marketing","Document Ops","Engineering","DevOps","HR","Other","Support"]}},{"name":"sort_by","in":"query","required":false,"description":"Sorted by the API over all matches. Locked in cursor.","schema":{"type":"string","default":"relevancy","enum":["relevancy","popularity","most_recent"]}},{"name":"sort_direction","in":"query","required":false,"description":"Ignored for relevancy. Locked in cursor.","schema":{"type":"string","default":"desc","enum":["asc","desc"]}},{"name":"include_workflow_json","in":"query","required":false,"description":"Add each template's import-ready workflow JSON as `workflow_json` (one extra request per template).","schema":{"type":"boolean","default":false}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["n8n"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"n8n Template Search API","operationId":"post_n8n_template_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"Google","description":"Keywords (apps, roles, use cases). Empty = no keyword. Locked in cursor."},"category":{"type":"string","enum":["AI","SecOps","Sales","IT Ops","Marketing","Document Ops","Engineering","DevOps","HR","Other","Support"],"description":"Template category (case-insensitive). Empty = all. Locked in cursor."},"sort_by":{"type":"string","default":"relevancy","enum":["relevancy","popularity","most_recent"],"description":"Sorted by the API over all matches. Locked in cursor."},"sort_direction":{"type":"string","default":"desc","enum":["asc","desc"],"description":"Ignored for relevancy. Locked in cursor."},"include_workflow_json":{"type":"boolean","default":false,"description":"Add each template's import-ready workflow JSON as `workflow_json` (one extra request per template)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/naver-search/":{"get":{"tags":["naver"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Naver Search","operationId":"get_naver_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term on search.naver.com. Required first call.","schema":{"type":"string","default":"서울 맛집"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"where","in":"query","required":false,"description":"Vertical to search. Locked in cursor.","schema":{"type":"string","default":"nexearch","enum":["nexearch","web","news","image","video"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["naver"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Naver Search","operationId":"post_naver_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"서울 맛집","description":"Search term on search.naver.com. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"where":{"type":"string","default":"nexearch","enum":["nexearch","web","news","image","video"],"description":"Vertical to search. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/pinterest-boards/":{"get":{"tags":["pinterest"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Pinterest Boards / Pins","operationId":"get_pinterest_boards","parameters":[{"name":"urls","in":"query","required":true,"description":"Pinterest pin or board URL.","schema":{"type":"string","default":"https://www.pinterest.com/officialflawliz/cherry-cola-lips/","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["pinterest"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Pinterest Boards / Pins","operationId":"post_pinterest_boards","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.pinterest.com/officialflawliz/cherry-cola-lips/","format":"uri","description":"Pinterest pin or board URL."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/pinterest-followers/":{"get":{"tags":["pinterest"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Pinterest Followers","operationId":"get_pinterest_followers","parameters":[{"name":"usernames","in":"query","required":true,"description":"Pinterest profile URL, @handle or username. Ignored when `cursor` is supplied (the cursor carries it).","schema":{"type":"string","default":"candyw8119"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["pinterest"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Pinterest Followers","operationId":"post_pinterest_followers","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"candyw8119","description":"Pinterest profile URL, @handle or username. Ignored when `cursor` is supplied (the cursor carries it)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/pinterest-keyword-discovery/":{"get":{"tags":["pinterest"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Pinterest Keyword Discovery","operationId":"get_pinterest_keyword_discovery","parameters":[{"name":"queries","in":"query","required":true,"description":"Seed keyword to expand into suggestions.","schema":{"type":"string","default":"home decor"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_prefixes","in":"query","required":false,"description":"Generate prefix fragments of each seed for autocomplete","schema":{"type":"boolean","default":false}},{"name":"use_spaced_variations","in":"query","required":false,"description":"Add a trailing-space variation per seed","schema":{"type":"boolean","default":false}},{"name":"use_suffix_variations","in":"query","required":false,"description":"Append custom_suffixes to each seed","schema":{"type":"boolean","default":false}},{"name":"custom_suffixes","in":"query","required":false,"description":"Comma-separated suffixes when use_suffix_variations is true","schema":{"type":"string","default":"s,es,ing"}},{"name":"max_prefix_length","in":"query","required":false,"description":"Max prefix length when use_prefixes is true","schema":{"type":"integer","default":6}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["pinterest"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Pinterest Keyword Discovery","operationId":"post_pinterest_keyword_discovery","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"home decor","description":"Seed keyword to expand into suggestions."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_prefixes":{"type":"boolean","default":false,"description":"Generate prefix fragments of each seed for autocomplete"},"use_spaced_variations":{"type":"boolean","default":false,"description":"Add a trailing-space variation per seed"},"use_suffix_variations":{"type":"boolean","default":false,"description":"Append custom_suffixes to each seed"},"custom_suffixes":{"type":"string","default":"s,es,ing","description":"Comma-separated suffixes when use_suffix_variations is true"},"max_prefix_length":{"type":"integer","default":6,"description":"Max prefix length when use_prefixes is true"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/pinterest-pins-videos/":{"get":{"tags":["pinterest"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Pinterest Pins & Videos Search","operationId":"get_pinterest_pins_videos","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword. Ignored when `cursor` is supplied (the cursor carries it).","schema":{"type":"string","default":"minimalist interior"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"filter_type","in":"query","required":false,"description":"All (pins) | Videos (Pinterest video search; only rows with a playable link_to_video). Locked in cursor.","schema":{"type":"string","default":"All","enum":["All","Videos"]}},{"name":"page_size","in":"query","required":false,"description":"Minimum NEW pins per page (1-100). Pinterest serves ~25 per request, so a page may return up to ~2x this. Locked in cursor.","schema":{"type":"integer","default":25}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["pinterest"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Pinterest Pins & Videos Search","operationId":"post_pinterest_pins_videos","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"minimalist interior","description":"Search keyword. Ignored when `cursor` is supplied (the cursor carries it)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"filter_type":{"type":"string","default":"All","enum":["All","Videos"],"description":"All (pins) | Videos (Pinterest video search; only rows with a playable link_to_video). Locked in cursor."},"page_size":{"type":"integer","default":25,"description":"Minimum NEW pins per page (1-100). Pinterest serves ~25 per request, so a page may return up to ~2x this. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/pinterest-search/":{"get":{"tags":["pinterest"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Pinterest Search","operationId":"get_pinterest_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword. Ignored when `cursor` is supplied (the cursor carries it).","schema":{"type":"string","default":"wallpaper"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"content_filter","in":"query","required":false,"description":"'all' (pins) or 'videos' (Pinterest's video search). Locked in cursor. Alias: filter.","schema":{"type":"string","default":"all","enum":["all","videos"]}},{"name":"page_size","in":"query","required":false,"description":"Minimum NEW pins per page (1-100). Pinterest serves ~25 per request, so a page may return up to ~2x this. Locked in cursor.","schema":{"type":"integer","default":25}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["pinterest"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Pinterest Search","operationId":"post_pinterest_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"wallpaper","description":"Search keyword. Ignored when `cursor` is supplied (the cursor carries it)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"content_filter":{"type":"string","default":"all","enum":["all","videos"],"description":"'all' (pins) or 'videos' (Pinterest's video search). Locked in cursor. Alias: filter."},"page_size":{"type":"integer","default":25,"description":"Minimum NEW pins per page (1-100). Pinterest serves ~25 per request, so a page may return up to ~2x this. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/realtor-agent-by-zipcode/":{"get":{"tags":["realtor"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Realtor.com Agents by ZIP","operationId":"get_realtor_agent_by_zipcode","parameters":[{"name":"zipcodes","in":"query","required":true,"description":"ZIP/postal code. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"90210"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"RELEVANT_AGENTS | RATINGS_REVIEWS | MOST_SALES | MOST_RECENT_ACTIVITY | TESTIMONIALS_RECOMMENDATIONS. Locked into the cursor on first call.","schema":{"type":"string","default":"RELEVANT_AGENTS","enum":["RELEVANT_AGENTS","RATINGS_REVIEWS","MOST_SALES","MOST_RECENT_ACTIVITY","TESTIMONIALS_RECOMMENDATIONS"]}},{"name":"max_retries","in":"query","required":false,"description":"HTTP retry attempts for GraphQL calls (1–10). Locked into the cursor.","schema":{"type":"integer","default":3,"minimum":1,"maximum":10}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["realtor"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Realtor.com Agents by ZIP","operationId":"post_realtor_agent_by_zipcode","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"zipcodes":{"type":"string","default":"90210","description":"ZIP/postal code. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","default":"RELEVANT_AGENTS","enum":["RELEVANT_AGENTS","RATINGS_REVIEWS","MOST_SALES","MOST_RECENT_ACTIVITY","TESTIMONIALS_RECOMMENDATIONS"],"description":"RELEVANT_AGENTS | RATINGS_REVIEWS | MOST_SALES | MOST_RECENT_ACTIVITY | TESTIMONIALS_RECOMMENDATIONS. Locked into the cursor on first call."},"max_retries":{"type":"integer","default":3,"minimum":1,"maximum":10,"description":"HTTP retry attempts for GraphQL calls (1–10). Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["zipcodes"]}}}}}},"/realtor-property/":{"get":{"tags":["realtor"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Realtor.com Property Detail Scraper","operationId":"get_realtor_property","parameters":[{"name":"urls","in":"query","required":true,"description":"Realtor.com search or detail URL. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"https://www.realtor.com/realestateandhomes-search/Las-Vegas_NV","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"mode","in":"query","required":false,"description":"Mode for search URLs: BUY | RENT | SELL (detail URLs unchanged). Locked into the cursor.","schema":{"type":"string","default":"BUY","enum":["BUY","RENT","SELL"]}},{"name":"include_floorplans","in":"query","required":false,"description":"Include floor plan images in photos. Locked into the cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["realtor"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Realtor.com Property Detail Scraper","operationId":"post_realtor_property","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.realtor.com/realestateandhomes-search/Las-Vegas_NV","format":"uri","description":"Realtor.com search or detail URL. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"mode":{"type":"string","default":"BUY","enum":["BUY","RENT","SELL"],"description":"Mode for search URLs: BUY | RENT | SELL (detail URLs unchanged). Locked into the cursor."},"include_floorplans":{"type":"boolean","default":true,"description":"Include floor plan images in photos. Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/realtor-search-listings/":{"get":{"tags":["realtor"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Realtor.com Search Listings","operationId":"get_realtor_search_listings","parameters":[{"name":"urls","in":"query","required":true,"description":"Realtor.com search URL. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"https://www.realtor.com/realestateandhomes-search/Austin_TX","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"deep_details","in":"query","required":false,"description":"Reserved for future expansion to fetch deep detail pages. Locked into the cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["realtor"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Realtor.com Search Listings","operationId":"post_realtor_search_listings","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.realtor.com/realestateandhomes-search/Austin_TX","format":"uri","description":"Realtor.com search URL. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"deep_details":{"type":"boolean","default":false,"description":"Reserved for future expansion to fetch deep detail pages. Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/reddit-comment-replies/":{"get":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Comment Replies","operationId":"get_reddit_comment_replies","parameters":[{"name":"urls","in":"query","required":true,"description":"Reddit post URL, share link, or bare post id. Required on first call; ignored when `cursor` is supplied. Only the first url is honored (cursor pagination walks one post's thread at a time). One record per call: a page of top-level comment threads (with reply expansion + author avatars), nested under data.items.","schema":{"type":"string","default":"https://www.reddit.com/r/Whatcouldgowrong/comments/1wr71bt/ripping_through_an_intersection/","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Top-level comment threads per page (max 300). A page can come back shorter when the per-call time budget is reached -- the cursor then resumes exactly after the last returned thread. Locked into the cursor.","schema":{"type":"integer","default":30,"minimum":1,"maximum":300}},{"name":"sort","in":"query","required":false,"description":"Comment sort ('best' = confidence). Locked into the cursor after the first call.","schema":{"type":"string","default":"confidence","enum":["confidence","top","new","controversial","old","random","qa","live"]}},{"name":"max_depth","in":"query","required":false,"description":"Reply nesting depth requested from Reddit. Locked into the cursor.","schema":{"type":"integer","default":10,"minimum":1,"maximum":20}},{"name":"expand_more_comments","in":"query","required":false,"description":"Expand the \"N more replies\" stubs under each returned thread. Locked into the cursor.","schema":{"type":"boolean","default":true}},{"name":"max_more_requests","in":"query","required":false,"description":"\"More replies\" request budget per page (max 100); each request returns a whole level. Locked into the cursor.","schema":{"type":"integer","default":40,"maximum":100}},{"name":"fetch_avatars","in":"query","required":false,"description":"Resolve authors' avatar_url + display_name (profile title). Locked into the cursor.","schema":{"type":"boolean","default":true}},{"name":"max_avatar_lookups","in":"query","required":false,"description":"Unique-author profile lookups per page (max 100; first authors in reading order). Locked into the cursor.","schema":{"type":"integer","default":30,"maximum":100}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Comment Replies","operationId":"post_reddit_comment_replies","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.reddit.com/r/Whatcouldgowrong/comments/1wr71bt/ripping_through_an_intersection/","format":"uri","description":"Reddit post URL, share link, or bare post id. Required on first call; ignored when `cursor` is supplied. Only the first url is honored (cursor pagination walks one post's thread at a time). One record per call: a page of top-level comment threads (with reply expansion + author avatars), nested under data.items."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_items":{"type":"integer","default":30,"minimum":1,"maximum":300,"description":"Top-level comment threads per page (max 300). A page can come back shorter when the per-call time budget is reached -- the cursor then resumes exactly after the last returned thread. Locked into the cursor."},"sort":{"type":"string","default":"confidence","enum":["confidence","top","new","controversial","old","random","qa","live"],"description":"Comment sort ('best' = confidence). Locked into the cursor after the first call."},"max_depth":{"type":"integer","default":10,"minimum":1,"maximum":20,"description":"Reply nesting depth requested from Reddit. Locked into the cursor."},"expand_more_comments":{"type":"boolean","default":true,"description":"Expand the \"N more replies\" stubs under each returned thread. Locked into the cursor."},"max_more_requests":{"type":"integer","default":40,"maximum":100,"description":"\"More replies\" request budget per page (max 100); each request returns a whole level. Locked into the cursor."},"fetch_avatars":{"type":"boolean","default":true,"description":"Resolve authors' avatar_url + display_name (profile title). Locked into the cursor."},"max_avatar_lookups":{"type":"integer","default":30,"maximum":100,"description":"Unique-author profile lookups per page (max 100; first authors in reading order). Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/reddit-comment-search-scraper/":{"get":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Comment Search Scraper","operationId":"get_reddit_comment_search_scraper","parameters":[{"name":"query","in":"query","required":true,"description":"Text matched against comment bodies. Locked in cursor.","schema":{"type":"string","default":"transformer"}},{"name":"subreddit","in":"query","required":false,"description":"Subreddit name, r/name or URL. One of subreddit / author / post_url is required. Locked in cursor.","schema":{"type":"string","default":"MachineLearning"}},{"name":"author","in":"query","required":false,"description":"Reddit username (archive-backed; rarer query words work best). Locked in cursor.","schema":{"type":"string"}},{"name":"post_url","in":"query","required":false,"description":"Parent post URL or t3_ id to search inside. Locked in cursor.","schema":{"type":"string","format":"uri"}},{"name":"source","in":"query","required":false,"description":"auto = live Reddit feed first, then older archive matches. Locked in cursor.","schema":{"type":"string","default":"auto","enum":["auto","oauth","arctic"]}},{"name":"after","in":"query","required":false,"description":"Only comments after this UTC epoch seconds / ISO date. Locked in cursor.","schema":{"type":"string"}},{"name":"before","in":"query","required":false,"description":"Only comments before this UTC epoch seconds / ISO date. Locked in cursor.","schema":{"type":"string"}},{"name":"safe_search","in":"query","required":false,"description":"1 excludes NSFW / unknown parent posts. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"include_deleted","in":"query","required":false,"description":"Keep [deleted]/[removed] comments. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Comment Search Scraper","operationId":"post_reddit_comment_search_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"transformer","description":"Text matched against comment bodies. Locked in cursor."},"subreddit":{"type":"string","default":"MachineLearning","description":"Subreddit name, r/name or URL. One of subreddit / author / post_url is required. Locked in cursor."},"author":{"type":"string","description":"Reddit username (archive-backed; rarer query words work best). Locked in cursor."},"post_url":{"type":"string","format":"uri","description":"Parent post URL or t3_ id to search inside. Locked in cursor."},"source":{"type":"string","default":"auto","enum":["auto","oauth","arctic"],"description":"auto = live Reddit feed first, then older archive matches. Locked in cursor."},"after":{"type":"string","description":"Only comments after this UTC epoch seconds / ISO date. Locked in cursor."},"before":{"type":"string","description":"Only comments before this UTC epoch seconds / ISO date. Locked in cursor."},"safe_search":{"type":"boolean","default":false,"description":"1 excludes NSFW / unknown parent posts. Locked in cursor."},"include_deleted":{"type":"boolean","default":false,"description":"Keep [deleted]/[removed] comments. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["query"]}}}}}},"/reddit-comments/":{"get":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Post Comments","operationId":"get_reddit_comments","parameters":[{"name":"urls","in":"query","required":true,"description":"Reddit post URL (or share link / redd.it / t3_<id>). Required on first call; ignored when `cursor` is supplied. 50 comments per page, native cursor.","schema":{"type":"string","default":"https://www.reddit.com/r/ChatGPT/comments/1epeshq/these_are_all_ai/","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"reply_limit","in":"query","required":false,"description":"Direct replies kept per comment (0 = top-level only; max 500). Locked into the cursor.","schema":{"type":"integer","default":1}},{"name":"sort_order","in":"query","required":false,"description":"Comment sort: hot, best, confidence, top, new, controversial, old, qa, random, live, all. Locked into the cursor. (random reshuffles every call - not page-stable.)","schema":{"type":"string","default":"hot"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Post Comments","operationId":"post_reddit_comments","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.reddit.com/r/ChatGPT/comments/1epeshq/these_are_all_ai/","format":"uri","description":"Reddit post URL (or share link / redd.it / t3_<id>). Required on first call; ignored when `cursor` is supplied. 50 comments per page, native cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"reply_limit":{"type":"integer","default":1,"description":"Direct replies kept per comment (0 = top-level only; max 500). Locked into the cursor."},"sort_order":{"type":"string","default":"hot","description":"Comment sort: hot, best, confidence, top, new, controversial, old, qa, random, live, all. Locked into the cursor. (random reshuffles every call - not page-stable.)"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/reddit-post-search/":{"get":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Post Search","operationId":"get_reddit_post_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"programming"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"Sort: relevance, hot, top, new, comments. Locked into the cursor.","schema":{"type":"string","default":"comments","enum":["comments","hot","top","new","relevance"]}},{"name":"time_filter","in":"query","required":false,"description":"Time window: hour, day, week, month, year, all. Locked into the cursor.","schema":{"type":"string","default":"year","enum":["hour","day","week","month","year","all"]}},{"name":"subreddit","in":"query","required":false,"description":"Optional: restrict the search to one subreddit (name, r/Name or URL). Locked into the cursor.","schema":{"type":"string"}},{"name":"page_size","in":"query","required":false,"description":"Posts per page (1-100). Locked into the cursor.","schema":{"type":"integer","default":25,"minimum":1,"maximum":100}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Post Search","operationId":"post_reddit_post_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"programming","description":"Search term. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","default":"comments","enum":["comments","hot","top","new","relevance"],"description":"Sort: relevance, hot, top, new, comments. Locked into the cursor."},"time_filter":{"type":"string","default":"year","enum":["hour","day","week","month","year","all"],"description":"Time window: hour, day, week, month, year, all. Locked into the cursor."},"subreddit":{"type":"string","description":"Optional: restrict the search to one subreddit (name, r/Name or URL). Locked into the cursor."},"page_size":{"type":"integer","default":25,"minimum":1,"maximum":100,"description":"Posts per page (1-100). Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/reddit-post-transcript/":{"get":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Post Transcript","operationId":"get_reddit_post_transcript","parameters":[{"name":"urls","in":"query","required":true,"description":"The Reddit post: permalink (www / old / new / np / m / sh hosts), /comments/<id>, redd.it/<id>, v.redd.it/<video_id>, www.reddit.com/video/<video_id>, a /r/<sub>/s/<token> share link, or the bare id \"1u7xfz4\" / \"t3_1u7xfz4\" -> ONE transcript record: post metadata (title, subreddit, author, created_at, score, num_comments, video {duration, width, height, has_audio ...}), video_id, caption_url, the raw WebVTT file (vtt), the plain-text transcript, timed segments [{start, end, text}], cue_count / word_count. Single lookup: next_cursor is always null. A text / image / link post answers status no_video, an uncaptioned Reddit video status no_captions, an unknown / removed post status not_found.","schema":{"type":"string","default":"https://www.reddit.com/r/PraiseTheCameraMan/comments/1u7xfz4/camera_guy_keeping_up_with_performance/"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"2-letter caption language (default en; Reddit publishes English captions only - other codes answer no_captions). Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"transcript_mode","in":"query","required":false,"description":"reference (default) = the hosted API's text cue for cue (with the rolling-window repeats); clean = the spoken words once. Locked in cursor.","schema":{"type":"string","default":"reference","enum":["reference","clean"]}},{"name":"page_fallback","in":"query","required":false,"description":"true (default) = when the conventional caption file is missing, load the post page once and follow the caption-url its player declares if it differs. false = CDN only. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Post Transcript","operationId":"post_reddit_post_transcript","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.reddit.com/r/PraiseTheCameraMan/comments/1u7xfz4/camera_guy_keeping_up_with_performance/","description":"The Reddit post: permalink (www / old / new / np / m / sh hosts), /comments/<id>, redd.it/<id>, v.redd.it/<video_id>, www.reddit.com/video/<video_id>, a /r/<sub>/s/<token> share link, or the bare id \"1u7xfz4\" / \"t3_1u7xfz4\" -> ONE transcript record: post metadata (title, subreddit, author, created_at, score, num_comments, video {duration, width, height, has_audio ...}), video_id, caption_url, the raw WebVTT file (vtt), the plain-text transcript, timed segments [{start, end, text}], cue_count / word_count. Single lookup: next_cursor is always null. A text / image / link post answers status no_video, an uncaptioned Reddit video status no_captions, an unknown / removed post status not_found."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"language":{"type":"string","default":"en","description":"2-letter caption language (default en; Reddit publishes English captions only - other codes answer no_captions). Locked in cursor."},"transcript_mode":{"type":"string","default":"reference","enum":["reference","clean"],"description":"reference (default) = the hosted API's text cue for cue (with the rolling-window repeats); clean = the spoken words once. Locked in cursor."},"page_fallback":{"type":"boolean","default":true,"description":"true (default) = when the conventional caption file is missing, load the post page once and follow the caption-url its player declares if it differs. false = CDN only. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/reddit-profile/":{"get":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit User Submitted Posts","operationId":"get_reddit_profile","parameters":[{"name":"users","in":"query","required":true,"description":"Reddit username: name, u/name or profile URL. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"spez"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Listing order: new, hot, top, controversial. Locked into the cursor.","schema":{"type":"string","default":"new","enum":["new","hot","top","controversial"]}},{"name":"time_filter","in":"query","required":false,"description":"Time window for sort=top/controversial (alias: t). Locked into the cursor.","schema":{"type":"string","default":"all","enum":["hour","day","week","month","year","all"]}},{"name":"limit","in":"query","required":false,"description":"Posts per page, 1-100 (one Reddit call per page). Locked into the cursor.","schema":{"type":"integer","default":25}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit User Submitted Posts","operationId":"post_reddit_profile","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"users":{"type":"string","default":"spez","description":"Reddit username: name, u/name or profile URL. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort":{"type":"string","default":"new","enum":["new","hot","top","controversial"],"description":"Listing order: new, hot, top, controversial. Locked into the cursor."},"time_filter":{"type":"string","default":"all","enum":["hour","day","week","month","year","all"],"description":"Time window for sort=top/controversial (alias: t). Locked into the cursor."},"limit":{"type":"integer","default":25,"description":"Posts per page, 1-100 (one Reddit call per page). Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["users"]}}}}}},"/reddit-subreddit-info-details/":{"get":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Subreddit Info Details","operationId":"get_reddit_subreddit_info_details","parameters":[{"name":"subreddits","in":"query","required":true,"description":"Subreddit name (\"AskReddit\", \"r/AskReddit\" - any casing) or a subreddit URL (www./old./new./np. hosts) -> ONE full detail record (subreddit_id, display_name, title, subscribers, weekly_active_users, weekly_contributions, description, created_at, rules, icon / banner URLs, is_nsfw, subreddit_type, language ...). Single lookup: next_cursor is always null. An unknown / private / banned / quarantined subreddit answers a status record (not_found | private | banned | quarantined | gold_only).","schema":{"type":"string","default":"AskReddit"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"fetch_page","in":"query","required":false,"description":"true (default) = also load the reddit.com community page for the web-only leaves (weekly_active_users, weekly_contributions, ms-precise created_at, web image variants, community_status). false = API only. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Subreddit Info Details","operationId":"post_reddit_subreddit_info_details","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"subreddits":{"type":"string","default":"AskReddit","description":"Subreddit name (\"AskReddit\", \"r/AskReddit\" - any casing) or a subreddit URL (www./old./new./np. hosts) -> ONE full detail record (subreddit_id, display_name, title, subscribers, weekly_active_users, weekly_contributions, description, created_at, rules, icon / banner URLs, is_nsfw, subreddit_type, language ...). Single lookup: next_cursor is always null. An unknown / private / banned / quarantined subreddit answers a status record (not_found | private | banned | quarantined | gold_only)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"fetch_page":{"type":"boolean","default":true,"description":"true (default) = also load the reddit.com community page for the web-only leaves (weekly_active_users, weekly_contributions, ms-precise created_at, web image variants, community_status). false = API only. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["subreddits"]}}}}}},"/reddit-subreddit-posts/":{"get":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Subreddit Posts","operationId":"get_reddit_subreddit_posts","parameters":[{"name":"subreddits","in":"query","required":true,"description":"Subreddit name (\"AbsoluteUnits\"), \"r/AbsoluteUnits\" or a full reddit.com/r/AbsoluteUnits/ URL (case-insensitive) -> ONE native Reddit Listing page per call (`limit` posts, default 25) in listing order, each row with the post's engagement metrics, author, flair, selftext, media URL, permalink and the subreddit info block. A private / banned / quarantined / premium-only / unknown / empty subreddit answers one status row (next_cursor null). Required on the first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"AbsoluteUnits"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"after","in":"query","required":false,"description":"First call only: start the walk at a Reddit post fullname (\"t3_1w05sdh\" or the bare id) instead of the top of the listing. Later pages come from `cursor` (which carries Reddit's own `after`).","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"hot (default) | new | top | rising | controversial | best. Locked in cursor.","schema":{"type":"string","default":"hot","enum":["hot","new","top","rising","controversial","best"]}},{"name":"timeframe","in":"query","required":false,"description":"Window for sort=top / controversial (empty = Reddit's default, day). Locked in cursor.","schema":{"type":"string","enum":["hour","day","week","month","year","all"]}},{"name":"trim","in":"query","required":false,"description":"true = the reference post fields only; false = + every other field Reddit returns for the post (~110 keys). Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"limit","in":"query","required":false,"description":"Posts per page = one Reddit Listing call, 1..100 (default 25); larger values are clamped to 100 with a note in `warnings`. Locked in cursor.","schema":{"type":"integer","default":25,"minimum":1,"maximum":100}},{"name":"include_subreddit_info","in":"query","required":false,"description":"Attach the subreddit info block (subscribers, weekly_active_users, rules, icons ...) to every row: /about + /about/rules + one community page load on the first call; continuation pages reuse the weekly stats carried in the cursor. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Subreddit Posts","operationId":"post_reddit_subreddit_posts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"subreddits":{"type":"string","default":"AbsoluteUnits","description":"Subreddit name (\"AbsoluteUnits\"), \"r/AbsoluteUnits\" or a full reddit.com/r/AbsoluteUnits/ URL (case-insensitive) -> ONE native Reddit Listing page per call (`limit` posts, default 25) in listing order, each row with the post's engagement metrics, author, flair, selftext, media URL, permalink and the subreddit info block. A private / banned / quarantined / premium-only / unknown / empty subreddit answers one status row (next_cursor null). Required on the first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"after":{"type":"string","description":"First call only: start the walk at a Reddit post fullname (\"t3_1w05sdh\" or the bare id) instead of the top of the listing. Later pages come from `cursor` (which carries Reddit's own `after`)."},"sort":{"type":"string","default":"hot","enum":["hot","new","top","rising","controversial","best"],"description":"hot (default) | new | top | rising | controversial | best. Locked in cursor."},"timeframe":{"type":"string","enum":["hour","day","week","month","year","all"],"description":"Window for sort=top / controversial (empty = Reddit's default, day). Locked in cursor."},"trim":{"type":"boolean","default":true,"description":"true = the reference post fields only; false = + every other field Reddit returns for the post (~110 keys). Locked in cursor."},"limit":{"type":"integer","default":25,"minimum":1,"maximum":100,"description":"Posts per page = one Reddit Listing call, 1..100 (default 25); larger values are clamped to 100 with a note in `warnings`. Locked in cursor."},"include_subreddit_info":{"type":"boolean","default":true,"description":"Attach the subreddit info block (subscribers, weekly_active_users, rules, icons ...) to every row: /about + /about/rules + one community page load on the first call; continuation pages reuse the weekly stats carried in the cursor. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["subreddits"]}}}}}},"/reddit-subreddit-search/":{"get":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Subreddit Search","operationId":"get_reddit_subreddit_search","parameters":[{"name":"subreddits","in":"query","required":false,"description":"Subreddit to search inside (\"SelfDrivingCars\", \"r/SelfDrivingCars\" or a reddit.com/r/<name> URL; a full /r/<name>/search/?q=..&sort=..&t=..&type=.. URL fills the empty options). EMPTY = all of Reddit. At least one of subreddits / queries on the first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"SelfDrivingCars"}},{"name":"queries","in":"query","required":false,"description":"Search terms (Reddit syntax works). EMPTY = the subreddit's unfiltered list. ONE native Reddit search page per call (7 posts / ~9-10 comments / 7 media - Reddit ignores page-size params; source=api = 100-row Listing pages), rows in Reddit's order with flat id / title / score / num_comments / author / permalink / url (+ body for comments, media_urls for media) plus the full post (or comment) + computed blocks. Required on the first call (unless subreddits is given); ignored when `cursor` is supplied.","schema":{"type":"string","default":"waymo"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"posts (default) | comments | media - Reddit's search tabs. Locked in cursor.","schema":{"type":"string","default":"posts","enum":["posts","comments","media"]}},{"name":"sort","in":"query","required":false,"description":"relevance (default) | hot | top | new | comments (comments type: relevance | top | new). Locked in cursor.","schema":{"type":"string","default":"relevance","enum":["relevance","hot","top","new","comments"]}},{"name":"timeframe","in":"query","required":false,"description":"hour | day | week | month | year | all (relevance / top / comments only). Locked in cursor.","schema":{"type":"string","enum":["hour","day","week","month","year","all"]}},{"name":"include_body","in":"query","required":false,"description":"true = hydrate every hit via oauth.reddit.com/api/info (selftext, upvote_ratio, flair, media, awards ...). Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"source","in":"query","required":false,"description":"auto (default) = the site's index (fresh guest sessions raced on a wall); when it stays walled the first page falls back and the walk continues on that index: posts+query -> api search, subreddit without query -> api listing, media -> api filtered to image/video/gallery, comments in a subreddit -> Arctic Shift archive (rows carry `source`, response `warning`). web = site index only; api = oauth.reddit.com Listing search (100 a page, `after` cursor, bodies included, posts only). Nothing able to serve the page -> HTTP 502 naming the cursor to retry. Locked in cursor.","schema":{"type":"string","default":"auto","enum":["auto","web","api"]}},{"name":"trim","in":"query","required":false,"description":"false = + every raw Reddit field of hydrated hits in the post / comment block. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit Subreddit Search","operationId":"post_reddit_subreddit_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"subreddits":{"type":"string","default":"SelfDrivingCars","description":"Subreddit to search inside (\"SelfDrivingCars\", \"r/SelfDrivingCars\" or a reddit.com/r/<name> URL; a full /r/<name>/search/?q=..&sort=..&t=..&type=.. URL fills the empty options). EMPTY = all of Reddit. At least one of subreddits / queries on the first call; ignored when `cursor` is supplied."},"queries":{"type":"string","default":"waymo","description":"Search terms (Reddit syntax works). EMPTY = the subreddit's unfiltered list. ONE native Reddit search page per call (7 posts / ~9-10 comments / 7 media - Reddit ignores page-size params; source=api = 100-row Listing pages), rows in Reddit's order with flat id / title / score / num_comments / author / permalink / url (+ body for comments, media_urls for media) plus the full post (or comment) + computed blocks. Required on the first call (unless subreddits is given); ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"type":{"type":"string","default":"posts","enum":["posts","comments","media"],"description":"posts (default) | comments | media - Reddit's search tabs. Locked in cursor."},"sort":{"type":"string","default":"relevance","enum":["relevance","hot","top","new","comments"],"description":"relevance (default) | hot | top | new | comments (comments type: relevance | top | new). Locked in cursor."},"timeframe":{"type":"string","enum":["hour","day","week","month","year","all"],"description":"hour | day | week | month | year | all (relevance / top / comments only). Locked in cursor."},"include_body":{"type":"boolean","default":false,"description":"true = hydrate every hit via oauth.reddit.com/api/info (selftext, upvote_ratio, flair, media, awards ...). Locked in cursor."},"source":{"type":"string","default":"auto","enum":["auto","web","api"],"description":"auto (default) = the site's index (fresh guest sessions raced on a wall); when it stays walled the first page falls back and the walk continues on that index: posts+query -> api search, subreddit without query -> api listing, media -> api filtered to image/video/gallery, comments in a subreddit -> Arctic Shift archive (rows carry `source`, response `warning`). web = site index only; api = oauth.reddit.com Listing search (100 a page, `after` cursor, bodies included, posts only). Nothing able to serve the page -> HTTP 502 naming the cursor to retry. Locked in cursor."},"trim":{"type":"boolean","default":true,"description":"false = + every raw Reddit field of hydrated hits in the post / comment block. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/reddit-user-profile-posts-comments/":{"get":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit User Profile","operationId":"get_reddit_user_profile_posts_comments","parameters":[{"name":"users","in":"query","required":true,"description":"Reddit username, u/name, /user/name or profile URL. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"HLCYSWAP"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"content_type","in":"query","required":false,"description":"both (posts + comments) | posts | comments. Locked into the cursor.","schema":{"type":"string","default":"both"}},{"name":"page_size","in":"query","required":false,"description":"Items per page (1-100). Locked into the cursor.","schema":{"type":"integer","default":25}},{"name":"extract_content","in":"query","required":false,"description":"Kept for compatibility: full selftext/body always come from the listing JSON.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["reddit"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Reddit User Profile","operationId":"post_reddit_user_profile_posts_comments","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"users":{"type":"string","default":"HLCYSWAP","description":"Reddit username, u/name, /user/name or profile URL. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"content_type":{"type":"string","default":"both","description":"both (posts + comments) | posts | comments. Locked into the cursor."},"page_size":{"type":"integer","default":25,"description":"Items per page (1-100). Locked into the cursor."},"extract_content":{"type":"boolean","default":true,"description":"Kept for compatibility: full selftext/body always come from the listing JSON."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["users"]}}}}}},"/rumble-channel-videos/":{"get":{"tags":["rumble"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Rumble Channel Videos","operationId":"get_rumble_channel_videos","parameters":[{"name":"handles","in":"query","required":true,"description":"Bare handle, @handle, or rumble.com/c|user/<handle> URL. Required first call.","schema":{"type":"string","default":"CuteCats223"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["rumble"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Rumble Channel Videos","operationId":"post_rumble_channel_videos","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"handles":{"type":"string","default":"CuteCats223","description":"Bare handle, @handle, or rumble.com/c|user/<handle> URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["handles"]}}}}}},"/rumble-comments/":{"get":{"tags":["rumble"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Rumble Comments","operationId":"get_rumble_comments","parameters":[{"name":"urls","in":"query","required":true,"description":"Full Rumble watch URL or bare video id. Lookup endpoint -- next_cursor null. Returns the entire comment tree in one call.","schema":{"type":"string","default":"https://rumble.com/v7fr3se-test.html","format":"uri"}},{"name":"sort","in":"query","required":false,"description":"Comment sort; empty = site default.","schema":{"type":"string"}},{"name":"include_replies","in":"query","required":false,"description":"","schema":{"type":"boolean","default":false}},{"name":"max_comments","in":"query","required":false,"description":"Cap top-level comments kept.","schema":{"type":"integer"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["rumble"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Rumble Comments","operationId":"post_rumble_comments","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://rumble.com/v7fr3se-test.html","format":"uri","description":"Full Rumble watch URL or bare video id. Lookup endpoint -- next_cursor null. Returns the entire comment tree in one call."},"sort":{"type":"string","description":"Comment sort; empty = site default."},"include_replies":{"type":"boolean","default":false,"description":""},"max_comments":{"type":"integer","description":"Cap top-level comments kept."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/rumble-search/":{"get":{"tags":["rumble"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Rumble Search","operationId":"get_rumble_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term on rumble.com. Required first call.","schema":{"type":"string","default":"cat"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["rumble"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Rumble Search","operationId":"post_rumble_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"cat","description":"Search term on rumble.com. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/rumble-transcript/":{"get":{"tags":["rumble"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Rumble Transcript","operationId":"get_rumble_transcript","parameters":[{"name":"urls","in":"query","required":true,"description":"Full Rumble watch URL. Lookup endpoint -- next_cursor null. Native WebVTT captions, no ASR.","schema":{"type":"string","default":"https://rumble.com/v7fr3se-test.html","format":"uri"}},{"name":"language","in":"query","required":false,"description":"'auto' prefers a manual track over auto-generated, or an exact cc key.","schema":{"type":"string","default":"auto"}},{"name":"include_title","in":"query","required":false,"description":"","schema":{"type":"boolean","default":true}},{"name":"include_author","in":"query","required":false,"description":"","schema":{"type":"boolean","default":true}},{"name":"include_thumbnail","in":"query","required":false,"description":"","schema":{"type":"boolean","default":true}},{"name":"include_segments","in":"query","required":false,"description":"","schema":{"type":"boolean","default":true}},{"name":"include_full_text","in":"query","required":false,"description":"","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["rumble"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Rumble Transcript","operationId":"post_rumble_transcript","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://rumble.com/v7fr3se-test.html","format":"uri","description":"Full Rumble watch URL. Lookup endpoint -- next_cursor null. Native WebVTT captions, no ASR."},"language":{"type":"string","default":"auto","description":"'auto' prefers a manual track over auto-generated, or an exact cc key."},"include_title":{"type":"boolean","default":true,"description":""},"include_author":{"type":"boolean","default":true,"description":""},"include_thumbnail":{"type":"boolean","default":true,"description":""},"include_segments":{"type":"boolean","default":true,"description":""},"include_full_text":{"type":"boolean","default":true,"description":""},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/rumble-video/":{"get":{"tags":["rumble"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Rumble Videos","operationId":"get_rumble_video","parameters":[{"name":"urls","in":"query","required":true,"description":"Full Rumble watch URL or bare video id. One record, no pagination.","schema":{"type":"string","default":"v7fr3se","format":"uri"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["rumble"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Rumble Videos","operationId":"post_rumble_video","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"v7fr3se","format":"uri","description":"Full Rumble watch URL or bare video id. One record, no pagination."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/seek-jobs/":{"get":{"tags":["seek"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Seek Job Scraper","operationId":"get_seek_jobs","parameters":[{"name":"queries","in":"query","required":false,"description":"Search keyword. Locked in cursor. Empty = browse-by-filter mode.","schema":{"type":"string","default":"developer"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"search_url","in":"query","required":false,"description":"Full SEEK search URL override. Locked in cursor.","schema":{"type":"string"}},{"name":"location","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"All Sydney NSW"}},{"name":"sort_by","in":"query","required":false,"description":"","schema":{"type":"string","default":"ListedDate","enum":["ListedDate","KeywordRelevance"]}},{"name":"date_range","in":"query","required":false,"description":"","schema":{"type":"integer","default":7}},{"name":"country","in":"query","required":false,"description":"","schema":{"type":"string","default":"australia","enum":["australia","new zealand","hongkong","indonesia","malaysia","philippines","singapore","thailand"]}},{"name":"classifications","in":"query","required":false,"description":"SEEK taxonomy handles. Locked in cursor.","schema":{"type":"string"}},{"name":"work_types","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"work_arrangements","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"seek_cookie","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Page size (server caps at 100).","schema":{"type":"integer","default":100}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["seek"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Seek Job Scraper","operationId":"post_seek_jobs","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"developer","description":"Search keyword. Locked in cursor. Empty = browse-by-filter mode."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"search_url":{"type":"string","description":"Full SEEK search URL override. Locked in cursor."},"location":{"type":"string","default":"All Sydney NSW","description":"Locked in cursor."},"sort_by":{"type":"string","default":"ListedDate","enum":["ListedDate","KeywordRelevance"],"description":""},"date_range":{"type":"integer","default":7,"description":""},"country":{"type":"string","default":"australia","enum":["australia","new zealand","hongkong","indonesia","malaysia","philippines","singapore","thailand"],"description":""},"classifications":{"type":"string","description":"SEEK taxonomy handles. Locked in cursor."},"work_types":{"type":"string","description":""},"work_arrangements":{"type":"string","description":""},"seek_cookie":{"type":"string","description":""},"max_items":{"type":"integer","default":100,"description":"Page size (server caps at 100)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/shopify-product/":{"get":{"tags":["shopify"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Shopify Product Scraper","operationId":"get_shopify_product","parameters":[{"name":"urls","in":"query","required":true,"description":"Shopify store base URL. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"https://gymshark.com","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["shopify"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Shopify Product Scraper","operationId":"post_shopify_product","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://gymshark.com","format":"uri","description":"Shopify store base URL. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/shopify-store/":{"get":{"tags":["shopify"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Shopify Store Profile","operationId":"get_shopify_store","parameters":[{"name":"urls","in":"query","required":true,"description":"Shopify store root URL. Lookup endpoint — one summary per request.","schema":{"type":"string","default":"https://gymshark.com","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"extract_reviews","in":"query","required":false,"description":"Fetch Yotpo review stats for up to 10 newest products. Locked into the cursor.","schema":{"type":"boolean","default":false}},{"name":"max_items","in":"query","required":false,"description":"Products sampled when building the store summary (not the v2 page size). Locked into the cursor.","schema":{"type":"integer","default":50}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["shopify"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Shopify Store Profile","operationId":"post_shopify_store","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://gymshark.com","format":"uri","description":"Shopify store root URL. Lookup endpoint — one summary per request."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"extract_reviews":{"type":"boolean","default":false,"description":"Fetch Yotpo review stats for up to 10 newest products. Locked into the cursor."},"max_items":{"type":"integer","default":50,"description":"Products sampled when building the store summary (not the v2 page size). Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/snapchat-profile/":{"get":{"tags":["snapchat"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Snapchat Profile","operationId":"get_snapchat_profile","parameters":[{"name":"usernames","in":"query","required":true,"description":"Snapchat username (@ optional). Lookup endpoint — one profile per request.","schema":{"type":"string","default":"mohsenalnssar"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["snapchat"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Snapchat Profile","operationId":"post_snapchat_profile","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"mohsenalnssar","description":"Snapchat username (@ optional). Lookup endpoint — one profile per request."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/snapchat-profile-full/":{"get":{"tags":["snapchat"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Snapchat Profile + Highlights","operationId":"get_snapchat_profile_full","parameters":[{"name":"usernames","in":"query","required":true,"description":"Snapchat username (@ optional). Lookup endpoint — one profile (+ nested stories) per request.","schema":{"type":"string","default":"mrbeast"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["snapchat"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Snapchat Profile + Highlights","operationId":"post_snapchat_profile_full","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"mrbeast","description":"Snapchat username (@ optional). Lookup endpoint — one profile (+ nested stories) per request."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/target-category/":{"get":{"tags":["target"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Target Category","operationId":"get_target_category","parameters":[{"name":"urls","in":"query","required":true,"description":"Target category URL or bare category id. Required first call.","schema":{"type":"string","default":"https://www.target.com/c/kitchen-dining/-/N-hz89j"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"featured","enum":["featured","price_low","price_high","rating","bestselling","newest"]}},{"name":"store_id","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"3991"}},{"name":"zip","in":"query","required":false,"description":"Availability store ZIP. Locked in cursor.","schema":{"type":"string","default":"55403"}},{"name":"enrich_details","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"include_sponsored","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["target"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Target Category","operationId":"post_target_category","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.target.com/c/kitchen-dining/-/N-hz89j","description":"Target category URL or bare category id. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","default":"featured","enum":["featured","price_low","price_high","rating","bestselling","newest"],"description":"Locked in cursor."},"store_id":{"type":"string","default":"3991","description":"Locked in cursor."},"zip":{"type":"string","default":"55403","description":"Availability store ZIP. Locked in cursor."},"enrich_details":{"type":"boolean","default":true,"description":"Locked in cursor."},"include_sponsored":{"type":"boolean","default":false,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/target-reviews/":{"get":{"tags":["target"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Target Reviews","operationId":"get_target_reviews","parameters":[{"name":"urls","in":"query","required":true,"description":"Target product URL or bare TCIN. Required first call. 50 reviews per page.","schema":{"type":"string","default":"https://www.target.com/p/beats-solo-buds-true-wireless-bluetooth-earbuds/-/A-92148487"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"most_recent","enum":["most_recent","helpfulness_desc","highest_rating","lowest_rating"]}},{"name":"rating_filter","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","minimum":1,"maximum":5}},{"name":"verified_only","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"photos_only","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"judgments","in":"query","required":false,"description":"Sentiment + issue labels. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"label","in":"query","required":false,"description":"Extra presets: incentivized, injection, reports. Locked in cursor.","schema":{"type":"string"}},{"name":"reports","in":"query","required":false,"description":"For label=reports. Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["target"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Target Reviews","operationId":"post_target_reviews","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.target.com/p/beats-solo-buds-true-wireless-bluetooth-earbuds/-/A-92148487","description":"Target product URL or bare TCIN. Required first call. 50 reviews per page."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","default":"most_recent","enum":["most_recent","helpfulness_desc","highest_rating","lowest_rating"],"description":"Locked in cursor."},"rating_filter":{"type":"integer","minimum":1,"maximum":5,"description":"Locked in cursor."},"verified_only":{"type":"boolean","default":false,"description":"Locked in cursor."},"photos_only":{"type":"boolean","default":false,"description":"Locked in cursor."},"judgments":{"type":"boolean","default":true,"description":"Sentiment + issue labels. Locked in cursor."},"label":{"type":"string","description":"Extra presets: incentivized, injection, reports. Locked in cursor."},"reports":{"type":"string","description":"For label=reports. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/target-search-products/":{"get":{"tags":["target"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Target Search Products","operationId":"get_target_search_products","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term or Target search/category/brand URL. Required first call. ~24-30 products per page.","schema":{"type":"string","default":"baking sheet"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","enum":["relevance","featured","price_low","price_high","newest","bestselling","rating"]}},{"name":"zip_code","in":"query","required":false,"description":"Store/fulfillment ZIP. Locked in cursor.","schema":{"type":"string","default":"52404"}},{"name":"fetch_product_details","in":"query","required":false,"description":"+1 pdp call per product. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"include_sponsored","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["target"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Target Search Products","operationId":"post_target_search_products","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"baking sheet","description":"Search term or Target search/category/brand URL. Required first call. ~24-30 products per page."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","enum":["relevance","featured","price_low","price_high","newest","bestselling","rating"],"description":"Locked in cursor."},"zip_code":{"type":"string","default":"52404","description":"Store/fulfillment ZIP. Locked in cursor."},"fetch_product_details":{"type":"boolean","default":false,"description":"+1 pdp call per product. Locked in cursor."},"include_sponsored":{"type":"boolean","default":true,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/target-single-product-info/":{"get":{"tags":["target"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Target Single Product Info","operationId":"get_target_single_product_info","parameters":[{"name":"urls","in":"query","required":true,"description":"Target product URL or bare TCIN. One record per product.","schema":{"type":"string","default":"https://www.target.com/p/beats-solo-buds-true-wireless-bluetooth-earbuds/-/A-92148487"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["target"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Target Single Product Info","operationId":"post_target_single_product_info","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.target.com/p/beats-solo-buds-true-wireless-bluetooth-earbuds/-/A-92148487","description":"Target product URL or bare TCIN. One record per product."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/target-stores/":{"get":{"tags":["target"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Target Stores","operationId":"get_target_stores","parameters":[{"name":"queries","in":"query","required":true,"description":"ZIP, city, \"city, ST\", state or Target URL. Required first call. 20 stores per page.","schema":{"type":"string","default":"10001"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"radius_miles","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":100,"minimum":1,"maximum":5000}},{"name":"include_details","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"include_google","in":"query","required":false,"description":"Google rating/reviews/photos. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["target"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Target Stores","operationId":"post_target_stores","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"10001","description":"ZIP, city, \"city, ST\", state or Target URL. Required first call. 20 stores per page."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"radius_miles":{"type":"integer","default":100,"minimum":1,"maximum":5000,"description":"Locked in cursor."},"include_details":{"type":"boolean","default":true,"description":"Locked in cursor."},"include_google":{"type":"boolean","default":false,"description":"Google rating/reviews/photos. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/telegram-channel/":{"get":{"tags":["telegram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Telegram Channel Profile + Messages","operationId":"get_telegram_channel","parameters":[{"name":"urls","in":"query","required":true,"description":"Public Telegram channel URL or @handle. Lookup endpoint — one channel doc per request.","schema":{"type":"string","default":"https://t.me/durov","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Messages embedded in the channel doc (>20 triggers pagination upstream). Locked into the cursor.","schema":{"type":"integer","default":10}},{"name":"timeout","in":"query","required":false,"description":"HTTP timeout in seconds (5–120). Locked into the cursor.","schema":{"type":"integer","default":30,"minimum":5,"maximum":120}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["telegram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Telegram Channel Profile + Messages","operationId":"post_telegram_channel","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://t.me/durov","format":"uri","description":"Public Telegram channel URL or @handle. Lookup endpoint — one channel doc per request."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_items":{"type":"integer","default":10,"description":"Messages embedded in the channel doc (>20 triggers pagination upstream). Locked into the cursor."},"timeout":{"type":"integer","default":30,"minimum":5,"maximum":120,"description":"HTTP timeout in seconds (5–120). Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/telegram-single-post/":{"get":{"tags":["telegram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Telegram Single Post","operationId":"get_telegram_single_post","parameters":[{"name":"urls","in":"query","required":true,"description":"Public t.me post URL. Lookup endpoint -- next_cursor null.","schema":{"type":"string","default":"https://t.me/durov/543","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["telegram"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Telegram Single Post","operationId":"post_telegram_single_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://t.me/durov/543","format":"uri","description":"Public t.me post URL. Lookup endpoint -- next_cursor null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/threads-profile-info/":{"get":{"tags":["threads"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Threads Profile Info","operationId":"get_threads_profile_info","parameters":[{"name":"usernames","in":"query","required":true,"description":"A Threads username, @handle, profile/post URL or id:<numeric user id> (user_id takes bare digits). Single record; next_cursor is always null.","schema":{"type":"string","default":"trendspider"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["threads"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Threads Profile Info","operationId":"post_threads_profile_info","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"trendspider","description":"A Threads username, @handle, profile/post URL or id:<numeric user id> (user_id takes bare digits). Single record; next_cursor is always null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/threads-replies/":{"get":{"tags":["threads"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Threads Replies","operationId":"get_threads_replies","parameters":[{"name":"urls","in":"query","required":true,"description":"A single Threads post URL to scrape replies from. Required first call. Aliases: post_urls, url.","schema":{"type":"string","default":"https://www.threads.com/@zuck/post/DTa3-B1EbTp","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_nested_replies","in":"query","required":false,"description":"Also collect nested sub-replies. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"session_id","in":"query","required":true,"description":"REQUIRED on every call, including cursor pages (not locked into the cursor): your own logged-in Threads sessionid cookie (or cookie_string=\"sessionid=...\").","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["threads"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Threads Replies","operationId":"post_threads_replies","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.threads.com/@zuck/post/DTa3-B1EbTp","format":"uri","description":"A single Threads post URL to scrape replies from. Required first call. Aliases: post_urls, url."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_nested_replies":{"type":"boolean","default":true,"description":"Also collect nested sub-replies. Locked in cursor."},"session_id":{"type":"string","description":"REQUIRED on every call, including cursor pages (not locked into the cursor): your own logged-in Threads sessionid cookie (or cookie_string=\"sessionid=...\")."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls","session_id"]}}}}}},"/threads-search/":{"get":{"tags":["threads"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Threads Search","operationId":"get_threads_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Threads search term / hashtag / phrase. Required first call. Aliases: search_query, q.","schema":{"type":"string","default":"AI"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"top | recent. Locked in cursor.","schema":{"type":"string","default":"top","enum":["top","recent"]}},{"name":"from","in":"query","required":false,"description":"Only keep posts from this username (client-side). Locked in cursor.","schema":{"type":"string"}},{"name":"before","in":"query","required":false,"description":"Only keep posts before this date (YYYY-MM-DD). Locked in cursor.","schema":{"type":"string","format":"date"}},{"name":"after","in":"query","required":false,"description":"Only keep posts after this date (YYYY-MM-DD). Locked in cursor.","schema":{"type":"string","format":"date"}},{"name":"session_id","in":"query","required":false,"description":"Optional Threads sessionid cookie, resolved fresh on every call (not locked into the cursor). Anonymous still works, capped at one page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["threads"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Threads Search","operationId":"post_threads_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"AI","description":"Threads search term / hashtag / phrase. Required first call. Aliases: search_query, q."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort":{"type":"string","default":"top","enum":["top","recent"],"description":"top | recent. Locked in cursor."},"from":{"type":"string","description":"Only keep posts from this username (client-side). Locked in cursor."},"before":{"type":"string","format":"date","description":"Only keep posts before this date (YYYY-MM-DD). Locked in cursor."},"after":{"type":"string","format":"date","description":"Only keep posts after this date (YYYY-MM-DD). Locked in cursor."},"session_id":{"type":"string","description":"Optional Threads sessionid cookie, resolved fresh on every call (not locked into the cursor). Anonymous still works, capped at one page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/threads-search-users/":{"get":{"tags":["threads"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Threads Search Users","operationId":"get_threads_search_users","parameters":[{"name":"queries","in":"query","required":true,"description":"Search text (a handle, a name or a topic) -> the matching Threads accounts as a guest, 12 verified accounts per call in rank order. Required first call, ignored when `cursor` is supplied.","schema":{"type":"string","default":"shams"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include","in":"query","required":false,"description":"'profile' fills bio / followers / private / ext.bio_link on every row of the page from its profile page. Locked in cursor.","schema":{"type":"string","enum":["","profile"]}},{"name":"include_details","in":"query","required":false,"description":"Older spelling of include=profile (true = the same join). Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"engines","in":"query","required":false,"description":"Handle-discovery engines, any of brave / ddg; \"\" = Threads-only. Locked in cursor.","schema":{"type":"string","default":"brave,ddg"}},{"name":"engine_pages","in":"query","required":false,"description":"Brave result pages walked at most per call. Locked in cursor.","schema":{"type":"integer","default":5,"minimum":1,"maximum":10}},{"name":"candidate_pool","in":"query","required":false,"description":"Candidates ranked before selection (default max(40, 36 x page)). Locked in cursor.","schema":{"type":"integer"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["threads"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Threads Search Users","operationId":"post_threads_search_users","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"shams","description":"Search text (a handle, a name or a topic) -> the matching Threads accounts as a guest, 12 verified accounts per call in rank order. Required first call, ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include":{"type":"string","enum":["","profile"],"description":"'profile' fills bio / followers / private / ext.bio_link on every row of the page from its profile page. Locked in cursor."},"include_details":{"type":"boolean","default":false,"description":"Older spelling of include=profile (true = the same join). Locked in cursor."},"engines":{"type":"string","default":"brave,ddg","description":"Handle-discovery engines, any of brave / ddg; \"\" = Threads-only. Locked in cursor."},"engine_pages":{"type":"integer","default":5,"minimum":1,"maximum":10,"description":"Brave result pages walked at most per call. Locked in cursor."},"candidate_pool":{"type":"integer","description":"Candidates ranked before selection (default max(40, 36 x page)). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/threads-single-post/":{"get":{"tags":["threads"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Threads Single Post","operationId":"get_threads_single_post","parameters":[{"name":"urls","in":"query","required":true,"description":"A Threads post URL. Single record; next_cursor is always null.","schema":{"type":"string","default":"https://www.threads.com/@zuck/post/DdZ7sQvkTFn","format":"uri"}},{"name":"max_comments","in":"query","required":false,"description":"Comments to include (0-50 on v2).","schema":{"type":"integer","default":20,"maximum":50}},{"name":"include_nested_replies","in":"query","required":false,"description":"Also fetch replies to comments.","schema":{"type":"boolean","default":true}},{"name":"include_related_posts","in":"query","required":false,"description":"Include related posts.","schema":{"type":"boolean","default":true}},{"name":"trim","in":"query","required":false,"description":"Compact post object; false = full raw post node.","schema":{"type":"boolean","default":true}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["threads"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Threads Single Post","operationId":"post_threads_single_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.threads.com/@zuck/post/DdZ7sQvkTFn","format":"uri","description":"A Threads post URL. Single record; next_cursor is always null."},"max_comments":{"type":"integer","default":20,"maximum":50,"description":"Comments to include (0-50 on v2)."},"include_nested_replies":{"type":"boolean","default":true,"description":"Also fetch replies to comments."},"include_related_posts":{"type":"boolean","default":true,"description":"Include related posts."},"trim":{"type":"boolean","default":true,"description":"Compact post object; false = full raw post node."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/threads-user-posts/":{"get":{"tags":["threads"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Threads User Posts","operationId":"get_threads_user_posts","parameters":[{"name":"usernames","in":"query","required":true,"description":"Threads username. Required first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"zuck"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["threads"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Threads User Posts","operationId":"post_threads_user_posts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"zuck","description":"Threads username. Required first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/tiktok-ad-library-leads/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 3 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Ad Library Leads","operationId":"get_tiktok_ad_library_leads","parameters":[{"name":"keyword","in":"query","required":false,"description":"Optional search term for the default single-query mode. Single lookup -- next_cursor is always null.","schema":{"type":"string","default":"Skincare"}},{"name":"country","in":"query","required":false,"description":"","schema":{"type":"string","default":"US"}},{"name":"period","in":"query","required":false,"description":"","schema":{"type":"integer","default":180,"enum":[7,30,180]}},{"name":"order_by","in":"query","required":false,"description":"","schema":{"type":"string","default":"for_you","enum":["for_you","impression","ctr","play_2s_rate","play_6s_rate","cvr","like"]}},{"name":"ad_format","in":"query","required":false,"description":"","schema":{"type":"string","default":"All ad types","enum":["All ad types","Spark ads","Non-Spark ads"]}},{"name":"ad_language","in":"query","required":false,"description":"","schema":{"type":"string","default":"en"}},{"name":"like_tier","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":1,"maximum":5}},{"name":"industry","in":"query","required":false,"description":"","schema":{"type":"string","default":"Skincare"}},{"name":"queries","in":"query","required":false,"description":"Optional JSON array of per-search override objects to sweep many keyword/industry/country combinations in ONE call.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Ads collected per query before dedup/grouping.","schema":{"type":"integer","default":30}},{"name":"max_landing_pages_per_advertiser","in":"query","required":false,"description":"","schema":{"type":"integer","default":3}},{"name":"max_concurrent_queries","in":"query","required":false,"description":"","schema":{"type":"integer","default":2}},{"name":"max_concurrent_details","in":"query","required":false,"description":"","schema":{"type":"integer","default":2}},{"name":"max_concurrent_crawls","in":"query","required":false,"description":"","schema":{"type":"integer","default":10}},{"name":"max_retries","in":"query","required":false,"description":"","schema":{"type":"integer","default":5}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 3 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Ad Library Leads","operationId":"post_tiktok_ad_library_leads","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","default":"Skincare","description":"Optional search term for the default single-query mode. Single lookup -- next_cursor is always null."},"country":{"type":"string","default":"US","description":""},"period":{"type":"integer","default":180,"enum":[7,30,180],"description":""},"order_by":{"type":"string","default":"for_you","enum":["for_you","impression","ctr","play_2s_rate","play_6s_rate","cvr","like"],"description":""},"ad_format":{"type":"string","default":"All ad types","enum":["All ad types","Spark ads","Non-Spark ads"],"description":""},"ad_language":{"type":"string","default":"en","description":""},"like_tier":{"type":"integer","minimum":1,"maximum":5,"description":""},"industry":{"type":"string","default":"Skincare","description":""},"queries":{"type":"string","description":"Optional JSON array of per-search override objects to sweep many keyword/industry/country combinations in ONE call."},"max_items":{"type":"integer","default":30,"description":"Ads collected per query before dedup/grouping."},"max_landing_pages_per_advertiser":{"type":"integer","default":3,"description":""},"max_concurrent_queries":{"type":"integer","default":2,"description":""},"max_concurrent_details":{"type":"integer","default":2,"description":""},"max_concurrent_crawls":{"type":"integer","default":10,"description":""},"max_retries":{"type":"integer","default":5,"description":""},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/tiktok-ads/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Ad Library","operationId":"get_tiktok_ads","parameters":[{"name":"urls","in":"query","required":true,"description":"TikTok Ad Library search URL (filters: region, start_time/end_time, adv_name, adv_biz_ids, query_type, sort_type, ad_type, ad_status, ages, ad_reach, gender) or a bare keyword. One page = 12 ads (TikTok's fixed page size). Required on first call; ignored when `cursor` is supplied (filters are locked into it).","schema":{"type":"string","default":"https://library.tiktok.com/ads?region=all&adv_name=NVIDIA%20GmbH&adv_biz_ids=6891503886842987266&query_type=2&sort_type=last_shown_date,desc","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_details","in":"query","required":false,"description":"Fetch each ad's detail record (paid-by, per-region impressions, targeting). Best-effort: if TikTok rate-limits it, ads come from search-card data (detail_fetched=false) with a `warning`. Locked into the cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Ad Library","operationId":"post_tiktok_ads","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://library.tiktok.com/ads?region=all&adv_name=NVIDIA%20GmbH&adv_biz_ids=6891503886842987266&query_type=2&sort_type=last_shown_date,desc","format":"uri","description":"TikTok Ad Library search URL (filters: region, start_time/end_time, adv_name, adv_biz_ids, query_type, sort_type, ad_type, ad_status, ages, ad_reach, gender) or a bare keyword. One page = 12 ads (TikTok's fixed page size). Required on first call; ignored when `cursor` is supplied (filters are locked into it)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_details":{"type":"boolean","default":true,"description":"Fetch each ad's detail record (paid-by, per-region impressions, targeting). Best-effort: if TikTok rate-limits it, ads come from search-card data (detail_fetched=false) with a `warning`. Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/tiktok-ads-top/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Ads Top","operationId":"get_tiktok_ads_top","parameters":[{"name":"keyword","in":"query","required":false,"description":"Optional search term (login-gated by TikTok: echoed, not applied). Each call returns one leaderboard partition (<=20 ads); pass next_cursor to walk deeper into the same filter combination.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO-2 country code, validated live against TikTok's top_ads country list.","schema":{"type":"string","default":"US"}},{"name":"period","in":"query","required":false,"description":"Leaderboard lookback window in days.","schema":{"type":"integer","default":180,"enum":[7,30,180]}},{"name":"order_by","in":"query","required":false,"description":"Leaderboard ranking axis.","schema":{"type":"string","default":"for_you","enum":["for_you","impression","ctr","play_2s_rate","play_6s_rate","cvr","like"]}},{"name":"ad_format","in":"query","required":false,"description":"Ad format filter.","schema":{"type":"string","default":"All ad types","enum":["All ad types","Spark ads","Non-Spark ads"]}},{"name":"ad_language","in":"query","required":false,"description":"Ad language code.","schema":{"type":"string","default":"en"}},{"name":"like_tier","in":"query","required":false,"description":"Engagement-tier bucket (1 = top tier).","schema":{"type":"integer","minimum":1,"maximum":5}},{"name":"industry","in":"query","required":false,"description":"Industry label, matched live.","schema":{"type":"string","default":"Skincare"}},{"name":"max_items","in":"query","required":false,"description":"Ads per page (values >20 clamp to 20 = one TikTok leaderboard partition). Follow next_cursor for more; the pool is a few hundred ads for broad filters.","schema":{"type":"integer","default":20,"minimum":1}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Ads Top","operationId":"post_tiktok_ads_top","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","description":"Optional search term (login-gated by TikTok: echoed, not applied). Each call returns one leaderboard partition (<=20 ads); pass next_cursor to walk deeper into the same filter combination."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"US","description":"ISO-2 country code, validated live against TikTok's top_ads country list."},"period":{"type":"integer","default":180,"enum":[7,30,180],"description":"Leaderboard lookback window in days."},"order_by":{"type":"string","default":"for_you","enum":["for_you","impression","ctr","play_2s_rate","play_6s_rate","cvr","like"],"description":"Leaderboard ranking axis."},"ad_format":{"type":"string","default":"All ad types","enum":["All ad types","Spark ads","Non-Spark ads"],"description":"Ad format filter."},"ad_language":{"type":"string","default":"en","description":"Ad language code."},"like_tier":{"type":"integer","minimum":1,"maximum":5,"description":"Engagement-tier bucket (1 = top tier)."},"industry":{"type":"string","default":"Skincare","description":"Industry label, matched live."},"max_items":{"type":"integer","default":20,"minimum":1,"description":"Ads per page (values >20 clamp to 20 = one TikTok leaderboard partition). Follow next_cursor for more; the pool is a few hundred ads for broad filters."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/tiktok-collection-videos/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Collection Videos","operationId":"get_tiktok_collection_videos","parameters":[{"name":"urls","in":"query","required":true,"description":"TikTok collection URL (https://www.tiktok.com/@user/collection/Name-<id>), bare collection id, or a vm.tiktok.com share link. One native page (up to 30 videos, under `videos`) per call, paged through TikTok's own offset. Required first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_collection_info","in":"query","required":false,"description":"Fetch owner profile + collection name / total / cover on page 1 (carried to later pages in the cursor). Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Collection Videos","operationId":"post_tiktok_collection_videos","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022","description":"TikTok collection URL (https://www.tiktok.com/@user/collection/Name-<id>), bare collection id, or a vm.tiktok.com share link. One native page (up to 30 videos, under `videos`) per call, paged through TikTok's own offset. Required first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_collection_info":{"type":"boolean","default":true,"description":"Fetch owner profile + collection name / total / cover on page 1 (carried to later pages in the cursor). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/tiktok-comment-replies/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Comment Replies","operationId":"get_tiktok_comment_replies","parameters":[{"name":"urls","in":"query","required":true,"description":"TikTok video URL (/video/ or /photo/), vm./vt./tiktok.com/t/ short link or bare 19-digit video id. One video per call; required on the first call, ignored when `cursor` is supplied.","schema":{"type":"string","default":"https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"comments_per_post","in":"query","required":false,"description":"Top-level comments to walk over the whole cursor chain, most relevant first (default 100; 0 = all). Locked in cursor.","schema":{"type":"integer","default":100}},{"name":"max_replies_per_comment","in":"query","required":false,"description":"Replies per top-level comment (default 1; 0 = the whole thread — long threads are then split across calls by their native reply cursor). Locked in cursor.","schema":{"type":"integer","default":1}},{"name":"include_top_comments","in":"query","required":false,"description":"Emit the top-level comment row before its replies. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"hosts","in":"query","required":false,"description":"Datacenter walked by this cursor chain: us.tiktok.com (default) or www.tiktok.com — they order top-level comments differently, so v2 walks ONE host (v1 merges both). Locked in cursor.","schema":{"type":"string","default":"us","enum":["us","www"]}},{"name":"trim","in":"query","required":false,"description":"true drops the heavy `native` object and detailed_mentions from every row. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"label","in":"query","required":false,"description":"Comma list of judge presets to add (sentiment, question, purchase_intent, complaint run by default; spam, toxic, low_quality, injection on request; \"none\" = off). Locked in cursor.","schema":{"type":"string"}},{"name":"judgments","in":"query","required":false,"description":"off = no computed.labels. Locked in cursor.","schema":{"type":"string","default":"on","enum":["on","off"]}},{"name":"drop","in":"query","required":false,"description":"Comma subset of spam,low_quality dropped at p >= 0.8 (preset must be in `label`). Locked in cursor.","schema":{"type":"string"}},{"name":"evidence","in":"query","required":false,"description":"1 adds computed.labels_evidence for the presets named in `label`. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"estimate","in":"query","required":false,"description":"1 = one `type: estimate` row, no fetch, next_cursor null. (fit=goal is v1-only.)","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Comment Replies","operationId":"post_tiktok_comment_replies","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851","format":"uri","description":"TikTok video URL (/video/ or /photo/), vm./vt./tiktok.com/t/ short link or bare 19-digit video id. One video per call; required on the first call, ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"comments_per_post":{"type":"integer","default":100,"description":"Top-level comments to walk over the whole cursor chain, most relevant first (default 100; 0 = all). Locked in cursor."},"max_replies_per_comment":{"type":"integer","default":1,"description":"Replies per top-level comment (default 1; 0 = the whole thread — long threads are then split across calls by their native reply cursor). Locked in cursor."},"include_top_comments":{"type":"boolean","default":true,"description":"Emit the top-level comment row before its replies. Locked in cursor."},"hosts":{"type":"string","default":"us","enum":["us","www"],"description":"Datacenter walked by this cursor chain: us.tiktok.com (default) or www.tiktok.com — they order top-level comments differently, so v2 walks ONE host (v1 merges both). Locked in cursor."},"trim":{"type":"boolean","default":false,"description":"true drops the heavy `native` object and detailed_mentions from every row. Locked in cursor."},"label":{"type":"string","description":"Comma list of judge presets to add (sentiment, question, purchase_intent, complaint run by default; spam, toxic, low_quality, injection on request; \"none\" = off). Locked in cursor."},"judgments":{"type":"string","default":"on","enum":["on","off"],"description":"off = no computed.labels. Locked in cursor."},"drop":{"type":"string","description":"Comma subset of spam,low_quality dropped at p >= 0.8 (preset must be in `label`). Locked in cursor."},"evidence":{"type":"boolean","default":false,"description":"1 adds computed.labels_evidence for the presets named in `label`. Locked in cursor."},"estimate":{"type":"boolean","default":false,"description":"1 = one `type: estimate` row, no fetch, next_cursor null. (fit=goal is v1-only.)"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/tiktok-comments/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Comments","operationId":"get_tiktok_comments","parameters":[{"name":"usernames","in":"query","required":false,"description":"TikTok username (@ optional). Required on first call when `manual_video_urls` is not supplied; ignored when `cursor` is supplied.","schema":{"type":"string","default":"mrbeast"}},{"name":"manual_video_urls","in":"query","required":false,"description":"TikTok video: full URL, vm.tiktok.com / vt.tiktok.com short link, or numeric video id. Takes precedence over `usernames`. Ignored when `cursor` is supplied.","schema":{"type":"string","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"results_per_profile","in":"query","required":false,"description":"Max videos discovered per profile. Locked into the cursor.","schema":{"type":"integer","default":30}},{"name":"comments_per_post","in":"query","required":false,"description":"Max top-level comments per video. Video input: empty = walk all comments. Usernames input: default 100 per video. Locked into the cursor.","schema":{"type":"integer","default":100}},{"name":"max_replies_per_comment","in":"query","required":false,"description":"Max replies fetched per comment (capped at 500; 0 = skip reply threads, fastest). Reply threads are fetched in parallel within a ~5s window per call; threads not fetched in time keep reply_comment_total and are listed in `warning`. Locked into the cursor.","schema":{"type":"integer","default":2}},{"name":"profile_sections","in":"query","required":false,"description":"Profile section: videos or reposts (first one is used). Locked into the cursor.","schema":{"type":"string","default":"videos"}},{"name":"profile_sorting","in":"query","required":false,"description":"Sort: latest, oldest, or popular. Locked into the cursor.","schema":{"type":"string","default":"latest"}},{"name":"oldest_post_date","in":"query","required":false,"description":"YYYY-MM-DD or days ago (e.g. 30). Locked into the cursor.","schema":{"type":"string"}},{"name":"newest_post_date","in":"query","required":false,"description":"YYYY-MM-DD. Locked into the cursor.","schema":{"type":"string"}},{"name":"exclude_pinned","in":"query","required":false,"description":"Exclude pinned posts when scraping profiles. Locked into the cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Comments","operationId":"post_tiktok_comments","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"mrbeast","description":"TikTok username (@ optional). Required on first call when `manual_video_urls` is not supplied; ignored when `cursor` is supplied."},"manual_video_urls":{"type":"string","format":"uri","description":"TikTok video: full URL, vm.tiktok.com / vt.tiktok.com short link, or numeric video id. Takes precedence over `usernames`. Ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"results_per_profile":{"type":"integer","default":30,"description":"Max videos discovered per profile. Locked into the cursor."},"comments_per_post":{"type":"integer","default":100,"description":"Max top-level comments per video. Video input: empty = walk all comments. Usernames input: default 100 per video. Locked into the cursor."},"max_replies_per_comment":{"type":"integer","default":2,"description":"Max replies fetched per comment (capped at 500; 0 = skip reply threads, fastest). Reply threads are fetched in parallel within a ~5s window per call; threads not fetched in time keep reply_comment_total and are listed in `warning`. Locked into the cursor."},"profile_sections":{"type":"string","default":"videos","description":"Profile section: videos or reposts (first one is used). Locked into the cursor."},"profile_sorting":{"type":"string","default":"latest","description":"Sort: latest, oldest, or popular. Locked into the cursor."},"oldest_post_date":{"type":"string","description":"YYYY-MM-DD or days ago (e.g. 30). Locked into the cursor."},"newest_post_date":{"type":"string","description":"YYYY-MM-DD. Locked into the cursor."},"exclude_pinned":{"type":"boolean","default":false,"description":"Exclude pinned posts when scraping profiles. Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/tiktok-followers-following/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Followers / Following","operationId":"get_tiktok_followers_following","parameters":[{"name":"usernames","in":"query","required":true,"description":"TikTok username (without @). Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"khaby.lame"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"scrape_type","in":"query","required":false,"description":"What to scrape: followers, following, or both. Locked into the cursor.","schema":{"type":"string","default":"both","enum":["followers","following","both"]}},{"name":"sid_tt","in":"query","required":true,"description":"TikTok session cookie (sid_tt) — required by the upstream API. Locked into the cursor.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Fallback per-list cap when `max_followers` / `max_following` are unset. Locked into the cursor.","schema":{"type":"integer","default":10}},{"name":"max_followers","in":"query","required":false,"description":"Optional cap for followers list only. Locked into the cursor.","schema":{"type":"integer"}},{"name":"max_following","in":"query","required":false,"description":"Optional cap for following list only. Locked into the cursor.","schema":{"type":"integer"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Followers / Following","operationId":"post_tiktok_followers_following","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"khaby.lame","description":"TikTok username (without @). Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"scrape_type":{"type":"string","default":"both","enum":["followers","following","both"],"description":"What to scrape: followers, following, or both. Locked into the cursor."},"sid_tt":{"type":"string","description":"TikTok session cookie (sid_tt) — required by the upstream API. Locked into the cursor."},"max_items":{"type":"integer","default":10,"description":"Fallback per-list cap when `max_followers` / `max_following` are unset. Locked into the cursor."},"max_followers":{"type":"integer","description":"Optional cap for followers list only. Locked into the cursor."},"max_following":{"type":"integer","description":"Optional cap for following list only. Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames","sid_tt"]}}}}}},"/tiktok-get-song-details/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Get Song Details","operationId":"get_tiktok_get_song_details","parameters":[{"name":"music_ids","in":"query","required":true,"description":"TikTok sound / song clip id (7439295283975702544 = SZA \"luther\"), a music page URL, a video URL (-> the sound it uses) or a vm./vt. short link. Required on the first call; ignored when `cursor` is supplied. One native TikTok item_list page (up to 30 videos) per call in mode videos; every row carries the sound's music_info block.","schema":{"type":"string","default":"7439295283975702544"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"mode","in":"query","required":false,"description":"videos = one 30-video page per call (native offset cursor); song = single lookup of the sound's own record (one row, next_cursor null). Locked in cursor.","schema":{"type":"string","default":"videos","enum":["videos","song"]}},{"name":"include_song_details","in":"query","required":false,"description":"Attach music_info to every row (re-read from /api/music/detail/ on each page). Forced on in mode song. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"hydrate_song","in":"query","required":false,"description":"Video-page hydration of music_info (full credit line, precise durations, matched-song id). Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"include_artist_profile","in":"query","required":false,"description":"Artist / owner profile pages -> artists[].is_verified + follower counts. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"region","in":"query","required":false,"description":"ISO-2 market sent to the music API (also pins the proxy exit country; default US). Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Get Song Details","operationId":"post_tiktok_get_song_details","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"music_ids":{"type":"string","default":"7439295283975702544","description":"TikTok sound / song clip id (7439295283975702544 = SZA \"luther\"), a music page URL, a video URL (-> the sound it uses) or a vm./vt. short link. Required on the first call; ignored when `cursor` is supplied. One native TikTok item_list page (up to 30 videos) per call in mode videos; every row carries the sound's music_info block."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"mode":{"type":"string","default":"videos","enum":["videos","song"],"description":"videos = one 30-video page per call (native offset cursor); song = single lookup of the sound's own record (one row, next_cursor null). Locked in cursor."},"include_song_details":{"type":"boolean","default":true,"description":"Attach music_info to every row (re-read from /api/music/detail/ on each page). Forced on in mode song. Locked in cursor."},"hydrate_song":{"type":"boolean","default":true,"description":"Video-page hydration of music_info (full credit line, precise durations, matched-song id). Locked in cursor."},"include_artist_profile":{"type":"boolean","default":true,"description":"Artist / owner profile pages -> artists[].is_verified + follower counts. Locked in cursor."},"region":{"type":"string","description":"ISO-2 market sent to the music API (also pins the proxy exit country; default US). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["music_ids"]}}}}}},"/tiktok-hashtag-videos/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Hashtag Videos","operationId":"get_tiktok_hashtag_videos","parameters":[{"name":"hashtags","in":"query","required":true,"description":"Hashtag, with or without # (a tiktok.com/tag/ URL also works). Required on first call; ignored when `cursor` is supplied. One call = one TikTok page (up to 30 videos).","schema":{"type":"string","default":"travel"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Hashtag Videos","operationId":"post_tiktok_hashtag_videos","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"hashtags":{"type":"string","default":"travel","description":"Hashtag, with or without # (a tiktok.com/tag/ URL also works). Required on first call; ignored when `cursor` is supplied. One call = one TikTok page (up to 30 videos)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["hashtags"]}}}}}},"/tiktok-keyword-search/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Keyword Search","operationId":"get_tiktok_keyword_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term. Required first call.","schema":{"type":"string","default":"funny cats"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"date_posted","in":"query","required":false,"description":"today | this-week | this-month | this-year. Locked in cursor.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"relevance | date | views. Locked in cursor.","schema":{"type":"string","default":"relevance"}},{"name":"region","in":"query","required":false,"description":"2-letter country code sent as TikTok search region (default US). Locked in cursor.","schema":{"type":"string"}},{"name":"fill_from_hashtag","in":"query","required":false,"description":"After TikTok's logged-out keyword search ends (~90-130 videos), continue with the #keyword hashtag feed (rows source=hashtag_feed). Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Keyword Search","operationId":"post_tiktok_keyword_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"funny cats","description":"Search term. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"date_posted":{"type":"string","description":"today | this-week | this-month | this-year. Locked in cursor."},"sort_by":{"type":"string","default":"relevance","description":"relevance | date | views. Locked in cursor."},"region":{"type":"string","description":"2-letter country code sent as TikTok search region (default US). Locked in cursor."},"fill_from_hashtag":{"type":"boolean","default":true,"description":"After TikTok's logged-out keyword search ends (~90-130 videos), continue with the #keyword hashtag feed (rows source=hashtag_feed). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/tiktok-live-info/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Live Info","operationId":"get_tiktok_live_info","parameters":[{"name":"room_ids","in":"query","required":true,"description":"TikTok LIVE room_id. Lookup endpoint -- next_cursor null.","schema":{"type":"string","default":"7523685855395842871"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"user_id","in":"query","required":false,"description":"Owner cross-check. Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Live Info","operationId":"post_tiktok_live_info","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"room_ids":{"type":"string","default":"7523685855395842871","description":"TikTok LIVE room_id. Lookup endpoint -- next_cursor null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"user_id":{"type":"string","description":"Owner cross-check. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["room_ids"]}}}}}},"/tiktok-live-search/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok LIVE Search","operationId":"get_tiktok_live_search","parameters":[{"name":"keywords","in":"query","required":true,"description":"Live-stream search keyword. Required first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"gaming"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok LIVE Search","operationId":"post_tiktok_live_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"string","default":"gaming","description":"Live-stream search keyword. Required first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["keywords"]}}}}}},"/tiktok-playlist-videos/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Playlist Videos","operationId":"get_tiktok_playlist_videos","parameters":[{"name":"playlist_ids","in":"query","required":false,"description":"TikTok playlist id or playlist URL -> playlist mode: ONE native /api/mix/item_list/ page (<= 20 videos, under `videos`) per call, paged through TikTok's own offset. Any ONE of playlist_ids / usernames / user_ids on the first call (the first given wins, in that order); ignored when `cursor` is supplied.","schema":{"type":"string","default":"7090570072548461358"}},{"name":"usernames","in":"query","required":false,"description":"TikTok handle / @handle / profile URL -> profile mode: every playlist of the creator, playlist by playlist in TikTok's order. The frozen playlist plan (ids + counts) rides in the cursor, so each call fetches ONE native page and continues into the next playlist without re-walking; next_cursor is null after the last playlist.","schema":{"type":"string"}},{"name":"user_ids","in":"query","required":false,"description":"Numeric TikTok user id -> profile mode (resolved via /share/user/{id}).","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"enrich","in":"query","required":false,"description":"auto = skip the per-video pages (a native page holds up to 30 videos, above the 10-video auto limit; each page costs ~90 KB of proxy traffic); true = open every video's page for location_created, diversification_labels, aigc flags; false = never (fastest). Best-effort inside the call's 70 s budget: if TikTok rate-limits video pages or time runs out, rows still return (enriched=false) with a `warning`. Locked in cursor.","schema":{"type":"string","default":"auto","enum":["auto","true","false"]}},{"name":"strict_owner","in":"query","required":false,"description":"true = playlist URL @handle != real owner -> 404. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"region","in":"query","required":false,"description":"2-letter market region for the signed API calls. Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Playlist Videos","operationId":"post_tiktok_playlist_videos","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"playlist_ids":{"type":"string","default":"7090570072548461358","description":"TikTok playlist id or playlist URL -> playlist mode: ONE native /api/mix/item_list/ page (<= 20 videos, under `videos`) per call, paged through TikTok's own offset. Any ONE of playlist_ids / usernames / user_ids on the first call (the first given wins, in that order); ignored when `cursor` is supplied."},"usernames":{"type":"string","description":"TikTok handle / @handle / profile URL -> profile mode: every playlist of the creator, playlist by playlist in TikTok's order. The frozen playlist plan (ids + counts) rides in the cursor, so each call fetches ONE native page and continues into the next playlist without re-walking; next_cursor is null after the last playlist."},"user_ids":{"type":"string","description":"Numeric TikTok user id -> profile mode (resolved via /share/user/{id})."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"enrich":{"type":"string","default":"auto","enum":["auto","true","false"],"description":"auto = skip the per-video pages (a native page holds up to 30 videos, above the 10-video auto limit; each page costs ~90 KB of proxy traffic); true = open every video's page for location_created, diversification_labels, aigc flags; false = never (fastest). Best-effort inside the call's 70 s budget: if TikTok rate-limits video pages or time runs out, rows still return (enriched=false) with a `warning`. Locked in cursor."},"strict_owner":{"type":"boolean","default":false,"description":"true = playlist URL @handle != real owner -> 404. Locked in cursor."},"region":{"type":"string","default":"US","description":"2-letter market region for the signed API calls. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/tiktok-profile/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Profile Videos","operationId":"get_tiktok_profile","parameters":[{"name":"usernames","in":"query","required":true,"description":"TikTok username (without @). Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"mrbeast"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Profile Videos","operationId":"post_tiktok_profile","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"mrbeast","description":"TikTok username (without @). Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/tiktok-profile-region/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Profile Region","operationId":"get_tiktok_profile_region","parameters":[{"name":"usernames","in":"query","required":true,"description":"TikTok handle or profile URL: \"shakira\", \"@shakira\" or \"https://www.tiktok.com/@shakira\". One profile per call (single lookup, next_cursor is always null).","schema":{"type":"string","default":"shakira"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"videos_to_check","in":"query","required":false,"description":"Newest public videos whose locationCreated vote for the region (0-13, default 5). 0 = author card only, region null.","schema":{"type":"integer","default":5,"minimum":0,"maximum":13}},{"name":"include_videos","in":"query","required":false,"description":"Attach recent_videos (the per-video evidence behind the region vote).","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Profile Region","operationId":"post_tiktok_profile_region","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"shakira","description":"TikTok handle or profile URL: \"shakira\", \"@shakira\" or \"https://www.tiktok.com/@shakira\". One profile per call (single lookup, next_cursor is always null)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"videos_to_check":{"type":"integer","default":5,"minimum":0,"maximum":13,"description":"Newest public videos whose locationCreated vote for the region (0-13, default 5). 0 = author card only, region null."},"include_videos":{"type":"boolean","default":true,"description":"Attach recent_videos (the per-video evidence behind the region vote)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/tiktok-profile-video/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Profile Video","operationId":"get_tiktok_profile_video","parameters":[{"name":"usernames","in":"query","required":true,"description":"TikTok handle (mrbeast / @mrbeast), profile URL or numeric user_id. Page 1 = the profile's newest videos (embed window, pinned first, <= 13); later pages walk the creator's playlists with TikTok's own playlist / item_list cursors (~15-20 per page). Rows under `videos`, each with the flat summary + post / computed / aweme blocks; the envelope (request, author, pagination, meta) is at the top level. Each call is bounded (~60 s budget): a slow upstream returns partial rows + next_cursor + `warning`. next_cursor is null once the guest-reachable pool (embed window + playlists) is exhausted. Required first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"mrbeast"}},{"name":"user_id","in":"query","required":false,"description":"Numeric TikTok user id (resolved via /share/user/{id}); wins over a handle, which is cross-checked.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_cursor","in":"query","required":false,"description":"Optional filter: ms unix time -> only videos created strictly before it are returned (applied to every page). Locked in cursor.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"Compatibility only (no reorder; sort_applied false). Locked in cursor.","schema":{"type":"string","default":"latest","enum":["latest","popular"]}},{"name":"trim","in":"query","required":false,"description":"Compatibility flag, echoed in request. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"complete_schema","in":"query","required":false,"description":"true = full native mobile-API aweme schema (~184 keys); false = web-exposed fields only. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"discovery_limit","in":"query","required":false,"description":"Max playlist videos walked over the whole cursor chain; 0 = embed window only (newest 13, one page). Locked in cursor.","schema":{"type":"integer","default":200000,"minimum":0}},{"name":"enrich","in":"query","required":false,"description":"auto = open the video pages (likes / comments / music / hashtags) of the first 3 page-1 (embed) videos only, the rest carry embed data (views, caption, cover, play URL); true = every page-1 video and also every playlist video; false = never (page 1 then carries embed data only: views, caption, cover, play URL). Locked in cursor.","schema":{"type":"string","default":"auto","enum":["auto","true","false"]}},{"name":"region","in":"query","required":false,"description":"2-letter country code (priority_region / viewer_region; {region} proxy placeholder only if the platform proxy URL has one). Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Profile Video","operationId":"post_tiktok_profile_video","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"mrbeast","description":"TikTok handle (mrbeast / @mrbeast), profile URL or numeric user_id. Page 1 = the profile's newest videos (embed window, pinned first, <= 13); later pages walk the creator's playlists with TikTok's own playlist / item_list cursors (~15-20 per page). Rows under `videos`, each with the flat summary + post / computed / aweme blocks; the envelope (request, author, pagination, meta) is at the top level. Each call is bounded (~60 s budget): a slow upstream returns partial rows + next_cursor + `warning`. next_cursor is null once the guest-reachable pool (embed window + playlists) is exhausted. Required first call; ignored when `cursor` is supplied."},"user_id":{"type":"string","description":"Numeric TikTok user id (resolved via /share/user/{id}); wins over a handle, which is cross-checked."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_cursor":{"type":"string","description":"Optional filter: ms unix time -> only videos created strictly before it are returned (applied to every page). Locked in cursor."},"sort_by":{"type":"string","default":"latest","enum":["latest","popular"],"description":"Compatibility only (no reorder; sort_applied false). Locked in cursor."},"trim":{"type":"boolean","default":false,"description":"Compatibility flag, echoed in request. Locked in cursor."},"complete_schema":{"type":"boolean","default":true,"description":"true = full native mobile-API aweme schema (~184 keys); false = web-exposed fields only. Locked in cursor."},"discovery_limit":{"type":"integer","default":200000,"minimum":0,"description":"Max playlist videos walked over the whole cursor chain; 0 = embed window only (newest 13, one page). Locked in cursor."},"enrich":{"type":"string","default":"auto","enum":["auto","true","false"],"description":"auto = open the video pages (likes / comments / music / hashtags) of the first 3 page-1 (embed) videos only, the rest carry embed data (views, caption, cover, play URL); true = every page-1 video and also every playlist video; false = never (page 1 then carries embed data only: views, caption, cover, play URL). Locked in cursor."},"region":{"type":"string","default":"US","description":"2-letter country code (priority_region / viewer_region; {region} proxy placeholder only if the platform proxy URL has one). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/tiktok-search-suggestions/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Search Suggestions","operationId":"get_tiktok_search_suggestions","parameters":[{"name":"queries","in":"query","required":true,"description":"Partial search term typed into TikTok's search box -> its whole autocomplete list (<= 20 rows, TikTok's rank order) under `suggestions` in ONE guest request. The source has no paging token, so next_cursor is always null.","schema":{"type":"string","default":"dogs"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"ISO 3166-1 alpha-2 country to localise the list (default us): carrier / system region + that market's UI language; US -> TikTok's US datacenter host first. Echoed on the envelope; pins the proxy exit country. Locked in cursor.","schema":{"type":"string","default":"us"}},{"name":"language","in":"query","required":false,"description":"UI language override layered on top of region, e.g. pt-BR. Blank = the market's default. Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Search Suggestions","operationId":"post_tiktok_search_suggestions","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"dogs","description":"Partial search term typed into TikTok's search box -> its whole autocomplete list (<= 20 rows, TikTok's rank order) under `suggestions` in ONE guest request. The source has no paging token, so next_cursor is always null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"region":{"type":"string","default":"us","description":"ISO 3166-1 alpha-2 country to localise the list (default us): carrier / system region + that market's UI language; US -> TikTok's US datacenter host first. Echoed on the envelope; pins the proxy exit country. Locked in cursor."},"language":{"type":"string","description":"UI language override layered on top of region, e.g. pt-BR. Blank = the market's default. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/tiktok-search-users/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Search Users","operationId":"get_tiktok_search_users","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword -> the accounts TikTok's user search returns (guest). One native page (10 accounts) per call. Required first call, ignored when `cursor` is supplied.","schema":{"type":"string","default":"cooking"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include","in":"query","required":false,"description":"'profile' hydrates every row of the page (bio, ISO region, bio_link, business_category, following / video counts). Locked in cursor.","schema":{"type":"string","enum":["","profile"]}},{"name":"country","in":"query","required":false,"description":"ISO 3166-1 alpha-2: only accounts whose public region matches; the page then holds up to max_items (1..20, default 8) in-country accounts, region-checking up to country_scan_limit (10..60, default 20) candidates per call. Locked in cursor.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Country mode only: in-country page size (1..20, default 8). Ignored otherwise (the search API serves 10 per page). Locked in cursor.","schema":{"type":"integer","default":8,"minimum":1,"maximum":20}},{"name":"region","in":"query","required":false,"description":"Search market (ISO-2) sent to TikTok. Default: country, else US. Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"trim","in":"query","required":false,"description":"true drops the always-null wrappers around each native user_info row. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"country_scan_limit","in":"query","required":false,"description":"Country mode: candidates region-checked per call. Locked in cursor.","schema":{"type":"integer","default":20,"minimum":10,"maximum":60}},{"name":"region_samples","in":"query","required":false,"description":"Newest videos checked per account for the region vote. Locked in cursor.","schema":{"type":"integer","default":2,"minimum":1,"maximum":5}},{"name":"hydrate_passes","in":"query","required":false,"description":"Retry passes for rows left incomplete by transient rate limits. Locked in cursor.","schema":{"type":"integer","default":3,"minimum":1,"maximum":6}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Search Users","operationId":"post_tiktok_search_users","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"cooking","description":"Search keyword -> the accounts TikTok's user search returns (guest). One native page (10 accounts) per call. Required first call, ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include":{"type":"string","enum":["","profile"],"description":"'profile' hydrates every row of the page (bio, ISO region, bio_link, business_category, following / video counts). Locked in cursor."},"country":{"type":"string","description":"ISO 3166-1 alpha-2: only accounts whose public region matches; the page then holds up to max_items (1..20, default 8) in-country accounts, region-checking up to country_scan_limit (10..60, default 20) candidates per call. Locked in cursor."},"max_items":{"type":"integer","default":8,"minimum":1,"maximum":20,"description":"Country mode only: in-country page size (1..20, default 8). Ignored otherwise (the search API serves 10 per page). Locked in cursor."},"region":{"type":"string","default":"US","description":"Search market (ISO-2) sent to TikTok. Default: country, else US. Locked in cursor."},"trim":{"type":"boolean","default":false,"description":"true drops the always-null wrappers around each native user_info row. Locked in cursor."},"country_scan_limit":{"type":"integer","default":20,"minimum":10,"maximum":60,"description":"Country mode: candidates region-checked per call. Locked in cursor."},"region_samples":{"type":"integer","default":2,"minimum":1,"maximum":5,"description":"Newest videos checked per account for the region vote. Locked in cursor."},"hydrate_passes":{"type":"integer","default":3,"minimum":1,"maximum":6,"description":"Retry passes for rows left incomplete by transient rate limits. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/tiktok-shop-data-scraper/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Shop Data Scraper","operationId":"get_tiktok_shop_data_scraper","parameters":[{"name":"queries","in":"query","required":false,"description":"TikTok Shop product search keyword (keyword mode). Required first call unless a url is given. Aliases: searchKeywords, query, q.","schema":{"type":"string","default":"shoes"}},{"name":"urls","in":"query","required":false,"description":"Product /pdp/, category /c/, or seller /store/ URL (URL mode — takes precedence over queries). Aliases: startUrls.","schema":{"type":"string","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_reviews","in":"query","required":false,"description":"Fetch embedded product reviews. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"max_details","in":"query","required":false,"description":"Products per call that get the full product-page enrichment (creators, stock, reviews); the rest are returned from listing data (source=\"listing\"). Each enriched product costs ~65 KB of proxy traffic. 0 = listing only; raise (e.g. 100) to enrich everything. Defaults to all when include_reviews is true.","schema":{"type":"integer","default":4}},{"name":"max_reviews","in":"query","required":false,"description":"Max reviews per product (1-100). Locked in cursor.","schema":{"type":"integer","default":10}},{"name":"sort_by_sold_count","in":"query","required":false,"description":"none | highest_first | lowest_first. Locked in cursor.","schema":{"type":"string","default":"none","enum":["none","highest_first","lowest_first"]}},{"name":"use_proxy","in":"query","required":false,"description":"Route through the platform proxy forced to a US exit (TikTok Shop is US region-locked). Falls back to a direct connection with a `warning` if the proxy is unavailable. One upstream page (~20 products) per call.","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Shop Data Scraper","operationId":"post_tiktok_shop_data_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"shoes","description":"TikTok Shop product search keyword (keyword mode). Required first call unless a url is given. Aliases: searchKeywords, query, q."},"urls":{"type":"string","format":"uri","description":"Product /pdp/, category /c/, or seller /store/ URL (URL mode — takes precedence over queries). Aliases: startUrls."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_reviews":{"type":"boolean","default":false,"description":"Fetch embedded product reviews. Locked in cursor."},"max_details":{"type":"integer","default":4,"description":"Products per call that get the full product-page enrichment (creators, stock, reviews); the rest are returned from listing data (source=\"listing\"). Each enriched product costs ~65 KB of proxy traffic. 0 = listing only; raise (e.g. 100) to enrich everything. Defaults to all when include_reviews is true."},"max_reviews":{"type":"integer","default":10,"description":"Max reviews per product (1-100). Locked in cursor."},"sort_by_sold_count":{"type":"string","default":"none","enum":["none","highest_first","lowest_first"],"description":"none | highest_first | lowest_first. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Route through the platform proxy forced to a US exit (TikTok Shop is US region-locked). Falls back to a direct connection with a `warning` if the proxy is unavailable. One upstream page (~20 products) per call."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/tiktok-shop-product-review/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Shop Product Review","operationId":"get_tiktok_shop_product_review","parameters":[{"name":"urls","in":"query","required":true,"description":"TikTok Shop PDP URL. Single lookup -- next_cursor null (browser-signed pagination runs inside one session per call; see module docs).","schema":{"type":"string","default":"https://www.tiktok.com/shop/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"max_items","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":30}},{"name":"browser_pagination","in":"query","required":false,"description":"Locked in cursor. false (default) = SSR first page only; true opts into heavy browser pagination.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Shop Product Review","operationId":"post_tiktok_shop_product_review","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.tiktok.com/shop/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516","format":"uri","description":"TikTok Shop PDP URL. Single lookup -- next_cursor null (browser-signed pagination runs inside one session per call; see module docs)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"region":{"type":"string","default":"US","description":"Locked in cursor."},"max_items":{"type":"integer","default":30,"description":"Locked in cursor."},"browser_pagination":{"type":"boolean","default":false,"description":"Locked in cursor. false (default) = SSR first page only; true opts into heavy browser pagination."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/tiktok-shop-search/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Shop Search via EchoTik","operationId":"get_tiktok_shop_search","parameters":[{"name":"queries","in":"query","required":true,"description":"TikTok Shop product search keyword via EchoTik. Required first call. Aliases: keyword, q.","schema":{"type":"string","default":"cloth"}},{"name":"country_code","in":"query","required":true,"description":"Target market. Locked in cursor.","schema":{"type":"string","default":"US","enum":["US","VN","TH","PH","MY","ID","GB","SG","ES","MX","DE","IT","FR","BR","JP"]}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"order","in":"query","required":false,"description":"EchoTik sort key. Locked in cursor.","schema":{"type":"string","default":"total_sale_nd_cnt"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Shop Search via EchoTik","operationId":"post_tiktok_shop_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"cloth","description":"TikTok Shop product search keyword via EchoTik. Required first call. Aliases: keyword, q."},"country_code":{"type":"string","default":"US","enum":["US","VN","TH","PH","MY","ID","GB","SG","ES","MX","DE","IT","FR","BR","JP"],"description":"Target market. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"order":{"type":"string","default":"total_sale_nd_cnt","description":"EchoTik sort key. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries","country_code"]}}}}}},"/tiktok-single-video-info/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Single Video Info","operationId":"get_tiktok_single_video_info","parameters":[{"name":"urls","in":"query","required":true,"description":"TikTok video / photo URL, vm./vt./tiktok.com/t/ short link, legacy m.tiktok.com/v/<id>.html or bare 19-digit id. Single lookup: the full record is returned under `video`, next_cursor is always null.","schema":{"type":"string","default":"https://www.tiktok.com/@scout2015/video/6718335390845095173"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_transcript","in":"query","required":false,"description":"Fetch + parse the WebVTT caption track (`transcript` text + `transcript_info`).","schema":{"type":"boolean","default":true}},{"name":"include_media_urls","in":"query","required":false,"description":"Attach `download_media_urls` (no-watermark mp4 / watermarked mp4 / carousel images as CDN URLs with the `fetch_headers` to download them).","schema":{"type":"boolean","default":true}},{"name":"trim","in":"query","required":false,"description":"true = condensed aweme_detail instead of the full 188-key record.","schema":{"type":"boolean","default":false}},{"name":"complete_schema","in":"query","required":false,"description":"Pad aweme_detail to the full native mobile-API schema.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Single Video Info","operationId":"post_tiktok_single_video_info","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.tiktok.com/@scout2015/video/6718335390845095173","description":"TikTok video / photo URL, vm./vt./tiktok.com/t/ short link, legacy m.tiktok.com/v/<id>.html or bare 19-digit id. Single lookup: the full record is returned under `video`, next_cursor is always null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_transcript":{"type":"boolean","default":true,"description":"Fetch + parse the WebVTT caption track (`transcript` text + `transcript_info`)."},"include_media_urls":{"type":"boolean","default":true,"description":"Attach `download_media_urls` (no-watermark mp4 / watermarked mp4 / carousel images as CDN URLs with the `fetch_headers` to download them)."},"trim":{"type":"boolean","default":false,"description":"true = condensed aweme_detail instead of the full 188-key record."},"complete_schema":{"type":"boolean","default":true,"description":"Pad aweme_detail to the full native mobile-API schema."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/tiktok-top-search/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Top Search","operationId":"get_tiktok_top_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword for the TikTok search Top tab (videos + photo carousels). One keyword per call; required first call, ignored when `cursor` is supplied. One native TikTok page (~30 rows) per call; next_cursor null when TikTok has no more (guest Top search is shallow: ~60-100 rows per keyword).","schema":{"type":"string","default":"dance challenge"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"publish_time","in":"query","required":false,"description":"Upload-date filter (raw 0/1/7/30/90/180 accepted). Locked in cursor.","schema":{"type":"string","default":"all-time","enum":["all-time","yesterday","this-week","this-month","last-3-months","last-6-months"]}},{"name":"sort_by","in":"query","required":false,"description":"Ranking (raw 0/1/3 accepted). Locked in cursor.","schema":{"type":"string","default":"relevance","enum":["relevance","most-liked","date-posted"]}},{"name":"region","in":"query","required":false,"description":"ISO-2 search market sent to TikTok and, through the platform proxy, the exit country (default US). Does NOT filter rows - use filter_region. Locked in cursor.","schema":{"type":"string"}},{"name":"include_region","in":"query","required":false,"description":"true = load the video page of each row (~90 KB proxy traffic each) for post.ext.region (+ CDN mirrors, subtitles). Default false: fast, region null. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"filter_region","in":"query","required":false,"description":"Client-side ISO-2 filter on post.ext.region (forces include_region). A page can be empty with a non-null next_cursor - keep following it. Locked in cursor.","schema":{"type":"string"}},{"name":"count","in":"query","required":false,"description":"TikTok page size 1..50 (default 30). Locked in cursor.","schema":{"type":"integer","default":30,"minimum":1,"maximum":50}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Top Search","operationId":"post_tiktok_top_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"dance challenge","description":"Search keyword for the TikTok search Top tab (videos + photo carousels). One keyword per call; required first call, ignored when `cursor` is supplied. One native TikTok page (~30 rows) per call; next_cursor null when TikTok has no more (guest Top search is shallow: ~60-100 rows per keyword)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"publish_time":{"type":"string","default":"all-time","enum":["all-time","yesterday","this-week","this-month","last-3-months","last-6-months"],"description":"Upload-date filter (raw 0/1/7/30/90/180 accepted). Locked in cursor."},"sort_by":{"type":"string","default":"relevance","enum":["relevance","most-liked","date-posted"],"description":"Ranking (raw 0/1/3 accepted). Locked in cursor."},"region":{"type":"string","description":"ISO-2 search market sent to TikTok and, through the platform proxy, the exit country (default US). Does NOT filter rows - use filter_region. Locked in cursor."},"include_region":{"type":"boolean","default":false,"description":"true = load the video page of each row (~90 KB proxy traffic each) for post.ext.region (+ CDN mirrors, subtitles). Default false: fast, region null. Locked in cursor."},"filter_region":{"type":"string","description":"Client-side ISO-2 filter on post.ext.region (forces include_region). A page can be empty with a non-null next_cursor - keep following it. Locked in cursor."},"count":{"type":"integer","default":30,"minimum":1,"maximum":50,"description":"TikTok page size 1..50 (default 30). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/tiktok-transcript/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Transcript","operationId":"get_tiktok_transcript","parameters":[{"name":"urls","in":"query","required":true,"description":"TikTok video / photo URL, vm./vt./tiktok.com/t/ short link, legacy m.tiktok.com/v/<id>.html or bare 19-digit id. Single lookup: the full record (transcript text + VTT + segments, every caption track inline, moments, post metadata) is returned under `transcript`, next_cursor is always null.","schema":{"type":"string","default":"https://www.tiktok.com/@natgeo/video/7683891628230315295"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"2-letter code of the transcript wanted; falls back to the original-language track. en on a non-English video without captions is translated by Whisper. Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"use_ai_as_fallback","in":"query","required":false,"description":"faster-whisper transcription for videos WITHOUT caption tracks. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"ai_max_duration_seconds","in":"query","required":false,"description":"Longest video the AI fallback transcribes on v2: default 60, hard cap 90 (sync web thread; v1 allows 120 / unlimited). Longer videos without captions return transcript null + transcript_reason. Locked in cursor.","schema":{"type":"integer","default":60,"minimum":1,"maximum":90}},{"name":"transcribe_all","in":"query","required":false,"description":"AI-transcribe even when captions exist (captions still returned). Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"moments","in":"query","required":false,"description":"true/all, false, or a CSV of moment kinds located on the transcript timeline. Locked in cursor.","schema":{"type":"string","default":"true","enum":["true","false","brand","sponsor_read","product_demo","call_to_action"]}},{"name":"brand","in":"query","required":false,"description":"Brand / product name for the `brand` moment kind. Locked in cursor.","schema":{"type":"string"}},{"name":"whisper_model","in":"query","required":false,"description":"faster-whisper size for the AI path (base pre-warmed). Locked in cursor.","schema":{"type":"string","default":"base","enum":["tiny","base","small"]}},{"name":"whisper_device","in":"query","required":false,"description":"Inference device for faster-whisper. Locked in cursor.","schema":{"type":"string","default":"cpu","enum":["cpu","auto","cuda"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Transcript","operationId":"post_tiktok_transcript","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.tiktok.com/@natgeo/video/7683891628230315295","description":"TikTok video / photo URL, vm./vt./tiktok.com/t/ short link, legacy m.tiktok.com/v/<id>.html or bare 19-digit id. Single lookup: the full record (transcript text + VTT + segments, every caption track inline, moments, post metadata) is returned under `transcript`, next_cursor is always null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"language":{"type":"string","default":"en","description":"2-letter code of the transcript wanted; falls back to the original-language track. en on a non-English video without captions is translated by Whisper. Locked in cursor."},"use_ai_as_fallback":{"type":"boolean","default":true,"description":"faster-whisper transcription for videos WITHOUT caption tracks. Locked in cursor."},"ai_max_duration_seconds":{"type":"integer","default":60,"minimum":1,"maximum":90,"description":"Longest video the AI fallback transcribes on v2: default 60, hard cap 90 (sync web thread; v1 allows 120 / unlimited). Longer videos without captions return transcript null + transcript_reason. Locked in cursor."},"transcribe_all":{"type":"boolean","default":false,"description":"AI-transcribe even when captions exist (captions still returned). Locked in cursor."},"moments":{"type":"string","default":"true","enum":["true","false","brand","sponsor_read","product_demo","call_to_action"],"description":"true/all, false, or a CSV of moment kinds located on the transcript timeline. Locked in cursor."},"brand":{"type":"string","description":"Brand / product name for the `brand` moment kind. Locked in cursor."},"whisper_model":{"type":"string","default":"base","enum":["tiny","base","small"],"description":"faster-whisper size for the AI path (base pre-warmed). Locked in cursor."},"whisper_device":{"type":"string","default":"cpu","enum":["cpu","auto","cuda"],"description":"Inference device for faster-whisper. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/tiktok-trending-creators/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Trending Creators","operationId":"get_tiktok_trending_creators","parameters":[{"name":"country","in":"query","required":true,"description":"Country code (e.g. FR, US). Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"FR"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"Sort: popularity, follower, or engagement. Locked into the cursor.","schema":{"type":"string","default":"popularity","enum":["popularity","follower","engagement"]}},{"name":"follower_range","in":"query","required":false,"description":"Filter: 10k-100k, 100k-1m, 1m-10m, >10m (empty = no filter). Locked into the cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Trending Creators","operationId":"post_tiktok_trending_creators","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","default":"FR","description":"Country code (e.g. FR, US). Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","default":"popularity","enum":["popularity","follower","engagement"],"description":"Sort: popularity, follower, or engagement. Locked into the cursor."},"follower_range":{"type":"string","description":"Filter: 10k-100k, 100k-1m, 1m-10m, >10m (empty = no filter). Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["country"]}}}}}},"/tiktok-trending-hashtag/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Trending Hashtag","operationId":"get_tiktok_trending_hashtag","parameters":[{"name":"country","in":"query","required":false,"description":"TikTok ranking country. One country per request; defaults to US.","schema":{"type":"string","default":"US","enum":["US","FR","DE","IT","ES","GB","AR","AU","BR","CA","CO","EG","ID","IL","JP","KR","MY","MX","PH","SA","SG","ZA","TW","TH","TR","AE","VN"]}},{"name":"period","in":"query","required":false,"description":"Ranking window in days. Legacy 120 maps to 90.","schema":{"type":"integer","default":30,"enum":[7,30,90,120]}},{"name":"result_type","in":"query","required":false,"description":"top100 is ranking-only. Analytics modes add trend and optional challenge metrics; anonymous source does not guarantee 100 results.","schema":{"type":"string","default":"top100","enum":["top100","top100_with_analytics","hashtag_analytics"]}},{"name":"industry_id","in":"query","required":false,"description":"Optional top-level TikTok industry ID. Restricts the feed to that industry.","schema":{"type":"string"}},{"name":"include_industries","in":"query","required":false,"description":"Expand overall ranking with industry rankings. Rank remains relative to each industry; more requests.","schema":{"type":"boolean","default":false}},{"name":"related_videos_source","in":"query","required":false,"description":"Optional TikWM third-party related videos in analytics modes. Adds requests; no cookies.","schema":{"type":"string","default":"none","enum":["none","tikwm"]}},{"name":"related_items_limit","in":"query","required":false,"description":"Related videos per hashtag when TikWM is enabled. Deadline may return fewer with a warning.","schema":{"type":"integer","default":3,"minimum":0,"maximum":100}},{"name":"related_items_cursor","in":"query","required":false,"description":"Optional TikWM starting cursor for related videos.","schema":{"type":"integer","default":0,"minimum":0}},{"name":"use_proxy","in":"query","required":false,"description":"Use the server-injected proxy for every upstream request. Defaults to true.","schema":{"type":"boolean","default":true}},{"name":"cursor","in":"query","required":false,"description":"Opaque continuation token. Cursor-only calls preserve country, window, industry, and analytics options.","schema":{"type":"string"}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Trending Hashtag","operationId":"post_tiktok_trending_hashtag","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","default":"US","enum":["US","FR","DE","IT","ES","GB","AR","AU","BR","CA","CO","EG","ID","IL","JP","KR","MY","MX","PH","SA","SG","ZA","TW","TH","TR","AE","VN"],"description":"TikTok ranking country. One country per request; defaults to US."},"period":{"type":"integer","default":30,"enum":[7,30,90,120],"description":"Ranking window in days. Legacy 120 maps to 90."},"result_type":{"type":"string","default":"top100","enum":["top100","top100_with_analytics","hashtag_analytics"],"description":"top100 is ranking-only. Analytics modes add trend and optional challenge metrics; anonymous source does not guarantee 100 results."},"industry_id":{"type":"string","description":"Optional top-level TikTok industry ID. Restricts the feed to that industry."},"include_industries":{"type":"boolean","default":false,"description":"Expand overall ranking with industry rankings. Rank remains relative to each industry; more requests."},"related_videos_source":{"type":"string","default":"none","enum":["none","tikwm"],"description":"Optional TikWM third-party related videos in analytics modes. Adds requests; no cookies."},"related_items_limit":{"type":"integer","default":3,"minimum":0,"maximum":100,"description":"Related videos per hashtag when TikWM is enabled. Deadline may return fewer with a warning."},"related_items_cursor":{"type":"integer","default":0,"minimum":0,"description":"Optional TikWM starting cursor for related videos."},"use_proxy":{"type":"boolean","default":true,"description":"Use the server-injected proxy for every upstream request. Defaults to true."},"cursor":{"type":"string","description":"Opaque continuation token. Cursor-only calls preserve country, window, industry, and analytics options."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/tiktok-trending-videos/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Trending Videos","operationId":"get_tiktok_trending_videos","parameters":[{"name":"country_code","in":"query","required":true,"description":"Country: US, JP, VN, TH or ID (the countries TikTok Creative Center ranks videos for). Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"US","enum":["US","JP","VN","TH","ID"]}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"Ranking metric: hot/views (video views), engagement (alias like/share/comment), six_second_views. Locked into the cursor.","schema":{"type":"string","default":"hot","enum":["hot","views","engagement","six_second_views","view","like","share","comment"]}},{"name":"period","in":"query","required":false,"description":"7 (videos created in last 7 days), 30 (last 30 days), weekly, monthly. Deeper pages walk older ranking windows. Locked into the cursor.","schema":{"type":"string","default":"7","enum":["7","30","weekly","monthly"]}},{"name":"content_tag","in":"query","required":false,"description":"Optional content filter (comma-separated): beauty, fashion, food, lifestyle, tech. Empty = all. Locked into the cursor.","schema":{"type":"string"}},{"name":"organic_only","in":"query","required":false,"description":"Only organic (non-promoted) videos. Locked into the cursor.","schema":{"type":"boolean","default":false}},{"name":"page_size","in":"query","required":false,"description":"Videos per page (1-100). Locked into the cursor.","schema":{"type":"integer","default":25}},{"name":"include_details","in":"query","required":false,"description":"true = add tiktok.com stats (likes, shares, comments, saves, plays, duration) per video, fetched in parallel within the call ~24 s budget; a video whose stats miss the budget is still returned with stats null and stats_pending=true (Creative Center views/engagement always present). false = listing only (~3-5 s). Locked into the cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Trending Videos","operationId":"post_tiktok_trending_videos","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"country_code":{"type":"string","default":"US","enum":["US","JP","VN","TH","ID"],"description":"Country: US, JP, VN, TH or ID (the countries TikTok Creative Center ranks videos for). Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","default":"hot","enum":["hot","views","engagement","six_second_views","view","like","share","comment"],"description":"Ranking metric: hot/views (video views), engagement (alias like/share/comment), six_second_views. Locked into the cursor."},"period":{"type":"string","default":"7","enum":["7","30","weekly","monthly"],"description":"7 (videos created in last 7 days), 30 (last 30 days), weekly, monthly. Deeper pages walk older ranking windows. Locked into the cursor."},"content_tag":{"type":"string","description":"Optional content filter (comma-separated): beauty, fashion, food, lifestyle, tech. Empty = all. Locked into the cursor."},"organic_only":{"type":"boolean","default":false,"description":"Only organic (non-promoted) videos. Locked into the cursor."},"page_size":{"type":"integer","default":25,"description":"Videos per page (1-100). Locked into the cursor."},"include_details":{"type":"boolean","default":false,"description":"true = add tiktok.com stats (likes, shares, comments, saves, plays, duration) per video, fetched in parallel within the call ~24 s budget; a video whose stats miss the budget is still returned with stats null and stats_pending=true (Creative Center views/engagement always present). false = listing only (~3-5 s). Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["country_code"]}}}}}},"/tiktok-user-liked/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok User Liked","operationId":"get_tiktok_user_liked","parameters":[{"name":"usernames","in":"query","required":true,"description":"TikTok username (chipotle / @chipotle), profile URL or numeric user id -> the videos this account has LIKED, newest like first: ONE native /api/favorite/item_list/ page (30 liked videos, under `items`) per call, paged through TikTok's own like-time cursor (+ the boundary ids it repeats, so pages never overlap). Required on the first call; ignored when `cursor` is supplied. Hidden / private liked list -> 404 \"likes are private\"; unknown handle -> 404; TikTok refusing every attempt -> 502.","schema":{"type":"string","default":"chipotle"}},{"name":"user_ids","in":"query","required":false,"description":"Numeric TikTok user id (6646487634225135622), resolved via /share/user/{id}.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"enrich_pages","in":"query","required":false,"description":"false (default) = liked-list values only (fastest); true = one video page load per liked video (precise duration, region, TikTok labels, pinned flag; best effort inside the call deadline, ~10-20 s slower); N = only the first N rows of each page. Locked in cursor.","schema":{"type":"string","default":"false"}},{"name":"region","in":"query","required":false,"description":"ISO-2 market for the signed API calls (default: the page's region, else US); pins the proxy exit country. Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok User Liked","operationId":"post_tiktok_user_liked","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"chipotle","description":"TikTok username (chipotle / @chipotle), profile URL or numeric user id -> the videos this account has LIKED, newest like first: ONE native /api/favorite/item_list/ page (30 liked videos, under `items`) per call, paged through TikTok's own like-time cursor (+ the boundary ids it repeats, so pages never overlap). Required on the first call; ignored when `cursor` is supplied. Hidden / private liked list -> 404 \"likes are private\"; unknown handle -> 404; TikTok refusing every attempt -> 502."},"user_ids":{"type":"string","description":"Numeric TikTok user id (6646487634225135622), resolved via /share/user/{id}."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"enrich_pages":{"type":"string","default":"false","description":"false (default) = liked-list values only (fastest); true = one video page load per liked video (precise duration, region, TikTok labels, pinned flag; best effort inside the call deadline, ~10-20 s slower); N = only the first N rows of each page. Locked in cursor."},"region":{"type":"string","description":"ISO-2 market for the signed API calls (default: the page's region, else US); pins the proxy exit country. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/tiktok-users-audience-demographics/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 3 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Users Audience Demographics","operationId":"get_tiktok_users_audience_demographics","parameters":[{"name":"usernames","in":"query","required":true,"description":"TikTok handle or profile URL: \"shakira\", \"@shakira\" or \"https://www.tiktok.com/@shakira\". One profile per call (single lookup, next_cursor is always null).","schema":{"type":"string","default":"shakira"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sample_size","in":"query","required":false,"description":"Recent followers to sample (default 40). v2 runs synchronously, so it is CAPPED at 40 here and the whole lookup has a 40s deadline: if it runs out, the followers located so far are returned with status \"partial\" + a `warning`. Use v1 (async) for up to 500 (richer sample).","schema":{"type":"integer","default":40,"minimum":1,"maximum":40}},{"name":"sample_spread_hours","in":"query","required":false,"description":"Spread the sample over the last N hours of follows; 0 = most recent followers first.","schema":{"type":"integer","default":12,"minimum":0,"maximum":48}},{"name":"videos_per_follower","in":"query","required":false,"description":"Latest public videos checked per follower (1-5); >1 = majority vote. Multiplies runtime.","schema":{"type":"integer","default":1,"minimum":1,"maximum":5}},{"name":"max_countries","in":"query","required":false,"description":"Cap the audience_locations rows (sorted by count desc). Empty = all.","schema":{"type":"integer"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 3 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikTok Users Audience Demographics","operationId":"post_tiktok_users_audience_demographics","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"shakira","description":"TikTok handle or profile URL: \"shakira\", \"@shakira\" or \"https://www.tiktok.com/@shakira\". One profile per call (single lookup, next_cursor is always null)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sample_size":{"type":"integer","default":40,"minimum":1,"maximum":40,"description":"Recent followers to sample (default 40). v2 runs synchronously, so it is CAPPED at 40 here and the whole lookup has a 40s deadline: if it runs out, the followers located so far are returned with status \"partial\" + a `warning`. Use v1 (async) for up to 500 (richer sample)."},"sample_spread_hours":{"type":"integer","default":12,"minimum":0,"maximum":48,"description":"Spread the sample over the last N hours of follows; 0 = most recent followers first."},"videos_per_follower":{"type":"integer","default":1,"minimum":1,"maximum":5,"description":"Latest public videos checked per follower (1-5); >1 = majority vote. Multiplies runtime."},"max_countries":{"type":"integer","description":"Cap the audience_locations rows (sorted by count desc). Empty = all."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/tiktoks-by-song/":{"get":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikToks by Song","operationId":"get_tiktoks_by_song","parameters":[{"name":"clip_ids","in":"query","required":true,"description":"TikTok sound / song clip id (7439295283975702544 = SZA \"luther\") or a music page URL -> ONE native TikTok page per call: the 12 videos of TikTok's \"popular\" order at the cursor's offset (page 1 also carries the artist-pinned video in front = 13 rows), each with the full native aweme + the sound block. Alternatively ONE video URL / vm./vt. short link -> single-video lookup (one row, next_cursor null). Required on the first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"7439295283975702544"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"enrich_pages","in":"query","required":false,"description":"true = one video page load (~100 KB) per listed video -> region, precise durations, captions, stickers, diversification labels (default false = faster). Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"include_artist_video","in":"query","required":false,"description":"Page 1 only: the newest post of a credited artist that uses the sound in front (is_pinned_by_artist); never repeated on later pages. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"include_artist_profile","in":"query","required":false,"description":"Artist / owner profile pages -> verified flag + follower counts in the sound block. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"region","in":"query","required":false,"description":"ISO-2 market sent to the music API (also pins the proxy exit country; default US). Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["tiktok"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TikToks by Song","operationId":"post_tiktoks_by_song","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"clip_ids":{"type":"string","default":"7439295283975702544","description":"TikTok sound / song clip id (7439295283975702544 = SZA \"luther\") or a music page URL -> ONE native TikTok page per call: the 12 videos of TikTok's \"popular\" order at the cursor's offset (page 1 also carries the artist-pinned video in front = 13 rows), each with the full native aweme + the sound block. Alternatively ONE video URL / vm./vt. short link -> single-video lookup (one row, next_cursor null). Required on the first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"enrich_pages":{"type":"boolean","default":false,"description":"true = one video page load (~100 KB) per listed video -> region, precise durations, captions, stickers, diversification labels (default false = faster). Locked in cursor."},"include_artist_video":{"type":"boolean","default":true,"description":"Page 1 only: the newest post of a credited artist that uses the sound in front (is_pinned_by_artist); never repeated on later pages. Locked in cursor."},"include_artist_profile":{"type":"boolean","default":true,"description":"Artist / owner profile pages -> verified flag + follower counts in the sound block. Locked in cursor."},"region":{"type":"string","description":"ISO-2 market sent to the music API (also pins the proxy exit country; default US). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["clip_ids"]}}}}}},"/truth-social-posts/":{"get":{"tags":["truth social"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Truth Social Posts","operationId":"get_truth_social_posts","parameters":[{"name":"usernames","in":"query","required":true,"description":"Truth Social username, with or without leading \"@\". Required first call.","schema":{"type":"string","default":"realDonaldTrump"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["truth social"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Truth Social Posts","operationId":"post_truth_social_posts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"realDonaldTrump","description":"Truth Social username, with or without leading \"@\". Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/truth-social-profile-scraper/":{"get":{"tags":["truth social"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Truth Social Profile Info","operationId":"get_truth_social_profile_scraper","parameters":[{"name":"handles","in":"query","required":true,"description":"Truth Social handle. Lookup endpoint -- next_cursor null.","schema":{"type":"string","default":"realDonaldTrump"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["truth social"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Truth Social Profile Info","operationId":"post_truth_social_profile_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"handles":{"type":"string","default":"realDonaldTrump","description":"Truth Social handle. Lookup endpoint -- next_cursor null."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["handles"]}}}}}},"/truth-social-single-post/":{"get":{"tags":["truth social"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Truth Social Single Post","operationId":"get_truth_social_single_post","parameters":[{"name":"urls","in":"query","required":true,"description":"Truth Social post URL or bare status id. Lookup endpoint -- next_cursor null.","schema":{"type":"string","default":"https://truthsocial.com/@realDonaldTrump/posts/117312693997244079","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["truth social"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Truth Social Single Post","operationId":"post_truth_social_single_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://truthsocial.com/@realDonaldTrump/posts/117312693997244079","format":"uri","description":"Truth Social post URL or bare status id. Lookup endpoint -- next_cursor null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/truthsocial-profile-info/":{"get":{"tags":["truth social"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TruthSocial Profile Info","operationId":"get_truthsocial_profile_info","parameters":[{"name":"handles","in":"query","required":true,"description":"The Truth Social account: \"realDonaldTrump\", \"@realDonaldTrump\", a profile URL (https://truthsocial.com/@realDonaldTrump, a /<status id> tail or the /users/<name> form is fine) or realDonaldTrump@truthsocial.com; case does not matter -> ONE profile record: the public Account entity verbatim (id, username, display_name, note / bio, avatar / header, followers_count, following_count, statuses_count, created_at, verified, premium, website ...), likes_count (likes received) and computed{engagement_rate, language, content_category}. Single lookup: next_cursor is always null. An unknown / suspended / moved account answers a status record (not_found | account_suspended | moved | invalid_input) + status_note.","schema":{"type":"string","default":"realDonaldTrump"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"compute_metrics","in":"query","required":false,"description":"true (default) = sample the latest `feed_sample` original truths for computed.language / engagement_rate / content_category. false = profile only (1 request; engagement_rate / language null, category from the bio). Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"feed_sample","in":"query","required":false,"description":"Original truths sampled for the computed block (1..100, default 20 = one statuses page). Locked in cursor.","schema":{"type":"integer","default":20,"minimum":1,"maximum":100}},{"name":"count_likes","in":"query","required":false,"description":"true (default) = walk the status history (~20 a call) and sum favourites_count -> likes_count (likes received). false = likes_count null. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"likes_max_posts","in":"query","required":false,"description":"Cap on the likes walk in statuses seen (default 100 = 5 pages). v2 CAP 600 (30 pages, ~20 s proxied) plus a 60 s wall-clock budget on the walk: past either likes_count is a lower bound (stats.likes_count_complete false + warning). Cloudflare allows ~6 statuses calls / minute / IP - proxied the walk hops to a fresh US exit, direct it sleeps. Locked in cursor.","schema":{"type":"integer","default":100,"minimum":20,"maximum":600}},{"name":"statuses_per_minute","in":"query","required":false,"description":"Statuses calls per minute per exit the walk paces itself to (default 6 = Cloudflare's per-IP allowance). Locked in cursor.","schema":{"type":"integer","default":6,"minimum":1,"maximum":60}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["truth social"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"TruthSocial Profile Info","operationId":"post_truthsocial_profile_info","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"handles":{"type":"string","default":"realDonaldTrump","description":"The Truth Social account: \"realDonaldTrump\", \"@realDonaldTrump\", a profile URL (https://truthsocial.com/@realDonaldTrump, a /<status id> tail or the /users/<name> form is fine) or realDonaldTrump@truthsocial.com; case does not matter -> ONE profile record: the public Account entity verbatim (id, username, display_name, note / bio, avatar / header, followers_count, following_count, statuses_count, created_at, verified, premium, website ...), likes_count (likes received) and computed{engagement_rate, language, content_category}. Single lookup: next_cursor is always null. An unknown / suspended / moved account answers a status record (not_found | account_suspended | moved | invalid_input) + status_note."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"compute_metrics":{"type":"boolean","default":true,"description":"true (default) = sample the latest `feed_sample` original truths for computed.language / engagement_rate / content_category. false = profile only (1 request; engagement_rate / language null, category from the bio). Locked in cursor."},"feed_sample":{"type":"integer","default":20,"minimum":1,"maximum":100,"description":"Original truths sampled for the computed block (1..100, default 20 = one statuses page). Locked in cursor."},"count_likes":{"type":"boolean","default":true,"description":"true (default) = walk the status history (~20 a call) and sum favourites_count -> likes_count (likes received). false = likes_count null. Locked in cursor."},"likes_max_posts":{"type":"integer","default":100,"minimum":20,"maximum":600,"description":"Cap on the likes walk in statuses seen (default 100 = 5 pages). v2 CAP 600 (30 pages, ~20 s proxied) plus a 60 s wall-clock budget on the walk: past either likes_count is a lower bound (stats.likes_count_complete false + warning). Cloudflare allows ~6 statuses calls / minute / IP - proxied the walk hops to a fresh US exit, direct it sleeps. Locked in cursor."},"statuses_per_minute":{"type":"integer","default":6,"minimum":1,"maximum":60,"description":"Statuses calls per minute per exit the walk paces itself to (default 6 = Cloudflare's per-IP allowance). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["handles"]}}}}}},"/twitter-community-info/":{"get":{"tags":["twitter"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"X/Twitter Community Info & Search","operationId":"get_twitter_community_info","parameters":[{"name":"communities","in":"query","required":true,"description":"Numeric Community ID / communities/<id> URL (-> lookup, next_cursor null) or a free-text name/keyword (-> paginated search). Required first call.","schema":{"type":"string","default":"1783990533192651232"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"auth_token","in":"query","required":true,"description":"X/Twitter session cookie \"auth_token\" (required each call --, no session state carried over).","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["twitter"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"X/Twitter Community Info & Search","operationId":"post_twitter_community_info","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"communities":{"type":"string","default":"1783990533192651232","description":"Numeric Community ID / communities/<id> URL (-> lookup, next_cursor null) or a free-text name/keyword (-> paginated search). Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"auth_token":{"type":"string","description":"X/Twitter session cookie \"auth_token\" (required each call --, no session state carried over)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["communities","auth_token"]}}}}}},"/twitter-community-tweets/":{"get":{"tags":["twitter"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"X/Twitter Community Tweets","operationId":"get_twitter_community_tweets","parameters":[{"name":"community_ids","in":"query","required":true,"description":"Numeric X Community ID or a communities/<id> URL. Required first call.","schema":{"type":"string","default":"1783990533192651232"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"auth_token","in":"query","required":true,"description":"X/Twitter session cookie \"auth_token\" (required each call --, no session state carried over).","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["twitter"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"X/Twitter Community Tweets","operationId":"post_twitter_community_tweets","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"community_ids":{"type":"string","default":"1783990533192651232","description":"Numeric X Community ID or a communities/<id> URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"auth_token":{"type":"string","description":"X/Twitter session cookie \"auth_token\" (required each call --, no session state carried over)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["community_ids","auth_token"]}}}}}},"/twitter-post/":{"get":{"tags":["twitter"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Twitter/X Posts","operationId":"get_twitter_post","parameters":[{"name":"usernames","in":"query","required":true,"description":"X/Twitter post URL or post id (returns that one post), or username / profile URL / numeric user ID (latest posts, ~20 per page). Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"elonmusk"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["twitter"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Twitter/X Posts","operationId":"post_twitter_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"elonmusk","description":"X/Twitter post URL or post id (returns that one post), or username / profile URL / numeric user ID (latest posts, ~20 per page). Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/twitter-transcript/":{"get":{"tags":["twitter"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"X/Twitter Video Transcript","operationId":"get_twitter_transcript","parameters":[{"name":"urls","in":"query","required":true,"description":"Tweet/X post URL. Lookup endpoint -- next_cursor null.","schema":{"type":"string","default":"https://x.com/MrBeast/status/2096285173788840001","format":"uri"}},{"name":"translate_to_english","in":"query","required":false,"description":"Translate transcript to English.","schema":{"type":"boolean","default":false}},{"name":"model_size","in":"query","required":false,"description":"faster-whisper model size.","schema":{"type":"string","default":"small","enum":["tiny","base","small","medium","large-v3"]}},{"name":"beam_size","in":"query","required":false,"description":"Beam search width (1-10).","schema":{"type":"integer","default":5}},{"name":"language","in":"query","required":false,"description":"ISO language code to force (default: auto-detect).","schema":{"type":"string"}},{"name":"vad_filter","in":"query","required":false,"description":"Drop non-speech audio.","schema":{"type":"boolean","default":true}},{"name":"max_duration_seconds","in":"query","required":false,"description":"Longer videos fail as a record.","schema":{"type":"integer","default":900}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["twitter"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"X/Twitter Video Transcript","operationId":"post_twitter_transcript","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://x.com/MrBeast/status/2096285173788840001","format":"uri","description":"Tweet/X post URL. Lookup endpoint -- next_cursor null."},"translate_to_english":{"type":"boolean","default":false,"description":"Translate transcript to English."},"model_size":{"type":"string","default":"small","enum":["tiny","base","small","medium","large-v3"],"description":"faster-whisper model size."},"beam_size":{"type":"integer","default":5,"description":"Beam search width (1-10)."},"language":{"type":"string","description":"ISO language code to force (default: auto-detect)."},"vad_filter":{"type":"boolean","default":true,"description":"Drop non-speech audio."},"max_duration_seconds":{"type":"integer","default":900,"description":"Longer videos fail as a record."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/twitter-tweets/":{"get":{"tags":["twitter"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Twitter/X Profile Tweets","operationId":"get_twitter_tweets","parameters":[{"name":"usernames","in":"query","required":true,"description":"X handle, numeric user ID, or profile URL. Required on first call; ignored when `cursor` is supplied. Keyword/hashtag search is login-only on X and returns 400.","schema":{"type":"string","default":"elonmusk"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"with_replies","in":"query","required":false,"description":"Include replies in the result. Locked into the cursor.","schema":{"type":"boolean","default":true}},{"name":"include_user_info","in":"query","required":false,"description":"Include per-tweet user info. Locked into the cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Route through the platform rotating residential proxy (X rate-limits anonymous calls per IP). Falls back to direct (with a `warning`) if the proxy is unreachable.","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["twitter"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Twitter/X Profile Tweets","operationId":"post_twitter_tweets","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"elonmusk","description":"X handle, numeric user ID, or profile URL. Required on first call; ignored when `cursor` is supplied. Keyword/hashtag search is login-only on X and returns 400."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"with_replies":{"type":"boolean","default":true,"description":"Include replies in the result. Locked into the cursor."},"include_user_info":{"type":"boolean","default":true,"description":"Include per-tweet user info. Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Route through the platform rotating residential proxy (X rate-limits anonymous calls per IP). Falls back to direct (with a `warning`) if the proxy is unreachable."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames"]}}}}}},"/twitter-user-scraper/":{"get":{"tags":["twitter"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Twitter/X User Scraper","operationId":"get_twitter_user_scraper","parameters":[{"name":"usernames","in":"query","required":true,"description":"Twitter/X username, @handle, or profile URL. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"elonmusk"}},{"name":"auth_token","in":"query","required":true,"description":"X session cookie auth_token (required on every call, including cursor pages — not locked into the cursor).","schema":{"type":"string"}},{"name":"ct0","in":"query","required":true,"description":"X session cookie ct0 / CSRF token (required on every call, including cursor pages — not locked into the cursor).","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"get_retweeters","in":"query","required":false,"description":"Keep users found via retweets/quotes in the timeline, not just the source account. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"get_about","in":"query","required":false,"description":"Enrich each kept user via UserByScreenName. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"get_followers","in":"query","required":false,"description":"Include the followers COUNT field. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"get_following","in":"query","required":false,"description":"Include the following COUNT field. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"include_unavailable_users","in":"query","required":false,"description":"Include placeholder rows for suspended/deleted accounts. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["twitter"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Twitter/X User Scraper","operationId":"post_twitter_user_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"type":"string","default":"elonmusk","description":"Twitter/X username, @handle, or profile URL. Required on first call; ignored when `cursor` is supplied."},"auth_token":{"type":"string","description":"X session cookie auth_token (required on every call, including cursor pages — not locked into the cursor)."},"ct0":{"type":"string","description":"X session cookie ct0 / CSRF token (required on every call, including cursor pages — not locked into the cursor)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"get_retweeters":{"type":"boolean","default":true,"description":"Keep users found via retweets/quotes in the timeline, not just the source account. Locked in cursor."},"get_about":{"type":"boolean","default":true,"description":"Enrich each kept user via UserByScreenName. Locked in cursor."},"get_followers":{"type":"boolean","default":true,"description":"Include the followers COUNT field. Locked in cursor."},"get_following":{"type":"boolean","default":true,"description":"Include the following COUNT field. Locked in cursor."},"include_unavailable_users":{"type":"boolean","default":true,"description":"Include placeholder rows for suspended/deleted accounts. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["usernames","auth_token","ct0"]}}}}}},"/upwork-jobs/":{"get":{"tags":["upwork"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Upwork Jobs","operationId":"get_upwork_jobs","parameters":[{"name":"query","in":"query","required":true,"description":"Search term. Single-page endpoint — returns up to max_items jobs; next_cursor is always null (Cloudflare-gated browser scraper). Aliases: queries, q.","schema":{"type":"string","default":"python developer"}},{"name":"max_items","in":"query","required":false,"description":"Jobs returned in the single page.","schema":{"type":"integer","default":10}},{"name":"hourly","in":"query","required":false,"description":"Filter to hourly contracts.","schema":{"type":"boolean","default":false}},{"name":"fixed","in":"query","required":false,"description":"Filter to fixed-price contracts.","schema":{"type":"boolean","default":false}},{"name":"payment_verified","in":"query","required":false,"description":"Filter to clients with a verified payment method.","schema":{"type":"boolean","default":false}},{"name":"no_hires","in":"query","required":false,"description":"Filter to clients with zero prior hires.","schema":{"type":"boolean","default":false}},{"name":"contract_to_hire","in":"query","required":false,"description":"Filter to contract-to-hire jobs.","schema":{"type":"boolean","default":false}},{"name":"sort","in":"query","required":false,"description":"Result ordering.","schema":{"type":"string","default":"recency","enum":["recency","relevance"]}},{"name":"detail_concurrency","in":"query","required":false,"description":"Max parallel job-detail-page fetches (1-8).","schema":{"type":"integer","default":3}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["upwork"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Upwork Jobs","operationId":"post_upwork_jobs","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"python developer","description":"Search term. Single-page endpoint — returns up to max_items jobs; next_cursor is always null (Cloudflare-gated browser scraper). Aliases: queries, q."},"max_items":{"type":"integer","default":10,"description":"Jobs returned in the single page."},"hourly":{"type":"boolean","default":false,"description":"Filter to hourly contracts."},"fixed":{"type":"boolean","default":false,"description":"Filter to fixed-price contracts."},"payment_verified":{"type":"boolean","default":false,"description":"Filter to clients with a verified payment method."},"no_hires":{"type":"boolean","default":false,"description":"Filter to clients with zero prior hires."},"contract_to_hire":{"type":"boolean","default":false,"description":"Filter to contract-to-hire jobs."},"sort":{"type":"string","default":"recency","enum":["recency","relevance"],"description":"Result ordering."},"detail_concurrency":{"type":"integer","default":3,"description":"Max parallel job-detail-page fetches (1-8)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["query"]}}}}}},"/walmart-category/":{"get":{"tags":["walmart"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Walmart Category","operationId":"get_walmart_category","parameters":[{"name":"urls","in":"query","required":true,"description":"Walmart category URL or bare category id. Required on the first call; list -> first only.","schema":{"type":"string","default":"3944"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"best_match","enum":["best_match","price_low","price_high","best_seller","top_rated","new"]}},{"name":"min_price","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer"}},{"name":"max_price","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer"}},{"name":"refinement","in":"query","required":false,"description":"Facet token(s) e.g. brand:Apple. Locked in cursor.","schema":{"type":"string"}},{"name":"zip_code","in":"query","required":false,"description":"Resolved to a store on page 1. Locked in cursor.","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string"}},{"name":"store_id","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"US","enum":["US","CA"]}},{"name":"strict_price_filter","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"include_brand","in":"query","required":false,"description":"Per-product brand lookup (one extra product-page request per row; heavy, default off). Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"include_reviews_count","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["walmart"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Walmart Category","operationId":"post_walmart_category","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"3944","description":"Walmart category URL or bare category id. Required on the first call; list -> first only."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort":{"type":"string","default":"best_match","enum":["best_match","price_low","price_high","best_seller","top_rated","new"],"description":"Locked in cursor."},"min_price":{"type":"integer","description":"Locked in cursor."},"max_price":{"type":"integer","description":"Locked in cursor."},"refinement":{"type":"string","description":"Facet token(s) e.g. brand:Apple. Locked in cursor."},"zip_code":{"type":"string","description":"Resolved to a store on page 1. Locked in cursor."},"state":{"type":"string","description":"Locked in cursor."},"store_id":{"type":"string","description":"Locked in cursor."},"country":{"type":"string","default":"US","enum":["US","CA"],"description":"Locked in cursor."},"strict_price_filter":{"type":"boolean","default":true,"description":"Locked in cursor."},"include_brand":{"type":"boolean","default":false,"description":"Per-product brand lookup (one extra product-page request per row; heavy, default off). Locked in cursor."},"include_reviews_count":{"type":"boolean","default":false,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/walmart-data-extractor/":{"get":{"tags":["walmart"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Walmart Data Extractor","operationId":"get_walmart_data_extractor","parameters":[{"name":"urls","in":"query","required":true,"description":"Walmart listing (/search?q=, /browse/, /shop/) or product (/ip/) URL, or a plain keyword. Required first call. One listing page (~40-60 products, each enriched from its product page; detail_fetched=false if that missed the time budget) per call.","schema":{"type":"string","default":"laptop"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_details","in":"query","required":false,"description":"Also fetch each product page (seller, UPC, variants, full description). Much heavier; default false returns listing-card data. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"include_reviews","in":"query","required":false,"description":"Attach reviews to each product. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"zip_code","in":"query","required":false,"description":"5-digit US delivery ZIP hint. Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["walmart"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Walmart Data Extractor","operationId":"post_walmart_data_extractor","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"laptop","description":"Walmart listing (/search?q=, /browse/, /shop/) or product (/ip/) URL, or a plain keyword. Required first call. One listing page (~40-60 products, each enriched from its product page; detail_fetched=false if that missed the time budget) per call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_details":{"type":"boolean","default":false,"description":"Also fetch each product page (seller, UPC, variants, full description). Much heavier; default false returns listing-card data. Locked in cursor."},"include_reviews":{"type":"boolean","default":false,"description":"Attach reviews to each product. Locked in cursor."},"zip_code":{"type":"string","description":"5-digit US delivery ZIP hint. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/walmart-reviews/":{"get":{"tags":["walmart"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Walmart Reviews","operationId":"get_walmart_reviews","parameters":[{"name":"urls","in":"query","required":true,"description":"Walmart product URL (/ip/<slug>/<itemId>), reviews URL (/reviews/product/<itemId>), bare item id, or search/browse URL (walks its first `max_products` items). Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"https://www.walmart.com/ip/Apple-AirPods-4/11381374703","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"reviews_sort_type","in":"query","required":false,"description":"Review sort. Locked into the cursor.","schema":{"type":"string","default":"relevancy","enum":["relevancy","helpful","submission-desc","submission-asc","rating-desc","rating-asc"]}},{"name":"rating_filter","in":"query","required":false,"description":"Only reviews with these star ratings, e.g. '5' or '1,2' (default: all). Locked into the cursor.","schema":{"type":"string"}},{"name":"max_products","in":"query","required":false,"description":"Search/browse URL input only: products walked (max 40). Locked into the cursor.","schema":{"type":"integer","default":20}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["walmart"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Walmart Reviews","operationId":"post_walmart_reviews","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.walmart.com/ip/Apple-AirPods-4/11381374703","format":"uri","description":"Walmart product URL (/ip/<slug>/<itemId>), reviews URL (/reviews/product/<itemId>), bare item id, or search/browse URL (walks its first `max_products` items). Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"reviews_sort_type":{"type":"string","default":"relevancy","enum":["relevancy","helpful","submission-desc","submission-asc","rating-desc","rating-asc"],"description":"Review sort. Locked into the cursor."},"rating_filter":{"type":"string","description":"Only reviews with these star ratings, e.g. '5' or '1,2' (default: all). Locked into the cursor."},"max_products":{"type":"integer","default":20,"description":"Search/browse URL input only: products walked (max 40). Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/walmart-search-scraper/":{"get":{"tags":["walmart"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Walmart Search Scraper","operationId":"get_walmart_search_scraper","parameters":[{"name":"queries","in":"query","required":true,"description":"Search keyword or Walmart /search?q= URL. Required on the first call.","schema":{"type":"string","default":"lego star wars"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Result sort order. Locked in cursor.","schema":{"type":"string","default":"best_match","enum":["best_match","price_low","price_high","best_seller","new","rating_high"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["walmart"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Walmart Search Scraper","operationId":"post_walmart_search_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"lego star wars","description":"Search keyword or Walmart /search?q= URL. Required on the first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort":{"type":"string","default":"best_match","enum":["best_match","price_low","price_high","best_seller","new","rating_high"],"description":"Result sort order. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/yahoo-search/":{"get":{"tags":["yahoo"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Yahoo Search","operationId":"get_yahoo_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"java developer"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"time_period","in":"query","required":false,"description":"Filter by recency. Locked in cursor.","schema":{"type":"string","default":"Anytime","enum":["Anytime","Past day","Past week","Past month"]}},{"name":"backfill_empty_results","in":"query","required":false,"description":"Fetch each result's own page to fill in `text`/`links` when Yahoo's SERP snippet is empty. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"backfill_concurrency","in":"query","required":false,"description":"Concurrent backfill page fetches per page. Locked in cursor.","schema":{"type":"integer","default":8}},{"name":"backfill_max_links","in":"query","required":false,"description":"Max sub-links to extract per backfilled result page. Locked in cursor.","schema":{"type":"integer","default":10}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["yahoo"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Yahoo Search","operationId":"post_yahoo_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"java developer","description":"Search term. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"time_period":{"type":"string","default":"Anytime","enum":["Anytime","Past day","Past week","Past month"],"description":"Filter by recency. Locked in cursor."},"backfill_empty_results":{"type":"boolean","default":true,"description":"Fetch each result's own page to fill in `text`/`links` when Yahoo's SERP snippet is empty. Locked in cursor."},"backfill_concurrency":{"type":"integer","default":8,"description":"Concurrent backfill page fetches per page. Locked in cursor."},"backfill_max_links":{"type":"integer","default":10,"description":"Max sub-links to extract per backfilled result page. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/yandex-search/":{"get":{"tags":["yandex"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Yandex Search","operationId":"get_yandex_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term on yandex.com. Required first call.","schema":{"type":"string","default":"python tutorial"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"Regional ranking. Locked in cursor.","schema":{"type":"string","default":"en","enum":["en","ru","uk","de","fr","tr","be","kk","uz","az","lv","lt","et"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["yandex"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Yandex Search","operationId":"post_yandex_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"python tutorial","description":"Search term on yandex.com. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"language":{"type":"string","default":"en","enum":["en","ru","uk","de","fr","tr","be","kk","uz","az","lv","lt","et"],"description":"Regional ranking. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/youtube-channel-info/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Channel Info","operationId":"get_youtube_channel_info","parameters":[{"name":"urls","in":"query","required":true,"description":"YouTube channel URL (/@handle, /channel/UC…, /c/, /user/), @handle, name or UC id. Returns one channel record (about + first page of videos/shorts/live/posts).","schema":{"type":"string","default":"MrBeast","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Channel Info","operationId":"post_youtube_channel_info","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"MrBeast","format":"uri","description":"YouTube channel URL (/@handle, /channel/UC…, /c/, /user/), @handle, name or UC id. Returns one channel record (about + first page of videos/shorts/live/posts)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/youtube-channel-live/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Channel Live/Streams","operationId":"get_youtube_channel_live","parameters":[{"name":"channels","in":"query","required":true,"description":"YouTube @handle / channel URL / channelId. Required first call.","schema":{"type":"string","default":"ishowspeed"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Channel Live/Streams","operationId":"post_youtube_channel_live","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"channels":{"type":"string","default":"ishowspeed","description":"YouTube @handle / channel URL / channelId. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["channels"]}}}}}},"/youtube-channel-video-scraper/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Channel Video Scraper","operationId":"get_youtube_channel_video_scraper","parameters":[{"name":"youtube_channels","in":"query","required":true,"description":"YouTube @handle / channel URL / channel id. Required on the first call.","schema":{"type":"string","default":"@mrbeast"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"scrape_type","in":"query","required":false,"description":"videos | shorts | both (videos paged first, then shorts). Locked in cursor.","schema":{"type":"string","default":"videos","enum":["videos","shorts","both"]}},{"name":"end_date","in":"query","required":false,"description":"YYYY-MM-DD, inclusive start of kept range (videos only). Locked in cursor.","schema":{"type":"string","format":"date"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Channel Video Scraper","operationId":"post_youtube_channel_video_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"youtube_channels":{"type":"string","default":"@mrbeast","description":"YouTube @handle / channel URL / channel id. Required on the first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"scrape_type":{"type":"string","default":"videos","enum":["videos","shorts","both"],"description":"videos | shorts | both (videos paged first, then shorts). Locked in cursor."},"end_date":{"type":"string","format":"date","description":"YYYY-MM-DD, inclusive start of kept range (videos only). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["youtube_channels"]}}}}}},"/youtube-comment-replies/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Comment Replies","operationId":"get_youtube_comment_replies","parameters":[{"name":"continuation_tokens","in":"query","required":true,"description":"Base64url reply continuation token from a \"Show more replies\" call -> ONE thread record (comments nested inside). Single lookup: next_cursor is always null. A truncated thread (hit max_items / an absolute page cap / a transport error) reports next_continuation_token on the row — resubmit it as a fresh continuation_tokens value to keep walking.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Replies per thread. 0 or omitted = walk to exhaustion. Locked in cursor.","schema":{"type":"integer","default":0}},{"name":"language","in":"query","required":false,"description":"innertube hl. Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"region","in":"query","required":false,"description":"innertube gl. Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Comment Replies","operationId":"post_youtube_comment_replies","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"continuation_tokens":{"type":"string","description":"Base64url reply continuation token from a \"Show more replies\" call -> ONE thread record (comments nested inside). Single lookup: next_cursor is always null. A truncated thread (hit max_items / an absolute page cap / a transport error) reports next_continuation_token on the row — resubmit it as a fresh continuation_tokens value to keep walking."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_items":{"type":"integer","default":0,"description":"Replies per thread. 0 or omitted = walk to exhaustion. Locked in cursor."},"language":{"type":"string","default":"en","description":"innertube hl. Locked in cursor."},"region":{"type":"string","default":"US","description":"innertube gl. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["continuation_tokens"]}}}}}},"/youtube-comments-scraper/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Comments","operationId":"get_youtube_comments_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"YouTube watch URL / youtu.be / bare 11-char id. Required on the first call.","schema":{"type":"string","default":"https://www.youtube.com/watch?v=uKv3mi2t2KE"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"Comment sort order. Locked into the cursor.","schema":{"type":"string","default":"top","enum":["top","newest"]}},{"name":"language","in":"query","required":false,"description":"innertube hl. Locked into the cursor.","schema":{"type":"string","default":"en"}},{"name":"region","in":"query","required":false,"description":"innertube gl. Locked into the cursor.","schema":{"type":"string","default":"US"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Comments","operationId":"post_youtube_comments_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.youtube.com/watch?v=uKv3mi2t2KE","description":"YouTube watch URL / youtu.be / bare 11-char id. Required on the first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_by":{"type":"string","default":"top","enum":["top","newest"],"description":"Comment sort order. Locked into the cursor."},"language":{"type":"string","default":"en","description":"innertube hl. Locked into the cursor."},"region":{"type":"string","default":"US","description":"innertube gl. Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/youtube-community-posts/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Community Posts","operationId":"get_youtube_community_posts","parameters":[{"name":"urls","in":"query","required":true,"description":"YouTube channel URL, @username, or channel ID. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"https://www.youtube.com/@MrBeast"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Community Posts","operationId":"post_youtube_community_posts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.youtube.com/@MrBeast","description":"YouTube channel URL, @username, or channel ID. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/youtube-hashtag-videos/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Hashtag Videos","operationId":"get_youtube_hashtag_videos","parameters":[{"name":"hashtags","in":"query","required":true,"description":"Hashtag (without #). Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"chatgpt"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"scrape_shorts_only","in":"query","required":false,"description":"Only scrape Shorts. Locked into the cursor.","schema":{"type":"boolean","default":false}},{"name":"scrape_videos_only","in":"query","required":false,"description":"Only scrape regular videos. Locked into the cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Hashtag Videos","operationId":"post_youtube_hashtag_videos","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"hashtags":{"type":"string","default":"chatgpt","description":"Hashtag (without #). Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"scrape_shorts_only":{"type":"boolean","default":false,"description":"Only scrape Shorts. Locked into the cursor."},"scrape_videos_only":{"type":"boolean","default":false,"description":"Only scrape regular videos. Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["hashtags"]}}}}}},"/youtube-playlist/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Playlist Videos","operationId":"get_youtube_playlist","parameters":[{"name":"urls","in":"query","required":true,"description":"YouTube playlist URL, watch?v=..&list=.. URL or bare playlist ID (PL…, UU…). Required on first call; ignored when `cursor` is supplied. Each page returns up to ~100 videos (one YouTube page).","schema":{"type":"string","default":"https://www.youtube.com/playlist?list=PLObrtcm1Kw6Odq5ks2R3bbJUGVVwQF-vw","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Playlist Videos","operationId":"post_youtube_playlist","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.youtube.com/playlist?list=PLObrtcm1Kw6Odq5ks2R3bbJUGVVwQF-vw","format":"uri","description":"YouTube playlist URL, watch?v=..&list=.. URL or bare playlist ID (PL…, UU…). Required on first call; ignored when `cursor` is supplied. Each page returns up to ~100 videos (one YouTube page)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/youtube-search-full/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Search","operationId":"get_youtube_search_full","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"fitness"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_results_video","in":"query","required":false,"description":"Max regular videos returned per page (0 = exclude). One page = one native YouTube search page (~20 videos). Locked into the cursor.","schema":{"type":"integer","default":20}},{"name":"max_results_shorts","in":"query","required":false,"description":"Max shorts returned per page (0 = exclude; videos=0 + shorts>0 switches to YouTube's Shorts-only search). Locked into the cursor.","schema":{"type":"integer","default":10}},{"name":"max_results_streams","in":"query","required":false,"description":"Max currently-live streams per page (0 = exclude). Locked into the cursor.","schema":{"type":"integer","default":0}},{"name":"sort_by","in":"query","required":false,"description":"Sort order: relevance | upload_date | view_count | rating (applied server-side by YouTube)","schema":{"type":"string","default":"relevance"}},{"name":"upload_date","in":"query","required":false,"description":"Upload-date filter: hour | today | week | month | year (empty = any time)","schema":{"type":"string"}},{"name":"duration","in":"query","required":false,"description":"Duration filter: short (<4 min) | medium (4-20 min) | long (>20 min) (empty = any)","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Result region (2-letter country code, YouTube `gl`)","schema":{"type":"string","default":"US"}},{"name":"language","in":"query","required":false,"description":"Interface language for result texts (YouTube `hl`, e.g. en, es, de)","schema":{"type":"string","default":"en"}},{"name":"download_subtitles","in":"query","required":false,"description":"Fetch the transcript + caption language list for each video (true/false). Best-effort within the per-call time budget; rows always carry details first","schema":{"type":"boolean","default":false}},{"name":"subtitles_language","in":"query","required":false,"description":"Preferred transcript language code (e.g. \"en\", \"es\", \"fr\"); falls back to an auto-translation or the original track","schema":{"type":"string","default":"en"}},{"name":"subtitles_format","in":"query","required":false,"description":"Transcript format: srt | text | timestamp (JSON list of {start, duration, text})","schema":{"type":"string","default":"srt"}},{"name":"fetch_metadata","in":"query","required":false,"description":"Enrich each video with exact likes, full description, tags, category, publish date, subscribers and comment count (true/false)","schema":{"type":"boolean","default":true}},{"name":"fetch_shorts_stats","in":"query","required":false,"description":"Fetch subscribers + comment count for shorts too (default false: skips an extra ~22KB upstream request per short; set true to include them; videos always get them when fetch_metadata is true)","schema":{"type":"boolean","default":false}},{"name":"isHD","in":"query","required":false,"description":"Filter: HD only (server-side YouTube filter)","schema":{"type":"boolean","default":false}},{"name":"is4K","in":"query","required":false,"description":"Filter: 4K only (server-side YouTube filter)","schema":{"type":"boolean","default":false}},{"name":"isLive","in":"query","required":false,"description":"Filter: live streams only (server-side; enables streams automatically)","schema":{"type":"boolean","default":false}},{"name":"hasSubtitles","in":"query","required":false,"description":"Filter: videos with subtitles/CC only (server-side YouTube filter)","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Search","operationId":"post_youtube_search_full","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"fitness","description":"Search term. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_results_video":{"type":"integer","default":20,"description":"Max regular videos returned per page (0 = exclude). One page = one native YouTube search page (~20 videos). Locked into the cursor."},"max_results_shorts":{"type":"integer","default":10,"description":"Max shorts returned per page (0 = exclude; videos=0 + shorts>0 switches to YouTube's Shorts-only search). Locked into the cursor."},"max_results_streams":{"type":"integer","default":0,"description":"Max currently-live streams per page (0 = exclude). Locked into the cursor."},"sort_by":{"type":"string","default":"relevance","description":"Sort order: relevance | upload_date | view_count | rating (applied server-side by YouTube)"},"upload_date":{"type":"string","description":"Upload-date filter: hour | today | week | month | year (empty = any time)"},"duration":{"type":"string","description":"Duration filter: short (<4 min) | medium (4-20 min) | long (>20 min) (empty = any)"},"country":{"type":"string","default":"US","description":"Result region (2-letter country code, YouTube `gl`)"},"language":{"type":"string","default":"en","description":"Interface language for result texts (YouTube `hl`, e.g. en, es, de)"},"download_subtitles":{"type":"boolean","default":false,"description":"Fetch the transcript + caption language list for each video (true/false). Best-effort within the per-call time budget; rows always carry details first"},"subtitles_language":{"type":"string","default":"en","description":"Preferred transcript language code (e.g. \"en\", \"es\", \"fr\"); falls back to an auto-translation or the original track"},"subtitles_format":{"type":"string","default":"srt","description":"Transcript format: srt | text | timestamp (JSON list of {start, duration, text})"},"fetch_metadata":{"type":"boolean","default":true,"description":"Enrich each video with exact likes, full description, tags, category, publish date, subscribers and comment count (true/false)"},"fetch_shorts_stats":{"type":"boolean","default":false,"description":"Fetch subscribers + comment count for shorts too (default false: skips an extra ~22KB upstream request per short; set true to include them; videos always get them when fetch_metadata is true)"},"isHD":{"type":"boolean","default":false,"description":"Filter: HD only (server-side YouTube filter)"},"is4K":{"type":"boolean","default":false,"description":"Filter: 4K only (server-side YouTube filter)"},"isLive":{"type":"boolean","default":false,"description":"Filter: live streams only (server-side; enables streams automatically)"},"hasSubtitles":{"type":"boolean","default":false,"description":"Filter: videos with subtitles/CC only (server-side YouTube filter)"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/youtube-search-suggestions/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Search Suggestions","operationId":"get_youtube_search_suggestions","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term (<= 100 chars). Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"lofi"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO 3166-1 alpha-2 country code (gl). Locked into the cursor.","schema":{"type":"string","default":"US"}},{"name":"language","in":"query","required":false,"description":"UI language (hl) e.g. en, pt-BR. Blank = picked from country. Locked into the cursor.","schema":{"type":"string"}},{"name":"enrich_entities","in":"query","required":false,"description":"Attach entity/channel cards to suggestions. Locked into the cursor.","schema":{"type":"boolean","default":true}},{"name":"expansion_alphabet","in":"query","required":false,"description":"Characters appended during expansion. Blank = a-z0-9. Locked into the cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Search Suggestions","operationId":"post_youtube_search_suggestions","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"lofi","description":"Search term (<= 100 chars). Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"US","description":"ISO 3166-1 alpha-2 country code (gl). Locked into the cursor."},"language":{"type":"string","description":"UI language (hl) e.g. en, pt-BR. Blank = picked from country. Locked into the cursor."},"enrich_entities":{"type":"boolean","default":true,"description":"Attach entity/channel cards to suggestions. Locked into the cursor."},"expansion_alphabet":{"type":"string","description":"Characters appended during expansion. Blank = a-z0-9. Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/youtube-shorts/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Shorts","operationId":"get_youtube_shorts","parameters":[{"name":"mode","in":"query","required":false,"description":"single / video (one Short via input_value) or multi / channel (a channel Shorts tab, 25 per page). When `channels` is set it always wins.","schema":{"type":"string","default":"single","enum":["single","video","multi","channel"]}},{"name":"input_value","in":"query","required":false,"description":"Short URL or 11-char video ID (single mode). A channel URL/@handle here is treated as channel mode.","schema":{"type":"string","default":"dQw4w9WgXcQ"}},{"name":"channels","in":"query","required":false,"description":"Channel @handle, URL (/@x, /channel/UC..., /c/x, /user/x, .../shorts) or UC id. Returns its Shorts newest-first, 25 per call; follow next_cursor.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Shorts","operationId":"post_youtube_shorts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","default":"single","enum":["single","video","multi","channel"],"description":"single / video (one Short via input_value) or multi / channel (a channel Shorts tab, 25 per page). When `channels` is set it always wins."},"input_value":{"type":"string","default":"dQw4w9WgXcQ","description":"Short URL or 11-char video ID (single mode). A channel URL/@handle here is treated as channel mode."},"channels":{"type":"string","description":"Channel @handle, URL (/@x, /channel/UC..., /c/x, /user/x, .../shorts) or UC id. Returns its Shorts newest-first, 25 per call; follow next_cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/youtube-subtitles/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Subtitle / Transcript","operationId":"get_youtube_subtitles","parameters":[{"name":"urls","in":"query","required":true,"description":"YouTube video URL (watch, youtu.be, shorts, embed, live) or bare 11-char ID. Required on first call; ignored when `cursor` is supplied. No captions / unavailable -> 404.","schema":{"type":"string","default":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_english_ag","in":"query","required":false,"description":"Include auto-generated English subtitles. Locked into the cursor.","schema":{"type":"boolean","default":true}},{"name":"include_non_english","in":"query","required":false,"description":"Include non-English subtitles. Locked into the cursor.","schema":{"type":"boolean","default":false}},{"name":"output_format","in":"query","required":false,"description":"text or timestamp. Locked into the cursor.","schema":{"type":"string","default":"text","enum":["text","timestamp"]}},{"name":"language","in":"query","required":false,"description":"Optional language code (e.g. en, es, pt-BR): return only that language (manual preferred over auto-generated). If missing, the original track is returned with translation_error set. Locked into the cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Subtitle / Transcript","operationId":"post_youtube_subtitles","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","description":"YouTube video URL (watch, youtu.be, shorts, embed, live) or bare 11-char ID. Required on first call; ignored when `cursor` is supplied. No captions / unavailable -> 404."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_english_ag":{"type":"boolean","default":true,"description":"Include auto-generated English subtitles. Locked into the cursor."},"include_non_english":{"type":"boolean","default":false,"description":"Include non-English subtitles. Locked into the cursor."},"output_format":{"type":"string","default":"text","enum":["text","timestamp"],"description":"text or timestamp. Locked into the cursor."},"language":{"type":"string","description":"Optional language code (e.g. en, es, pt-BR): return only that language (manual preferred over auto-generated). If missing, the original track is returned with translation_error set. Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/youtube-trending/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Trending","operationId":"get_youtube_trending","parameters":[{"name":"country_code","in":"query","required":true,"description":"Two-letter ISO country code (e.g., US, BD, IN, GB). Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"US"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"content_type","in":"query","required":false,"description":"Trending list: music (trending music videos, 30; regions without that chart fall back to daily top music videos) | movies (trending trailers, 30) | top_music_videos (100) | gaming | sports | news | live | learning | fashion. Invalid value -> 400. Locked into the cursor.","schema":{"type":"string","default":"music"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Trending","operationId":"post_youtube_trending","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"country_code":{"type":"string","default":"US","description":"Two-letter ISO country code (e.g., US, BD, IN, GB). Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"content_type":{"type":"string","default":"music","description":"Trending list: music (trending music videos, 30; regions without that chart fall back to daily top music videos) | movies (trending trailers, 30) | top_music_videos (100) | gaming | sports | news | live | learning | fashion. Invalid value -> 400. Locked into the cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["country_code"]}}}}}},"/youtube-trending-shorts/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Trending Shorts","operationId":"get_youtube_trending_shorts","parameters":[{"name":"hashtags","in":"query","required":false,"description":"Hashtag Shorts feed to read (no '#'; letters/digits/underscore, any script). Default 'trendingshorts'. One feed per call (15 hydrated Shorts/page); ignored when `cursor` is supplied. Unknown hashtag -> 404. extra.hydrated=false marks a row served from feed data because its detail fetch missed the 22s deadline.","schema":{"type":"string","default":"trendingshorts"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO 3166-1 alpha-2 region (YouTube gl); a country YouTube does not offer -> 400. Locked in cursor.","schema":{"type":"string","default":"US"}},{"name":"language","in":"query","required":false,"description":"Interface language (YouTube hl). Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"sort_by","in":"query","required":false,"description":"Local ordering applied per page. Locked in cursor.","schema":{"type":"string","default":"default","enum":["default","views","likes","comments","engagement","newest","oldest","shortest","longest"]}},{"name":"include","in":"query","required":false,"description":"Comma list of extra joins: channel|captions|download|sound|comments (adds comment count, heavier). Locked in cursor.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Trending Shorts","operationId":"post_youtube_trending_shorts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"hashtags":{"type":"string","default":"trendingshorts","description":"Hashtag Shorts feed to read (no '#'; letters/digits/underscore, any script). Default 'trendingshorts'. One feed per call (15 hydrated Shorts/page); ignored when `cursor` is supplied. Unknown hashtag -> 404. extra.hydrated=false marks a row served from feed data because its detail fetch missed the 22s deadline."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"country":{"type":"string","default":"US","description":"ISO 3166-1 alpha-2 region (YouTube gl); a country YouTube does not offer -> 400. Locked in cursor."},"language":{"type":"string","default":"en","description":"Interface language (YouTube hl). Locked in cursor."},"sort_by":{"type":"string","default":"default","enum":["default","views","likes","comments","engagement","newest","oldest","shortest","longest"],"description":"Local ordering applied per page. Locked in cursor."},"include":{"type":"string","description":"Comma list of extra joins: channel|captions|download|sound|comments (adds comment count, heavier). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/youtube-video-details/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Video Details","operationId":"get_youtube_video_details","parameters":[{"name":"urls","in":"query","required":true,"description":"YouTube video URL or ID. Required on first call; ignored when `cursor` is supplied.","schema":{"type":"string","default":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Video Details","operationId":"post_youtube_video_details","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","description":"YouTube video URL or ID. Required on first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/youtube-video-sponsors/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Video Sponsors","operationId":"get_youtube_video_sponsors","parameters":[{"name":"video_ids","in":"query","required":true,"description":"YouTube watch / youtu.be / shorts / embed URL or bare 11-char id. One video per call. Required first call.","schema":{"type":"string","default":"https://www.youtube.com/watch?v=K8AMhj-ImMI"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"2-letter transcript language code. Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"include_transcript","in":"query","required":false,"description":"Also return the full transcript segments. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"resolve_short_links","in":"query","required":false,"description":"Follow bit.ly / amzn.to style links. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Video Sponsors","operationId":"post_youtube_video_sponsors","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"video_ids":{"type":"string","default":"https://www.youtube.com/watch?v=K8AMhj-ImMI","description":"YouTube watch / youtu.be / shorts / embed URL or bare 11-char id. One video per call. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"language":{"type":"string","default":"en","description":"2-letter transcript language code. Locked in cursor."},"include_transcript":{"type":"boolean","default":false,"description":"Also return the full transcript segments. Locked in cursor."},"resolve_short_links":{"type":"boolean","default":true,"description":"Follow bit.ly / amzn.to style links. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["video_ids"]}}}}}},"/youtube-video-thumbnail/":{"get":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Video Thumbnail","operationId":"get_youtube_video_thumbnail","parameters":[{"name":"urls","in":"query","required":false,"description":"VIDEO MODE: watch / youtu.be / shorts / embed URL or bare 11-char id. Single lookup (next_cursor always null, result under `video`). Required unless channel_url is given.","schema":{"type":"string","default":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}},{"name":"channel_url","in":"query","required":false,"description":"CHANNEL MODE: @handle, /channel/UC…, /c/… or /user/… URL. ~10 videos per page (newest first) under `videos`, paged through YouTube's own continuation token. Required first call; ignored when `cursor` is supplied.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"channel_tab","in":"query","required":false,"description":"Channel mode: which listing to walk. Locked in cursor.","schema":{"type":"string","default":"videos","enum":["videos","shorts","streams"]}},{"name":"start_date","in":"query","required":false,"description":"Channel mode: only videos uploaded on/after (YYYY-MM-DD or ISO 8601). Locked in cursor.","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Channel mode: only videos uploaded on/before (YYYY-MM-DD or ISO 8601). Locked in cursor.","schema":{"type":"string","format":"date"}},{"name":"verify_thumbnails","in":"query","required":false,"description":"Probe every file on i.ytimg.com (real size / bytes / dropped). Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"include_frames","in":"query","required":false,"description":"Also return the auto-generated frame thumbnails (frame_items). Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["youtube"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"YouTube Video Thumbnail","operationId":"post_youtube_video_thumbnail","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","description":"VIDEO MODE: watch / youtu.be / shorts / embed URL or bare 11-char id. Single lookup (next_cursor always null, result under `video`). Required unless channel_url is given."},"channel_url":{"type":"string","description":"CHANNEL MODE: @handle, /channel/UC…, /c/… or /user/… URL. ~10 videos per page (newest first) under `videos`, paged through YouTube's own continuation token. Required first call; ignored when `cursor` is supplied."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"channel_tab":{"type":"string","default":"videos","enum":["videos","shorts","streams"],"description":"Channel mode: which listing to walk. Locked in cursor."},"start_date":{"type":"string","format":"date","description":"Channel mode: only videos uploaded on/after (YYYY-MM-DD or ISO 8601). Locked in cursor."},"end_date":{"type":"string","format":"date","description":"Channel mode: only videos uploaded on/before (YYYY-MM-DD or ISO 8601). Locked in cursor."},"verify_thumbnails":{"type":"boolean","default":true,"description":"Probe every file on i.ytimg.com (real size / bytes / dropped). Locked in cursor."},"include_frames":{"type":"boolean","default":true,"description":"Also return the auto-generated frame thumbnails (frame_items). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/zillow-detail/":{"get":{"tags":["zillow"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Zillow Property Detail","operationId":"get_zillow_detail","parameters":[{"name":"urls","in":"query","required":true,"description":"A Zillow detail URL or address. One record; next_cursor is always null.","schema":{"type":"string","default":"https://www.zillow.com/homedetails/17-Zelma-Dr-Greenville-SC-29617/11026031_zpid/"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["zillow"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Zillow Property Detail","operationId":"post_zillow_detail","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.zillow.com/homedetails/17-Zelma-Dr-Greenville-SC-29617/11026031_zpid/","description":"A Zillow detail URL or address. One record; next_cursor is always null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/zillow-search/":{"get":{"tags":["zillow"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Zillow Search","operationId":"get_zillow_search","parameters":[{"name":"url","in":"query","required":true,"description":"Zillow search URL — must contain a searchQueryState query param with at least mapBounds AND filterState. A bare `?searchQueryState={\"isMapVisible\":true}` URL parses fine but Zillow returns an empty list (no actual search filter).","schema":{"type":"string","default":"https://www.zillow.com/homes/for_sale/?searchQueryState=%7B%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22west%22%3A-124.61%2C%22east%22%3A-120.37%2C%22south%22%3A36.71%2C%22north%22%3A38.74%7D%2C%22filterState%22%3A%7B%22sort%22%3A%7B%22value%22%3A%22days%22%7D%7D%2C%22isListVisible%22%3Atrue%7D","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"method","in":"query","required":false,"description":"Scrape method: 'zoom' (async API) or 'html' (__NEXT_DATA__). Aliases: extraction_method, extractionMethod. Legacy: PAGINATION_WITH_ZOOM_IN / MAP_MARKERS → zoom; PAGINATION_WITHOUT_ZOOM_IN / HTML → html","schema":{"type":"string","default":"zoom"}},{"name":"delay","in":"query","required":false,"description":"Delay between requests in seconds (decimals OK). Applied to both methods","schema":{"type":"string","default":"1"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["zillow"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Zillow Search","operationId":"post_zillow_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","default":"https://www.zillow.com/homes/for_sale/?searchQueryState=%7B%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22west%22%3A-124.61%2C%22east%22%3A-120.37%2C%22south%22%3A36.71%2C%22north%22%3A38.74%7D%2C%22filterState%22%3A%7B%22sort%22%3A%7B%22value%22%3A%22days%22%7D%7D%2C%22isListVisible%22%3Atrue%7D","format":"uri","description":"Zillow search URL — must contain a searchQueryState query param with at least mapBounds AND filterState. A bare `?searchQueryState={\"isMapVisible\":true}` URL parses fine but Zillow returns an empty list (no actual search filter)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"method":{"type":"string","default":"zoom","description":"Scrape method: 'zoom' (async API) or 'html' (__NEXT_DATA__). Aliases: extraction_method, extractionMethod. Legacy: PAGINATION_WITH_ZOOM_IN / MAP_MARKERS → zoom; PAGINATION_WITHOUT_ZOOM_IN / HTML → html"},"delay":{"type":"string","default":"1","description":"Delay between requests in seconds (decimals OK). Applied to both methods"},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["url"]}}}}}},"/1688-products/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"1688 Products","operationId":"get_1688_products","parameters":[{"name":"queries","in":"query","required":true,"description":"1688.com search keyword (Chinese or English). POST: JSON array for several. GET: first only.","schema":{"type":"string","default":"phone case"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort_type","in":"query","required":false,"description":"normal = comprehensive, va_rmdarkgmv30 = sales (30d), va_price_asc / va_price_desc = price.","schema":{"type":"string","default":"va_rmdarkgmv30","enum":["normal","va_rmdarkgmv30","va_price_asc","va_price_desc"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true).","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"1688 Products","operationId":"post_1688_products","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"phone case","description":"1688.com search keyword (Chinese or English). POST: JSON array for several. GET: first only."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort_type":{"type":"string","default":"va_rmdarkgmv30","enum":["normal","va_rmdarkgmv30","va_price_asc","va_price_desc"],"description":"normal = comprehensive, va_rmdarkgmv30 = sales (30d), va_price_asc / va_price_desc = price."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/2gis-search/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"2GIS Search","operationId":"get_2gis_search","parameters":[{"name":"queries","in":"query","required":true,"description":"Search term, Russian works best. Required first call.","schema":{"type":"string","default":"Ресторан"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"location","in":"query","required":false,"description":"City/region name as on 2gis.ru. Locked in cursor.","schema":{"type":"string","default":"Москва"}},{"name":"include_contacts","in":"query","required":false,"description":"Include phones, email, website, socials. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"include_description","in":"query","required":false,"description":"Fill missing descriptions. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"max_reviews_per_place","in":"query","required":false,"description":"Reviews per place (0 = none). Locked in cursor.","schema":{"type":"integer","default":0,"minimum":0,"maximum":50}},{"name":"review_sort_by","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"trust","enum":["trust","date_edited"]}},{"name":"include_unrated_reviews","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"include_reviewer_data","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"2GIS Search","operationId":"post_2gis_search","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"Ресторан","description":"Search term, Russian works best. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"location":{"type":"string","default":"Москва","description":"City/region name as on 2gis.ru. Locked in cursor."},"include_contacts":{"type":"boolean","default":true,"description":"Include phones, email, website, socials. Locked in cursor."},"include_description":{"type":"boolean","default":true,"description":"Fill missing descriptions. Locked in cursor."},"max_reviews_per_place":{"type":"integer","default":0,"minimum":0,"maximum":50,"description":"Reviews per place (0 = none). Locked in cursor."},"review_sort_by":{"type":"string","default":"trust","enum":["trust","date_edited"],"description":"Locked in cursor."},"include_unrated_reviews":{"type":"boolean","default":true,"description":"Locked in cursor."},"include_reviewer_data":{"type":"boolean","default":true,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries"]}}}}}},"/ahrefs/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Ahrefs Free-Tools","operationId":"get_ahrefs","parameters":[{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"urls","in":"query","required":false,"description":"Domain(s) or URL(s) for the traffic / authority / backlink tools. POST: JSON array. GET: first only.","schema":{"type":"string","default":"make.com"}},{"name":"keyword","in":"query","required":false,"description":"Keyword (or brand for AI visibility) for the keyword tools.","schema":{"type":"string","default":"ai automation"}},{"name":"country","in":"query","required":false,"description":"2-letter country code.","schema":{"type":"string","default":"us"}},{"name":"mode","in":"query","required":false,"description":"Domain scope.","schema":{"type":"string","default":"subdomains","enum":["subdomains","exact"]}},{"name":"protocol","in":"query","required":false,"description":"Traffic tool protocol.","schema":{"type":"string","default":"both","enum":["both","http","https"]}},{"name":"search_engine","in":"query","required":false,"description":"Keyword ideas search engine (Google, Bing, Amazon...).","schema":{"type":"string","default":"Google"}},{"name":"include_traffic","in":"query","required":false,"description":"Traffic overview. Each enabled tool costs one paid captcha solve; if you set any include_* flag, unset ones default to false.","schema":{"type":"boolean","default":true}},{"name":"include_web_authority","in":"query","required":false,"description":"Domain rating, backlinks, referring domains.","schema":{"type":"boolean","default":true}},{"name":"include_keywords_difficulty","in":"query","required":false,"description":"Keyword difficulty + SERP (needs keyword).","schema":{"type":"boolean","default":false}},{"name":"include_keywords","in":"query","required":false,"description":"Keyword ideas + questions (needs keyword).","schema":{"type":"boolean","default":false}},{"name":"include_keywords_ranking","in":"query","required":false,"description":"Rank of each domain for the keyword (needs urls + keyword).","schema":{"type":"boolean","default":false}},{"name":"include_serp","in":"query","required":false,"description":"SERP overview (needs keyword).","schema":{"type":"boolean","default":false}},{"name":"include_backlinks","in":"query","required":false,"description":"Backlinks overview.","schema":{"type":"boolean","default":false}},{"name":"include_broken_links","in":"query","required":false,"description":"Broken links list.","schema":{"type":"boolean","default":false}},{"name":"include_ai_visibility","in":"query","required":false,"description":"AI visibility for the brand (keyword).","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Route Ahrefs calls through the platform proxy (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Ahrefs Free-Tools","operationId":"post_ahrefs","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"urls":{"type":"string","default":"make.com","description":"Domain(s) or URL(s) for the traffic / authority / backlink tools. POST: JSON array. GET: first only."},"keyword":{"type":"string","default":"ai automation","description":"Keyword (or brand for AI visibility) for the keyword tools."},"country":{"type":"string","default":"us","description":"2-letter country code."},"mode":{"type":"string","default":"subdomains","enum":["subdomains","exact"],"description":"Domain scope."},"protocol":{"type":"string","default":"both","enum":["both","http","https"],"description":"Traffic tool protocol."},"search_engine":{"type":"string","default":"Google","description":"Keyword ideas search engine (Google, Bing, Amazon...)."},"include_traffic":{"type":"boolean","default":true,"description":"Traffic overview. Each enabled tool costs one paid captcha solve; if you set any include_* flag, unset ones default to false."},"include_web_authority":{"type":"boolean","default":true,"description":"Domain rating, backlinks, referring domains."},"include_keywords_difficulty":{"type":"boolean","default":false,"description":"Keyword difficulty + SERP (needs keyword)."},"include_keywords":{"type":"boolean","default":false,"description":"Keyword ideas + questions (needs keyword)."},"include_keywords_ranking":{"type":"boolean","default":false,"description":"Rank of each domain for the keyword (needs urls + keyword)."},"include_serp":{"type":"boolean","default":false,"description":"SERP overview (needs keyword)."},"include_backlinks":{"type":"boolean","default":false,"description":"Backlinks overview."},"include_broken_links":{"type":"boolean","default":false,"description":"Broken links list."},"include_ai_visibility":{"type":"boolean","default":false,"description":"AI visibility for the brand (keyword)."},"use_proxy":{"type":"boolean","default":true,"description":"Route Ahrefs calls through the platform proxy (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/arbeitsagentur-jobs/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Arbeitsagentur Jobs","operationId":"get_arbeitsagentur_jobs","parameters":[{"name":"position","in":"query","required":false,"description":"Job keyword (German). One page of jobs per call; paginated by page.","schema":{"type":"string","default":"Softwareentwickler/in"}},{"name":"location","in":"query","required":false,"description":"City/place. Locked in cursor.","schema":{"type":"string"}},{"name":"angebotsart","in":"query","required":false,"description":"Offer type. Locked in cursor.","schema":{"type":"integer","default":1}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Arbeitsagentur Jobs","operationId":"post_arbeitsagentur_jobs","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"position":{"type":"string","default":"Softwareentwickler/in","description":"Job keyword (German). One page of jobs per call; paginated by page."},"location":{"type":"string","description":"City/place. Locked in cursor."},"angebotsart":{"type":"integer","default":1,"description":"Offer type. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/ats-jobs/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"ATS Jobs","operationId":"get_ats_jobs","parameters":[{"name":"companies_include","in":"query","required":true,"description":"Boards to pull (comma list / JSON array): \"greenhouse:stripe\", \"lever:leverdemo\", \"ashby:ramp\", \"workable:huggingface\", \"smartrecruiters:smartrecruiters\", a careers URL, or a company name (slug-guessed, may miss).","schema":{"type":"string","default":"greenhouse:stripe"}},{"name":"queries","in":"query","required":false,"description":"Keyword filter on title (and description if search_description). Up to 5.","schema":{"type":"string"}},{"name":"search_description","in":"query","required":false,"description":"Also match queries against the job description.","schema":{"type":"boolean","default":true}},{"name":"locations","in":"query","required":false,"description":"Location text filter (city/region/country).","schema":{"type":"string"}},{"name":"sources","in":"query","required":false,"description":"Limit to greenhouse, lever, ashby, workable, smartrecruiters.","schema":{"type":"string"}},{"name":"work_models","in":"query","required":false,"description":"Remote, Hybrid, On-site.","schema":{"type":"string"}},{"name":"employment_types","in":"query","required":false,"description":"Full-time, Part-time, Contract, Internship, ...","schema":{"type":"string"}},{"name":"experience_levels","in":"query","required":false,"description":"Experience level filter (inferred from title/text; unreliable).","schema":{"type":"string"}},{"name":"skills_include","in":"query","required":false,"description":"Only jobs mentioning these skills.","schema":{"type":"string"}},{"name":"skills_exclude","in":"query","required":false,"description":"Drop jobs mentioning these skills.","schema":{"type":"string"}},{"name":"companies_exclude","in":"query","required":false,"description":"Entries from companies_include to skip.","schema":{"type":"string"}},{"name":"posted_after","in":"query","required":false,"description":"ISO date or relative (\"7 days ago\").","schema":{"type":"string"}},{"name":"posted_before","in":"query","required":false,"description":"ISO date or relative.","schema":{"type":"string"}},{"name":"include_company_details","in":"query","required":false,"description":"Fetch each company website for logo/summary/social links (one extra request per company).","schema":{"type":"boolean","default":false}},{"name":"geocode","in":"query","required":false,"description":"Geocode locations via Nominatim (lat/lon; ~1.1s per distinct location).","schema":{"type":"boolean","default":false}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"ATS Jobs","operationId":"post_ats_jobs","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"companies_include":{"type":"string","default":"greenhouse:stripe","description":"Boards to pull (comma list / JSON array): \"greenhouse:stripe\", \"lever:leverdemo\", \"ashby:ramp\", \"workable:huggingface\", \"smartrecruiters:smartrecruiters\", a careers URL, or a company name (slug-guessed, may miss)."},"queries":{"type":"string","description":"Keyword filter on title (and description if search_description). Up to 5."},"search_description":{"type":"boolean","default":true,"description":"Also match queries against the job description."},"locations":{"type":"string","description":"Location text filter (city/region/country)."},"sources":{"type":"string","description":"Limit to greenhouse, lever, ashby, workable, smartrecruiters."},"work_models":{"type":"string","description":"Remote, Hybrid, On-site."},"employment_types":{"type":"string","description":"Full-time, Part-time, Contract, Internship, ..."},"experience_levels":{"type":"string","description":"Experience level filter (inferred from title/text; unreliable)."},"skills_include":{"type":"string","description":"Only jobs mentioning these skills."},"skills_exclude":{"type":"string","description":"Drop jobs mentioning these skills."},"companies_exclude":{"type":"string","description":"Entries from companies_include to skip."},"posted_after":{"type":"string","description":"ISO date or relative (\"7 days ago\")."},"posted_before":{"type":"string","description":"ISO date or relative."},"include_company_details":{"type":"boolean","default":false,"description":"Fetch each company website for logo/summary/social links (one extra request per company)."},"geocode":{"type":"boolean","default":false,"description":"Geocode locations via Nominatim (lat/lon; ~1.1s per distinct location)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["companies_include"]}}}}}},"/bayut-listings/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bayut Listings & Agents","operationId":"get_bayut_listings","parameters":[{"name":"deal_type","in":"query","required":false,"description":"for_sale or for_rent.","schema":{"type":"string","default":"for_sale"}},{"name":"location","in":"query","required":false,"description":"Free-text Bayut location (e.g. \"Dubai Marina\", \"Palm Jumeirah\"). Empty = all UAE. Unknown location returns 404.","schema":{"type":"string","default":"Dubai Marina"}},{"name":"min_price","in":"query","required":false,"description":"Minimum price in AED.","schema":{"type":"integer"}},{"name":"max_price","in":"query","required":false,"description":"Maximum price in AED.","schema":{"type":"integer"}},{"name":"residential_property_type","in":"query","required":false,"description":"Comma list: apartments, villas, townhouses, penthouses, villa-compound, hotel-apartments, residential-plots, ...","schema":{"type":"string"}},{"name":"commercial_property_type","in":"query","required":false,"description":"Comma list: offices, shops, warehouses, labour-camps, commercial-villas, ...","schema":{"type":"string"}},{"name":"rent_frequency","in":"query","required":false,"description":"for_rent only: any, yearly, monthly, weekly, daily.","schema":{"type":"string","default":"any"}},{"name":"bedroom_count","in":"query","required":false,"description":"Comma list: studio, 1, 2, 3, ..., 7+.","schema":{"type":"string"}},{"name":"bathroom_count","in":"query","required":false,"description":"Comma list: 1, 2, 3, ..., 7+.","schema":{"type":"string"}},{"name":"min_area","in":"query","required":false,"description":"Minimum area, sq ft.","schema":{"type":"integer"}},{"name":"max_area","in":"query","required":false,"description":"Maximum area, sq ft.","schema":{"type":"integer"}},{"name":"developer","in":"query","required":false,"description":"Developer/builder name (matched against Bayut agencies).","schema":{"type":"string"}},{"name":"agent","in":"query","required":false,"description":"Agent or agency name(s) to filter listings by (exact Bayut spelling).","schema":{"type":"string"}},{"name":"keywords","in":"query","required":false,"description":"Free-text keywords (e.g. \"sea view\").","schema":{"type":"string"}},{"name":"with_floor_plans","in":"query","required":false,"description":"Only listings that have floor plans.","schema":{"type":"boolean","default":false}},{"name":"search_agents","in":"query","required":false,"description":"Switch to the agent/agency directory instead of listings.","schema":{"type":"boolean","default":false}},{"name":"agents_type","in":"query","required":false,"description":"With search_agents: agents or agencies.","schema":{"type":"string","default":"agents"}},{"name":"agents_location","in":"query","required":false,"description":"With search_agents: free-text location the agents serve.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Bayut Listings & Agents","operationId":"post_bayut_listings","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"deal_type":{"type":"string","default":"for_sale","description":"for_sale or for_rent."},"location":{"type":"string","default":"Dubai Marina","description":"Free-text Bayut location (e.g. \"Dubai Marina\", \"Palm Jumeirah\"). Empty = all UAE. Unknown location returns 404."},"min_price":{"type":"integer","description":"Minimum price in AED."},"max_price":{"type":"integer","description":"Maximum price in AED."},"residential_property_type":{"type":"string","description":"Comma list: apartments, villas, townhouses, penthouses, villa-compound, hotel-apartments, residential-plots, ..."},"commercial_property_type":{"type":"string","description":"Comma list: offices, shops, warehouses, labour-camps, commercial-villas, ..."},"rent_frequency":{"type":"string","default":"any","description":"for_rent only: any, yearly, monthly, weekly, daily."},"bedroom_count":{"type":"string","description":"Comma list: studio, 1, 2, 3, ..., 7+."},"bathroom_count":{"type":"string","description":"Comma list: 1, 2, 3, ..., 7+."},"min_area":{"type":"integer","description":"Minimum area, sq ft."},"max_area":{"type":"integer","description":"Maximum area, sq ft."},"developer":{"type":"string","description":"Developer/builder name (matched against Bayut agencies)."},"agent":{"type":"string","description":"Agent or agency name(s) to filter listings by (exact Bayut spelling)."},"keywords":{"type":"string","description":"Free-text keywords (e.g. \"sea view\")."},"with_floor_plans":{"type":"boolean","default":false,"description":"Only listings that have floor plans."},"search_agents":{"type":"boolean","default":false,"description":"Switch to the agent/agency directory instead of listings."},"agents_type":{"type":"string","default":"agents","description":"With search_agents: agents or agencies."},"agents_location":{"type":"string","description":"With search_agents: free-text location the agents serve."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/brazil-real-estate/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Brazil Real Estate","operationId":"get_brazil_real_estate","parameters":[{"name":"state","in":"query","required":true,"description":"2-letter Brazilian state (UF), e.g. sp, rj, mg.","schema":{"type":"string","default":"sp"}},{"name":"city","in":"query","required":false,"description":"City slug, e.g. sao-paulo, belo-horizonte. Empty = the state capital / whole state.","schema":{"type":"string","default":"sao-paulo"}},{"name":"region","in":"query","required":false,"description":"Optional metropolitan-region slug.","schema":{"type":"string"}},{"name":"transaction_type","in":"query","required":false,"description":"sale, rent or vacation (vacation = Airbnb stays).","schema":{"type":"string","default":"sale"}},{"name":"property_type","in":"query","required":false,"description":"all, apartments, houses, land or commercial.","schema":{"type":"string","default":"all"}},{"name":"sources","in":"query","required":false,"description":"all (OLX + QuintoAndar), olx or quintoandar. Vacation always uses Airbnb. ImovelWeb needs a browser and is not offered.","schema":{"type":"string","default":"all"}},{"name":"price_min","in":"query","required":false,"description":"Minimum price in BRL.","schema":{"type":"integer"}},{"name":"price_max","in":"query","required":false,"description":"Maximum price in BRL.","schema":{"type":"integer"}},{"name":"bedrooms_min","in":"query","required":false,"description":"Minimum bedrooms (1-5).","schema":{"type":"integer"}},{"name":"bathrooms_min","in":"query","required":false,"description":"Minimum bathrooms (1-5).","schema":{"type":"integer"}},{"name":"area_min","in":"query","required":false,"description":"Minimum area in m2.","schema":{"type":"integer"}},{"name":"include_description","in":"query","required":false,"description":"Fetch each listing page for description, fuller gallery, IPTU and amenities (one extra request per row; slower).","schema":{"type":"boolean","default":false}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Brazil Real Estate","operationId":"post_brazil_real_estate","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"string","default":"sp","description":"2-letter Brazilian state (UF), e.g. sp, rj, mg."},"city":{"type":"string","default":"sao-paulo","description":"City slug, e.g. sao-paulo, belo-horizonte. Empty = the state capital / whole state."},"region":{"type":"string","description":"Optional metropolitan-region slug."},"transaction_type":{"type":"string","default":"sale","description":"sale, rent or vacation (vacation = Airbnb stays)."},"property_type":{"type":"string","default":"all","description":"all, apartments, houses, land or commercial."},"sources":{"type":"string","default":"all","description":"all (OLX + QuintoAndar), olx or quintoandar. Vacation always uses Airbnb. ImovelWeb needs a browser and is not offered."},"price_min":{"type":"integer","description":"Minimum price in BRL."},"price_max":{"type":"integer","description":"Maximum price in BRL."},"bedrooms_min":{"type":"integer","description":"Minimum bedrooms (1-5)."},"bathrooms_min":{"type":"integer","description":"Minimum bathrooms (1-5)."},"area_min":{"type":"integer","description":"Minimum area in m2."},"include_description":{"type":"boolean","default":false,"description":"Fetch each listing page for description, fuller gallery, IPTU and amenities (one extra request per row; slower)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["state"]}}}}}},"/builtwith/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"BuiltWith Technology Profile","operationId":"get_builtwith","parameters":[{"name":"domains","in":"query","required":true,"description":"A bare domain (e.g. \"apify.com\"). One tech-profile record; next_cursor always null.","schema":{"type":"string","default":"apify.com"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"scrape_technologies","in":"query","required":false,"description":"Technology block. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"scrape_company","in":"query","required":false,"description":"Company block. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"scrape_meta","in":"query","required":false,"description":"Meta block. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"BuiltWith Technology Profile","operationId":"post_builtwith","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domains":{"type":"string","default":"apify.com","description":"A bare domain (e.g. \"apify.com\"). One tech-profile record; next_cursor always null."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"scrape_technologies":{"type":"boolean","default":true,"description":"Technology block. Locked in cursor."},"scrape_company":{"type":"boolean","default":true,"description":"Company block. Locked in cursor."},"scrape_meta":{"type":"boolean","default":true,"description":"Meta block. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["domains"]}}}}}},"/capterra/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Capterra","operationId":"get_capterra","parameters":[{"name":"start_urls","in":"query","required":true,"description":"Capterra category/listing URL(s) or product URL(s) (/p/<id>/<slug>/). GET: first only. POST: JSON array.","schema":{"type":"string","default":"https://www.capterra.com/business-intelligence-software/","format":"uri"}},{"name":"include_reviews","in":"query","required":false,"description":"Attach reviews to each product.","schema":{"type":"boolean","default":true}},{"name":"reviews_only","in":"query","required":false,"description":"Return only review rows (implies include_reviews).","schema":{"type":"boolean","default":false}},{"name":"end_page_for_reviews","in":"query","required":false,"description":"Last reviews page to read per product (25 reviews/page; 0 = all).","schema":{"type":"integer","default":1}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Route the browser through the platform proxy (default: false - Cloudflare often challenges shared proxy pools, and the proxied run is slower).","schema":{"type":"boolean","default":false}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Capterra","operationId":"post_capterra","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"start_urls":{"type":"string","default":"https://www.capterra.com/business-intelligence-software/","format":"uri","description":"Capterra category/listing URL(s) or product URL(s) (/p/<id>/<slug>/). GET: first only. POST: JSON array."},"include_reviews":{"type":"boolean","default":true,"description":"Attach reviews to each product."},"reviews_only":{"type":"boolean","default":false,"description":"Return only review rows (implies include_reviews)."},"end_page_for_reviews":{"type":"integer","default":1,"description":"Last reviews page to read per product (25 reviews/page; 0 = all)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":false,"description":"Route the browser through the platform proxy (default: false - Cloudflare often challenges shared proxy pools, and the proxied run is slower)."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["start_urls"]}}}}}},"/career-site-jobs/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Career-Site Job Listings","operationId":"get_career_site_jobs","parameters":[{"name":"cids","in":"query","required":true,"description":"ADP company cid(s) (\"cid|ccId|name\"). v2 paginates one cid per page. POST: JSON array.","schema":{"type":"string","default":"7dba3b3a-988b-4536-970e-dff855707ff9|9200056745330_2|Kintegra Health"}},{"name":"time_range","in":"query","required":false,"description":"Window on date_posted. Locked in cursor.","schema":{"type":"string","default":"6m","enum":["1h","24h","7d","6m"]}},{"name":"title_search","in":"query","required":false,"description":"Comma-separated title terms. Locked in cursor.","schema":{"type":"string"}},{"name":"enable_geocoding","in":"query","required":false,"description":"OpenStreetMap geocoding. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"per_cid_max","in":"query","required":false,"description":"Max jobs per cid. Locked in cursor.","schema":{"type":"integer","default":200}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Career-Site Job Listings","operationId":"post_career_site_jobs","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"cids":{"type":"string","default":"7dba3b3a-988b-4536-970e-dff855707ff9|9200056745330_2|Kintegra Health","description":"ADP company cid(s) (\"cid|ccId|name\"). v2 paginates one cid per page. POST: JSON array."},"time_range":{"type":"string","default":"6m","enum":["1h","24h","7d","6m"],"description":"Window on date_posted. Locked in cursor."},"title_search":{"type":"string","description":"Comma-separated title terms. Locked in cursor."},"enable_geocoding":{"type":"boolean","default":false,"description":"OpenStreetMap geocoding. Locked in cursor."},"per_cid_max":{"type":"integer","default":200,"description":"Max jobs per cid. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["cids"]}}}}}},"/carfax/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Carfax Vehicle Search","operationId":"get_carfax","parameters":[{"name":"zipcode","in":"query","required":true,"description":"US ZIP for the search (or use vins). First call only; locked in cursor.","schema":{"type":"string","default":"10001"}},{"name":"type","in":"query","required":false,"description":"Vehicle condition. Locked in cursor.","schema":{"type":"string","default":"used","enum":["used","new"]}},{"name":"sort","in":"query","required":false,"description":"Sort order. Locked in cursor.","schema":{"type":"string","default":"BEST","enum":["BEST","PRICE_ASC","PRICE_DESC","MILEAGE_ASC","YEAR_DESC"]}},{"name":"maker","in":"query","required":false,"description":"Make filter. Locked in cursor.","schema":{"type":"string"}},{"name":"model","in":"query","required":false,"description":"Model filter. Locked in cursor.","schema":{"type":"string"}},{"name":"price_under","in":"query","required":false,"description":"Max price. Locked in cursor.","schema":{"type":"integer"}},{"name":"vins","in":"query","required":false,"description":"Comma-separated VINs for lookup mode (alias: vin).","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Carfax Vehicle Search","operationId":"post_carfax","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"zipcode":{"type":"string","default":"10001","description":"US ZIP for the search (or use vins). First call only; locked in cursor."},"type":{"type":"string","default":"used","enum":["used","new"],"description":"Vehicle condition. Locked in cursor."},"sort":{"type":"string","default":"BEST","enum":["BEST","PRICE_ASC","PRICE_DESC","MILEAGE_ASC","YEAR_DESC"],"description":"Sort order. Locked in cursor."},"maker":{"type":"string","description":"Make filter. Locked in cursor."},"model":{"type":"string","description":"Model filter. Locked in cursor."},"price_under":{"type":"integer","description":"Max price. Locked in cursor."},"vins":{"type":"string","description":"Comma-separated VINs for lookup mode (alias: vin)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["zipcode"]}}}}}},"/cargurus/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"CarGurus","operationId":"get_cargurus","parameters":[{"name":"zipcode","in":"query","required":true,"description":"5-digit US ZIP code to search around.","schema":{"type":"string","default":"10001"}},{"name":"make","in":"query","required":true,"description":"Car make, e.g. toyota, ford, honda, mercedes-benz (119 makes supported; unknown makes return 400 with the list).","schema":{"type":"string","default":"toyota"}},{"name":"model","in":"query","required":false,"description":"Optional model filter, e.g. Camry (matched client-side against the make listing).","schema":{"type":"string"}},{"name":"condition","in":"query","required":false,"description":"used (new-car inventory is not available).","schema":{"type":"string","default":"used"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true). CarGurus 406s non-US IPs, so a US residential exit is used per run; direct is blocked.","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"CarGurus","operationId":"post_cargurus","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"zipcode":{"type":"string","default":"10001","description":"5-digit US ZIP code to search around."},"make":{"type":"string","default":"toyota","description":"Car make, e.g. toyota, ford, honda, mercedes-benz (119 makes supported; unknown makes return 400 with the list)."},"model":{"type":"string","description":"Optional model filter, e.g. Camry (matched client-side against the make listing)."},"condition":{"type":"string","default":"used","description":"used (new-car inventory is not available)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true). CarGurus 406s non-US IPs, so a US residential exit is used per run; direct is blocked."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["zipcode","make"]}}}}}},"/cars-com/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Cars.com","operationId":"get_cars_com","parameters":[{"name":"start_urls","in":"query","required":false,"description":"Cars.com search-results URL(s) (/shopping/results/?...). Optional if filters below are given. Direct /vehicledetail/ URLs are not supported.","schema":{"type":"string","format":"uri"}},{"name":"zip","in":"query","required":false,"description":"5-digit ZIP code to search around.","schema":{"type":"string","default":"60606"}},{"name":"maximum_distance","in":"query","required":false,"description":"Search radius in miles.","schema":{"type":"integer","default":50}},{"name":"makes","in":"query","required":false,"description":"Comma-separated make slugs, e.g. toyota,honda.","schema":{"type":"string","default":"audi"}},{"name":"models","in":"query","required":false,"description":"Comma-separated model slugs, e.g. toyota-camry.","schema":{"type":"string"}},{"name":"trims","in":"query","required":false,"description":"Full trim slugs \"<make>-<model>-<trim>\", e.g. toyota-camry-le.","schema":{"type":"string"}},{"name":"stock_type","in":"query","required":false,"description":"new, used or cpo.","schema":{"type":"string"}},{"name":"year_min","in":"query","required":false,"description":"Minimum model year.","schema":{"type":"integer"}},{"name":"year_max","in":"query","required":false,"description":"Maximum model year.","schema":{"type":"integer"}},{"name":"list_price_min","in":"query","required":false,"description":"Minimum list price (USD).","schema":{"type":"integer"}},{"name":"list_price_max","in":"query","required":false,"description":"Maximum list price (USD).","schema":{"type":"integer"}},{"name":"sort","in":"query","required":false,"description":"best_match_desc, price_asc, price_desc, mileage_asc, mileage_desc, distance_asc, year_asc, year_desc, newest.","schema":{"type":"string","default":"best_match_desc"}},{"name":"keyword","in":"query","required":false,"description":"Free-text search (best effort).","schema":{"type":"string"}},{"name":"get_contacts","in":"query","required":false,"description":"Resolve the dealer phone number for each listing (one extra request per row).","schema":{"type":"boolean","default":false}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Cars.com","operationId":"post_cars_com","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"start_urls":{"type":"string","format":"uri","description":"Cars.com search-results URL(s) (/shopping/results/?...). Optional if filters below are given. Direct /vehicledetail/ URLs are not supported."},"zip":{"type":"string","default":"60606","description":"5-digit ZIP code to search around."},"maximum_distance":{"type":"integer","default":50,"description":"Search radius in miles."},"makes":{"type":"string","default":"audi","description":"Comma-separated make slugs, e.g. toyota,honda."},"models":{"type":"string","description":"Comma-separated model slugs, e.g. toyota-camry."},"trims":{"type":"string","description":"Full trim slugs \"<make>-<model>-<trim>\", e.g. toyota-camry-le."},"stock_type":{"type":"string","description":"new, used or cpo."},"year_min":{"type":"integer","description":"Minimum model year."},"year_max":{"type":"integer","description":"Maximum model year."},"list_price_min":{"type":"integer","description":"Minimum list price (USD)."},"list_price_max":{"type":"integer","description":"Maximum list price (USD)."},"sort":{"type":"string","default":"best_match_desc","description":"best_match_desc, price_asc, price_desc, mileage_asc, mileage_desc, distance_asc, year_asc, year_desc, newest."},"keyword":{"type":"string","description":"Free-text search (best effort)."},"get_contacts":{"type":"boolean","default":false,"description":"Resolve the dealer phone number for each listing (one extra request per row)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/cheerio-scraper/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Cheerio Scraper","operationId":"get_cheerio_scraper","parameters":[{"name":"start_urls","in":"query","required":true,"description":"Absolute http(s) URL(s) to start crawling from (comma or newline separated). Non-public hosts are rejected.","schema":{"type":"string","default":"https://crawlee.dev/js"}},{"name":"globs","in":"query","required":false,"description":"Glob patterns (one per line) a link URL must match to be crawled, e.g. https://crawlee.dev/js/*/*. Empty = stay on the start URL hostnames.","schema":{"type":"string"}},{"name":"excludes","in":"query","required":false,"description":"Glob patterns (one per line) to skip. Images, PDFs and other binary files are always skipped.","schema":{"type":"string"}},{"name":"link_selector","in":"query","required":false,"description":"CSS selector for the links to follow.","schema":{"type":"string","default":"a[href]"}},{"name":"max_crawling_depth","in":"query","required":false,"description":"Link depth from the start URLs (0 = unlimited).","schema":{"type":"integer","default":0}},{"name":"respect_robots_txt","in":"query","required":false,"description":"Skip pages disallowed by robots.txt.","schema":{"type":"boolean","default":true}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true).","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Cheerio Scraper","operationId":"post_cheerio_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"start_urls":{"type":"string","default":"https://crawlee.dev/js","description":"Absolute http(s) URL(s) to start crawling from (comma or newline separated). Non-public hosts are rejected."},"globs":{"type":"string","description":"Glob patterns (one per line) a link URL must match to be crawled, e.g. https://crawlee.dev/js/*/*. Empty = stay on the start URL hostnames."},"excludes":{"type":"string","description":"Glob patterns (one per line) to skip. Images, PDFs and other binary files are always skipped."},"link_selector":{"type":"string","default":"a[href]","description":"CSS selector for the links to follow."},"max_crawling_depth":{"type":"integer","default":0,"description":"Link depth from the start URLs (0 = unlimited)."},"respect_robots_txt":{"type":"boolean","default":true,"description":"Skip pages disallowed by robots.txt."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["start_urls"]}}}}}},"/chrome-web-store/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Chrome Web Store","operationId":"get_chrome_web_store","parameters":[{"name":"query","in":"query","required":false,"description":"Search keyword (search mode). One page of extensions per call.","schema":{"type":"string","default":"ai"}},{"name":"urls","in":"query","required":false,"description":"A category/listing/search URL (url mode).","schema":{"type":"string","format":"uri"}},{"name":"mode","in":"query","required":false,"description":"search | url. Locked in cursor (via built URL).","schema":{"type":"string","default":"search","enum":["search","url"]}},{"name":"item_types","in":"query","required":false,"description":"EXTENSION/THEME filter. Locked in cursor.","schema":{"type":"string"}},{"name":"filter_by","in":"query","required":false,"description":"featured/establishedPublisher filter. Locked in cursor.","schema":{"type":"string"}},{"name":"minimal_rating","in":"query","required":false,"description":"Min rating filter. Locked in cursor.","schema":{"type":"integer","default":0}},{"name":"extract_manifest","in":"query","required":false,"description":"Include full manifest. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Chrome Web Store","operationId":"post_chrome_web_store","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","default":"ai","description":"Search keyword (search mode). One page of extensions per call."},"urls":{"type":"string","format":"uri","description":"A category/listing/search URL (url mode)."},"mode":{"type":"string","default":"search","enum":["search","url"],"description":"search | url. Locked in cursor (via built URL)."},"item_types":{"type":"string","description":"EXTENSION/THEME filter. Locked in cursor."},"filter_by":{"type":"string","description":"featured/establishedPublisher filter. Locked in cursor."},"minimal_rating":{"type":"integer","default":0,"description":"Min rating filter. Locked in cursor."},"extract_manifest":{"type":"boolean","default":false,"description":"Include full manifest. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/chrono24/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Chrono24","operationId":"get_chrono24","parameters":[{"name":"start_urls","in":"query","required":true,"description":"Chrono24 brand / model / filtered search result page URL(s) (comma or whitespace separated). Filters and sort in the URL are respected.","schema":{"type":"string","default":"https://www.chrono24.com/rolex/index.htm"}},{"name":"page_size","in":"query","required":false,"description":"Listings per result page: 30, 60 or 120 (unless the URL already sets pageSize).","schema":{"type":"integer","default":120}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true). Cloudflare 403s some exits; each request retries on a fresh exit IP.","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Chrono24","operationId":"post_chrono24","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"start_urls":{"type":"string","default":"https://www.chrono24.com/rolex/index.htm","description":"Chrono24 brand / model / filtered search result page URL(s) (comma or whitespace separated). Filters and sort in the URL are respected."},"page_size":{"type":"integer","default":120,"description":"Listings per result page: 30, 60 or 120 (unless the URL already sets pageSize)."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true). Cloudflare 403s some exits; each request retries on a fresh exit IP."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["start_urls"]}}}}}},"/contact-extractor/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Contact Extractor","operationId":"get_contact_extractor","parameters":[{"name":"urls","in":"query","required":true,"description":"Start URL(s) to crawl. v2 paginates one start URL per page. POST: JSON array.","schema":{"type":"string","default":"https://apify.com/contact","format":"uri"}},{"name":"max_depth","in":"query","required":false,"description":"BFS crawl depth. Locked in cursor.","schema":{"type":"integer","default":2}},{"name":"same_domain","in":"query","required":false,"description":"Restrict to the start domain. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"only_emails","in":"query","required":false,"description":"Return only emails. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"per_site_max","in":"query","required":false,"description":"Max pages crawled per start URL. Locked in cursor.","schema":{"type":"integer","default":30}},{"name":"use_playwright_fallback","in":"query","required":false,"description":"Render JS-heavy pages with Playwright. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Contact Extractor","operationId":"post_contact_extractor","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://apify.com/contact","format":"uri","description":"Start URL(s) to crawl. v2 paginates one start URL per page. POST: JSON array."},"max_depth":{"type":"integer","default":2,"description":"BFS crawl depth. Locked in cursor."},"same_domain":{"type":"boolean","default":true,"description":"Restrict to the start domain. Locked in cursor."},"only_emails":{"type":"boolean","default":false,"description":"Return only emails. Locked in cursor."},"per_site_max":{"type":"integer","default":30,"description":"Max pages crawled per start URL. Locked in cursor."},"use_playwright_fallback":{"type":"boolean","default":true,"description":"Render JS-heavy pages with Playwright. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/craigslist/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Craigslist","operationId":"get_craigslist","parameters":[{"name":"start_urls","in":"query","required":true,"description":"Craigslist search-result URL(s) (build the city / category / keyword / filters in the browser and paste the URL), or single /view/d/ listing URLs. One search URL yields at most ~350 listings; add more start URLs for more.","schema":{"type":"string","default":"https://miami.craigslist.org/search/sss?query=furniture"}},{"name":"include_body","in":"query","required":false,"description":"Include the Description and Body fields.","schema":{"type":"boolean","default":true}},{"name":"include_attributes","in":"query","required":false,"description":"Include the Attributes dict and Condition.","schema":{"type":"boolean","default":true}},{"name":"include_images","in":"query","required":false,"description":"Include the Image URLs array.","schema":{"type":"boolean","default":true}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true). Craigslist blocks direct / datacenter IPs, so a residential proxy is required.","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Craigslist","operationId":"post_craigslist","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"start_urls":{"type":"string","default":"https://miami.craigslist.org/search/sss?query=furniture","description":"Craigslist search-result URL(s) (build the city / category / keyword / filters in the browser and paste the URL), or single /view/d/ listing URLs. One search URL yields at most ~350 listings; add more start URLs for more."},"include_body":{"type":"boolean","default":true,"description":"Include the Description and Body fields."},"include_attributes":{"type":"boolean","default":true,"description":"Include the Attributes dict and Condition."},"include_images":{"type":"boolean","default":true,"description":"Include the Image URLs array."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true). Craigslist blocks direct / datacenter IPs, so a residential proxy is required."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["start_urls"]}}}}}},"/dealroom/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Dealroom","operationId":"get_dealroom","parameters":[{"name":"start_urls","in":"query","required":true,"description":"Dealroom URL(s), comma or whitespace separated: a company profile (/companies/<slug>), a curated list (/lists/<id>, uncapped) or a filtered directory (/companies/f/<key>/<value>/...; anonymous access is capped at the first 6 results by Dealroom).","schema":{"type":"string","default":"https://app.dealroom.co/lists/17482"}},{"name":"max_items","in":"query","required":false,"description":"Max companies per start URL. Locked in cursor.","schema":{"type":"integer","default":50}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sort field for filter URLs (prefix - = descending).","schema":{"type":"string","default":"-startup_ranking_rating"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true).","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Dealroom","operationId":"post_dealroom","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"start_urls":{"type":"string","default":"https://app.dealroom.co/lists/17482","description":"Dealroom URL(s), comma or whitespace separated: a company profile (/companies/<slug>), a curated list (/lists/<id>, uncapped) or a filtered directory (/companies/f/<key>/<value>/...; anonymous access is capped at the first 6 results by Dealroom)."},"max_items":{"type":"integer","default":50,"description":"Max companies per start URL. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"sort":{"type":"string","default":"-startup_ranking_rating","description":"Sort field for filter URLs (prefix - = descending)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["start_urls"]}}}}}},"/domain-com-au/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Domain.com.au","operationId":"get_domain_com_au","parameters":[{"name":"start_urls","in":"query","required":false,"description":"domain.com.au search URL(s) (/sale, /rent, /sold-listings; location, excludeunderoffer, price and bedrooms are read from them) or single listing URLs. Use this OR location.","schema":{"type":"string","default":"https://www.domain.com.au/sale/sydney-nsw-2000/?excludeunderoffer=1"}},{"name":"location","in":"query","required":false,"description":"Location(s), semicolon-separated: Bondi NSW 2026, bondi-nsw-2026, 2026 or NSW. Used when start_urls is empty.","schema":{"type":"string"}},{"name":"sale_type","in":"query","required":false,"description":"buy, rent or sold (used with location).","schema":{"type":"string","default":"buy","enum":["buy","rent","sold"]}},{"name":"price_min","in":"query","required":false,"description":"Minimum price in AUD.","schema":{"type":"integer"}},{"name":"price_max","in":"query","required":false,"description":"Maximum price in AUD.","schema":{"type":"integer"}},{"name":"bedrooms","in":"query","required":false,"description":"Minimum bedrooms.","schema":{"type":"string","default":"any","enum":["any","1+","2+","3+","4+","5+"]}},{"name":"bathrooms","in":"query","required":false,"description":"Minimum bathrooms.","schema":{"type":"string","default":"any","enum":["any","1+","2+","3+","4+","5+"]}},{"name":"parking","in":"query","required":false,"description":"Minimum car spaces.","schema":{"type":"string","default":"any","enum":["any","1+","2+","3+","4+","5+"]}},{"name":"property_types","in":"query","required":false,"description":"Comma-separated dwelling types: APARTMENT, HOUSE, TOWNHOUSE, LAND, RURAL, RETIREMENT, VACANT_LAND.","schema":{"type":"string"}},{"name":"features","in":"query","required":false,"description":"Comma-separated keywords sent to the search.","schema":{"type":"string"}},{"name":"exclude_under_offer","in":"query","required":false,"description":"Drop under-contract / deposit-taken listings.","schema":{"type":"boolean","default":false}},{"name":"include_surrounding_suburbs","in":"query","required":false,"description":"Include surrounding suburbs.","schema":{"type":"boolean","default":false}},{"name":"enrich_data","in":"query","required":false,"description":"Fetch the full property-details record for each result (under `detail`). v2 always does.","schema":{"type":"boolean","default":true}},{"name":"maximize_coverage","in":"query","required":false,"description":"Slice searches over 200 results by price band (many more requests).","schema":{"type":"boolean","default":false}},{"name":"max_items","in":"query","required":false,"description":"Max listings (v2 capped at 2000). Locked in cursor.","schema":{"type":"integer","default":50}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true).","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Domain.com.au","operationId":"post_domain_com_au","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"start_urls":{"type":"string","default":"https://www.domain.com.au/sale/sydney-nsw-2000/?excludeunderoffer=1","description":"domain.com.au search URL(s) (/sale, /rent, /sold-listings; location, excludeunderoffer, price and bedrooms are read from them) or single listing URLs. Use this OR location."},"location":{"type":"string","description":"Location(s), semicolon-separated: Bondi NSW 2026, bondi-nsw-2026, 2026 or NSW. Used when start_urls is empty."},"sale_type":{"type":"string","default":"buy","enum":["buy","rent","sold"],"description":"buy, rent or sold (used with location)."},"price_min":{"type":"integer","description":"Minimum price in AUD."},"price_max":{"type":"integer","description":"Maximum price in AUD."},"bedrooms":{"type":"string","default":"any","enum":["any","1+","2+","3+","4+","5+"],"description":"Minimum bedrooms."},"bathrooms":{"type":"string","default":"any","enum":["any","1+","2+","3+","4+","5+"],"description":"Minimum bathrooms."},"parking":{"type":"string","default":"any","enum":["any","1+","2+","3+","4+","5+"],"description":"Minimum car spaces."},"property_types":{"type":"string","description":"Comma-separated dwelling types: APARTMENT, HOUSE, TOWNHOUSE, LAND, RURAL, RETIREMENT, VACANT_LAND."},"features":{"type":"string","description":"Comma-separated keywords sent to the search."},"exclude_under_offer":{"type":"boolean","default":false,"description":"Drop under-contract / deposit-taken listings."},"include_surrounding_suburbs":{"type":"boolean","default":false,"description":"Include surrounding suburbs."},"enrich_data":{"type":"boolean","default":true,"description":"Fetch the full property-details record for each result (under `detail`). v2 always does."},"maximize_coverage":{"type":"boolean","default":false,"description":"Slice searches over 200 results by price band (many more requests)."},"max_items":{"type":"integer","default":50,"description":"Max listings (v2 capped at 2000). Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/eventbrite-scraper/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Eventbrite Scraper","operationId":"get_eventbrite_scraper","parameters":[{"name":"start_urls","in":"query","required":true,"description":"Listing/search URL or direct /e/ event URL. Required first call in url mode.","schema":{"type":"string","default":"https://www.eventbrite.com/d/fl--miami-beach/all-events/"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"search_mode","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"url","enum":["url","guided"]}},{"name":"location","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"Miami Beach, FL"}},{"name":"date_range","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"all-events","enum":["all-events","today","this-week","this-weekend","this-month"]}},{"name":"keywords","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string"}},{"name":"max_page","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":2}},{"name":"concurrency","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer","default":5}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Eventbrite Scraper","operationId":"post_eventbrite_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"start_urls":{"type":"string","default":"https://www.eventbrite.com/d/fl--miami-beach/all-events/","description":"Listing/search URL or direct /e/ event URL. Required first call in url mode."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"search_mode":{"type":"string","default":"url","enum":["url","guided"],"description":"Locked in cursor."},"location":{"type":"string","default":"Miami Beach, FL","description":"Locked in cursor."},"date_range":{"type":"string","default":"all-events","enum":["all-events","today","this-week","this-weekend","this-month"],"description":"Locked in cursor."},"keywords":{"type":"string","description":"Locked in cursor."},"max_page":{"type":"integer","default":2,"description":"Locked in cursor."},"concurrency":{"type":"integer","default":5,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["start_urls"]}}}}}},"/fragrantica-com-scraper/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Fragrantica.com Scraper","operationId":"get_fragrantica_com_scraper","parameters":[{"name":"urls","in":"query","required":true,"description":"Fragrantica perfume URL or query text. Required first call.","schema":{"type":"string","default":"perfume"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Maximum perfumes returned (locked in cursor).","schema":{"type":"integer","default":20}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Fragrantica.com Scraper","operationId":"post_fragrantica_com_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"perfume","description":"Fragrantica perfume URL or query text. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_items":{"type":"integer","default":20,"description":"Maximum perfumes returned (locked in cursor)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/funda-nl-scraper/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Funda.nl Scraper","operationId":"get_funda_nl_scraper","parameters":[{"name":"search_urls","in":"query","required":true,"description":"Funda search URL or area token. Required first call.","schema":{"type":"string","default":"https://www.funda.nl/en/zoeken/koop?selected_area=%5B%22bergen-li%22%5D&search_result=1"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Maximum listings returned (locked in cursor).","schema":{"type":"integer","default":50}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Funda.nl Scraper","operationId":"post_funda_nl_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"search_urls":{"type":"string","default":"https://www.funda.nl/en/zoeken/koop?selected_area=%5B%22bergen-li%22%5D&search_result=1","description":"Funda search URL or area token. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_items":{"type":"integer","default":50,"description":"Maximum listings returned (locked in cursor)."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["search_urls"]}}}}}},"/goodreads-review-scraper/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Goodreads Review Scraper","operationId":"get_goodreads_review_scraper","parameters":[{"name":"book_urls","in":"query","required":true,"description":"Goodreads book URL. Required first call.","schema":{"type":"string","default":"https://www.goodreads.com/book/show/26032825"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"max_items","in":"query","required":false,"description":"Maximum reviews returned per book (locked in cursor).","schema":{"type":"integer","default":50}},{"name":"page_size","in":"query","required":false,"description":"Reviews per GraphQL page (max 100, locked in cursor).","schema":{"type":"integer","default":20}},{"name":"sort_by","in":"query","required":false,"description":"Review sort mode (locked in cursor).","schema":{"type":"string","default":"popular","enum":["popular","newest","oldest"]}},{"name":"language_code","in":"query","required":false,"description":"Language code filter or \"all\" (locked in cursor).","schema":{"type":"string","default":"en"}},{"name":"review_edition","in":"query","required":false,"description":"ALL (work-level) or only_this_book (book-level), locked in cursor.","schema":{"type":"string","default":"ALL","enum":["ALL","only_this_book"]}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Goodreads Review Scraper","operationId":"post_goodreads_review_scraper","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"book_urls":{"type":"string","default":"https://www.goodreads.com/book/show/26032825","description":"Goodreads book URL. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"max_items":{"type":"integer","default":50,"description":"Maximum reviews returned per book (locked in cursor)."},"page_size":{"type":"integer","default":20,"description":"Reviews per GraphQL page (max 100, locked in cursor)."},"sort_by":{"type":"string","default":"popular","enum":["popular","newest","oldest"],"description":"Review sort mode (locked in cursor)."},"language_code":{"type":"string","default":"en","description":"Language code filter or \"all\" (locked in cursor)."},"review_edition":{"type":"string","default":"ALL","enum":["ALL","only_this_book"],"description":"ALL (work-level) or only_this_book (book-level), locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["book_urls"]}}}}}},"/greenhouse-jobs/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Greenhouse jobs","operationId":"get_greenhouse_jobs","parameters":[{"name":"boards","in":"query","required":true,"description":"Greenhouse board token or HTTPS board URL. v1 GET uses the first board; v1 POST accepts a JSON array (up to 100). v2 takes one board per cursor walk.","schema":{"type":"string","default":"stripe"}},{"name":"include_description","in":"query","required":false,"description":"Fetch descriptions, departments and offices for returned jobs only. Extra upstream calls. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"description_type","in":"query","required":false,"description":"Format of description_text when descriptions are enabled. description_html also contains source HTML.","schema":{"type":"string","default":"text","enum":["text","html"]}},{"name":"fetch_salary_data","in":"query","required":false,"description":"Fetch published pay transparency ranges only for returned jobs. Missing/unpublished salary stays null.","schema":{"type":"boolean","default":false}},{"name":"has_salary","in":"query","required":false,"description":"Only jobs with published pay ranges. Enables pay detail checks; potentially expensive. Cursor may scan more candidates than it returns. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"geocode_locations","in":"query","required":false,"description":"Requires operator GREENHOUSE_GEOCODER_URL. Shared cached coordinates; up to 10 uncached queries per call. Incomplete geocoding is reported in row warnings; no public Nominatim bulk calls.","schema":{"type":"boolean","default":false}},{"name":"include_company_details","in":"query","required":false,"description":"Legacy compatibility flag. Greenhouse supplies no LinkedIn/Crunchbase or AI enrichments; these fields stay null with either value.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use the platform proxy. Default true. Cached pages avoid repeated upstream requests.","schema":{"type":"boolean","default":true}},{"name":"title_search","in":"query","required":false,"description":"Include matches on title. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor.","schema":{"type":"string"}},{"name":"title_exclusion_search","in":"query","required":false,"description":"Exclude matches on title. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor.","schema":{"type":"string"}},{"name":"location_search","in":"query","required":false,"description":"Include matches on location. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor.","schema":{"type":"string"}},{"name":"location_exclusion_search","in":"query","required":false,"description":"Exclude matches on location. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor.","schema":{"type":"string"}},{"name":"description_search","in":"query","required":false,"description":"Include matches on title + description. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor. Description searches download the whole board with content; higher bandwidth.","schema":{"type":"string"}},{"name":"description_exclusion_search","in":"query","required":false,"description":"Exclude matches on title + description. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor. Description searches download the whole board with content; higher bandwidth.","schema":{"type":"string"}},{"name":"organization_search","in":"query","required":false,"description":"Include matches on company name. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor.","schema":{"type":"string"}},{"name":"organization_exclusion_search","in":"query","required":false,"description":"Exclude matches on company name. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor.","schema":{"type":"string"}},{"name":"domain_filter","in":"query","required":false,"description":"Include matches on source hostname. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor.","schema":{"type":"string"}},{"name":"domain_exclusion_filter","in":"query","required":false,"description":"Exclude matches on source hostname. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Greenhouse jobs","operationId":"post_greenhouse_jobs","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"boards":{"type":"string","default":"stripe","description":"Greenhouse board token or HTTPS board URL. v1 GET uses the first board; v1 POST accepts a JSON array (up to 100). v2 takes one board per cursor walk."},"include_description":{"type":"boolean","default":false,"description":"Fetch descriptions, departments and offices for returned jobs only. Extra upstream calls. Locked in cursor."},"description_type":{"type":"string","default":"text","enum":["text","html"],"description":"Format of description_text when descriptions are enabled. description_html also contains source HTML."},"fetch_salary_data":{"type":"boolean","default":false,"description":"Fetch published pay transparency ranges only for returned jobs. Missing/unpublished salary stays null."},"has_salary":{"type":"boolean","default":false,"description":"Only jobs with published pay ranges. Enables pay detail checks; potentially expensive. Cursor may scan more candidates than it returns. Locked in cursor."},"geocode_locations":{"type":"boolean","default":false,"description":"Requires operator GREENHOUSE_GEOCODER_URL. Shared cached coordinates; up to 10 uncached queries per call. Incomplete geocoding is reported in row warnings; no public Nominatim bulk calls."},"include_company_details":{"type":"boolean","default":false,"description":"Legacy compatibility flag. Greenhouse supplies no LinkedIn/Crunchbase or AI enrichments; these fields stay null with either value."},"use_proxy":{"type":"boolean","default":true,"description":"Use the platform proxy. Default true. Cached pages avoid repeated upstream requests."},"title_search":{"type":"string","description":"Include matches on title. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor."},"title_exclusion_search":{"type":"string","description":"Exclude matches on title. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor."},"location_search":{"type":"string","description":"Include matches on location. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor."},"location_exclusion_search":{"type":"string","description":"Exclude matches on location. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor."},"description_search":{"type":"string","description":"Include matches on title + description. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor. Description searches download the whole board with content; higher bandwidth."},"description_exclusion_search":{"type":"string","description":"Exclude matches on title + description. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor. Description searches download the whole board with content; higher bandwidth."},"organization_search":{"type":"string","description":"Include matches on company name. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor."},"organization_exclusion_search":{"type":"string","description":"Exclude matches on company name. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor."},"domain_filter":{"type":"string","description":"Include matches on source hostname. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor."},"domain_exclusion_filter":{"type":"string","description":"Exclude matches on source hostname. String or JSON array, up to 20 terms. Searches match whole words/phrases; :* suffix matches prefixes. Hostnames match exactly. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["boards"]}}}}}},"/industry-email/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Industry Email Scraper","operationId":"get_industry_email","parameters":[{"name":"queries","in":"query","required":true,"description":"Business type / search term. Required first call.","schema":{"type":"string","default":"dentist"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"location","in":"query","required":true,"description":"Place name or \"lat,lng\". Required first call. Locked in cursor.","schema":{"type":"string","default":"Houston, TX"}},{"name":"scrape_leads","in":"query","required":false,"description":"Crawl websites for leads. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"fetch_review_count","in":"query","required":false,"description":"Fill total_reviews. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"max_pages_per_site","in":"query","required":false,"description":"Website pages per business. Locked in cursor.","schema":{"type":"integer","default":4,"minimum":1,"maximum":10}},{"name":"only_with_website","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"only_with_email","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"min_rating","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string"}},{"name":"min_reviews","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"integer"}},{"name":"tag_filter","in":"query","required":false,"description":"Comma-separated category words. Locked in cursor.","schema":{"type":"string"}},{"name":"in_area_only","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"language","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"include_all_emails","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"include_all_phones","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"include_crawl_info","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Industry Email Scraper","operationId":"post_industry_email","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"queries":{"type":"string","default":"dentist","description":"Business type / search term. Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"location":{"type":"string","default":"Houston, TX","description":"Place name or \"lat,lng\". Required first call. Locked in cursor."},"scrape_leads":{"type":"boolean","default":true,"description":"Crawl websites for leads. Locked in cursor."},"fetch_review_count":{"type":"boolean","default":true,"description":"Fill total_reviews. Locked in cursor."},"max_pages_per_site":{"type":"integer","default":4,"minimum":1,"maximum":10,"description":"Website pages per business. Locked in cursor."},"only_with_website":{"type":"boolean","default":false,"description":"Locked in cursor."},"only_with_email":{"type":"boolean","default":false,"description":"Locked in cursor."},"min_rating":{"type":"string","description":"Locked in cursor."},"min_reviews":{"type":"integer","description":"Locked in cursor."},"tag_filter":{"type":"string","description":"Comma-separated category words. Locked in cursor."},"in_area_only":{"type":"boolean","default":false,"description":"Locked in cursor."},"language":{"type":"string","default":"en","description":"Locked in cursor."},"include_all_emails":{"type":"boolean","default":false,"description":"Locked in cursor."},"include_all_phones":{"type":"boolean","default":false,"description":"Locked in cursor."},"include_crawl_info":{"type":"boolean","default":false,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["queries","location"]}}}}}},"/internshala/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Internshala Internship Search","operationId":"get_internshala","parameters":[{"name":"job_category","in":"query","required":false,"description":"Category text, resolved via autocomplete. Locked in cursor.","schema":{"type":"string","default":"Software Development"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"work_from_home","in":"query","required":false,"description":"Remote only; ignores location. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"location","in":"query","required":false,"description":"City, used when work_from_home=false. Locked in cursor.","schema":{"type":"string"}},{"name":"part_time","in":"query","required":false,"description":"Part-time only. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"stipend","in":"query","required":false,"description":"Minimum monthly stipend (snapped). Locked in cursor.","schema":{"type":"integer"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Internshala Internship Search","operationId":"post_internshala","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"job_category":{"type":"string","default":"Software Development","description":"Category text, resolved via autocomplete. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"work_from_home":{"type":"boolean","default":true,"description":"Remote only; ignores location. Locked in cursor."},"location":{"type":"string","description":"City, used when work_from_home=false. Locked in cursor."},"part_time":{"type":"boolean","default":false,"description":"Part-time only. Locked in cursor."},"stipend":{"type":"integer","description":"Minimum monthly stipend (snapped). Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}}}}}}}},"/kariyer-net/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Kariyer.net Job Listings","operationId":"get_kariyer_net","parameters":[{"name":"urls","in":"query","required":true,"description":"kariyer.net listing URL (path filters only). One URL per walk. Required on the first call.","schema":{"type":"string","default":"https://www.kariyer.net/is-ilanlari/istanbul","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"include_logo","in":"query","required":false,"description":"Include logo_url when a real logo exists. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Kariyer.net Job Listings","operationId":"post_kariyer_net","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.kariyer.net/is-ilanlari/istanbul","format":"uri","description":"kariyer.net listing URL (path filters only). One URL per walk. Required on the first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"include_logo":{"type":"boolean","default":true,"description":"Include logo_url when a real logo exists. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/seo-audit-tool/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"SEO Audit Tool","operationId":"get_seo_audit_tool","parameters":[{"name":"urls","in":"query","required":true,"description":"Site URL to crawl and audit. Required first call.","schema":{"type":"string","default":"https://www.python.org"}},{"name":"site_page_limit","in":"query","required":false,"description":"Max audited pages for the whole walk (cap 500). Locked in cursor.","schema":{"type":"integer","default":50}},{"name":"max_depth","in":"query","required":false,"description":"Link depth from the start URL (0 = start page only, max 10). Locked in cursor.","schema":{"type":"integer","default":2}},{"name":"check_links","in":"query","required":false,"description":"Probe links and images for broken ones (the main cost of an audit). false = on-page checks only. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"max_links_checked","in":"query","required":false,"description":"Max link+image probes per page (internal links first). Pages still report their full links_count; unprobed links are never reported as broken. Locked in cursor.","schema":{"type":"integer","default":150}},{"name":"max_title_length","in":"query","required":false,"description":"is_title_enough_long upper bound. Locked in cursor.","schema":{"type":"integer","default":70}},{"name":"min_title_length","in":"query","required":false,"description":"is_title_enough_long lower bound. Locked in cursor.","schema":{"type":"integer","default":10}},{"name":"max_meta_description_length","in":"query","required":false,"description":"is_meta_description_enough_long upper bound. Locked in cursor.","schema":{"type":"integer","default":140}},{"name":"max_links_count","in":"query","required":false,"description":"is_too_enough_links threshold. Locked in cursor.","schema":{"type":"integer","default":3000}},{"name":"max_words_count","in":"query","required":false,"description":"is_content_enough_long threshold (word count <= this). Locked in cursor.","schema":{"type":"integer","default":350}},{"name":"output_links","in":"query","required":false,"description":"Add every page link as `links`. Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 2 credits per successful call. Required inputs are not needed when `cursor` is sent.","summary":"SEO Audit Tool","operationId":"post_seo_audit_tool","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://www.python.org","description":"Site URL to crawl and audit. Required first call."},"site_page_limit":{"type":"integer","default":50,"description":"Max audited pages for the whole walk (cap 500). Locked in cursor."},"max_depth":{"type":"integer","default":2,"description":"Link depth from the start URL (0 = start page only, max 10). Locked in cursor."},"check_links":{"type":"boolean","default":true,"description":"Probe links and images for broken ones (the main cost of an audit). false = on-page checks only. Locked in cursor."},"max_links_checked":{"type":"integer","default":150,"description":"Max link+image probes per page (internal links first). Pages still report their full links_count; unprobed links are never reported as broken. Locked in cursor."},"max_title_length":{"type":"integer","default":70,"description":"is_title_enough_long upper bound. Locked in cursor."},"min_title_length":{"type":"integer","default":10,"description":"is_title_enough_long lower bound. Locked in cursor."},"max_meta_description_length":{"type":"integer","default":140,"description":"is_meta_description_enough_long upper bound. Locked in cursor."},"max_links_count":{"type":"integer","default":3000,"description":"is_too_enough_links threshold. Locked in cursor."},"max_words_count":{"type":"integer","default":350,"description":"is_content_enough_long threshold (word count <= this). Locked in cursor."},"output_links":{"type":"boolean","default":false,"description":"Add every page link as `links`. Locked in cursor."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/social-media-platform-email/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Social Media Platform Email Scraper","operationId":"get_social_media_platform_email","parameters":[{"name":"keywords","in":"query","required":true,"description":"Search keyword (one per call). Required first call.","schema":{"type":"string","default":"marketing"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"platform","in":"query","required":false,"description":"Platform name or any domain. Locked in cursor.","schema":{"type":"string","default":"Instagram"}},{"name":"email_domains","in":"query","required":false,"description":"Comma-separated email domains; empty = any. Locked in cursor.","schema":{"type":"string","default":"@gmail.com"}},{"name":"location","in":"query","required":false,"description":"Optional location term(s). Locked in cursor.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Google gl=. Locked in cursor.","schema":{"type":"string","default":"us"}},{"name":"language","in":"query","required":false,"description":"Google hl=. Locked in cursor.","schema":{"type":"string","default":"en"}},{"name":"include_all_emails","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Social Media Platform Email Scraper","operationId":"post_social_media_platform_email","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"string","default":"marketing","description":"Search keyword (one per call). Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"platform":{"type":"string","default":"Instagram","description":"Platform name or any domain. Locked in cursor."},"email_domains":{"type":"string","default":"@gmail.com","description":"Comma-separated email domains; empty = any. Locked in cursor."},"location":{"type":"string","description":"Optional location term(s). Locked in cursor."},"country":{"type":"string","default":"us","description":"Google gl=. Locked in cursor."},"language":{"type":"string","default":"en","description":"Google hl=. Locked in cursor."},"include_all_emails":{"type":"boolean","default":false,"description":"Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["keywords"]}}}}}},"/website-content-crawler/":{"get":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Website Content Crawler","operationId":"get_website_content_crawler","parameters":[{"name":"urls","in":"query","required":true,"description":"Start URL of the site to crawl (one per walk). Required first call.","schema":{"type":"string","default":"https://docs.apify.com/academy/scraping-basics-javascript","format":"uri"}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page.","schema":{"type":"string"}},{"name":"page_size","in":"query","required":false,"description":"Pages returned per call. Locked in cursor.","schema":{"type":"integer","default":10,"minimum":1,"maximum":25}},{"name":"max_total_items","in":"query","required":false,"description":"Pages returned over the whole walk. Locked in cursor.","schema":{"type":"integer","default":100,"maximum":5000}},{"name":"max_crawl_depth","in":"query","required":false,"description":"Link hops from the start URL (0 = start URL only). Locked in cursor.","schema":{"type":"integer","default":1,"minimum":0,"maximum":10}},{"name":"max_crawl_pages","in":"query","required":false,"description":"Cap on pages fetched over the whole walk. Locked in cursor.","schema":{"type":"integer"}},{"name":"include_url_globs","in":"query","required":false,"description":"fnmatch patterns a followed URL must match. Locked in cursor.","schema":{"type":"string"}},{"name":"exclude_url_globs","in":"query","required":false,"description":"fnmatch patterns that exclude a URL. Locked in cursor.","schema":{"type":"string"}},{"name":"save_markdown","in":"query","required":false,"description":"Fill the markdown field. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"include_html","in":"query","required":false,"description":"Add readability HTML (large). Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"remove_elements_css_selector","in":"query","required":false,"description":"CSS selectors removed before text extraction. Locked in cursor.","schema":{"type":"string"}},{"name":"readable_text_char_threshold","in":"query","required":false,"description":"Minimum text length for a page to count. Locked in cursor.","schema":{"type":"integer","default":100}},{"name":"keep_url_fragments","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"ignore_canonical_url","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"boolean","default":false}},{"name":"custom_http_headers","in":"query","required":false,"description":"JSON object of extra request headers. Locked in cursor.","schema":{"type":"string"}},{"name":"fingerprint_profile","in":"query","required":false,"description":"Locked in cursor.","schema":{"type":"string","default":"chrome_windows","enum":["chrome_windows","chrome_macos","firefox_windows"]}},{"name":"browser_fallback","in":"query","required":false,"description":"Camoufox escalation for bot walls. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"solve_captchas","in":"query","required":false,"description":"Allow the paid CapSolver tier. Locked in cursor.","schema":{"type":"boolean","default":true}},{"name":"use_proxy","in":"query","required":false,"description":"Use Scrapier's residential proxy pool when true (default: true)","schema":{"type":"boolean","default":true}},{"name":"raw_data","in":"query","required":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes.","schema":{"type":"boolean","default":false}}]},"post":{"tags":["other"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"One page of results: {\"success\": true, \"data\": {..., \"next_cursor\": \"<token>\" | null}}. Pass next_cursor as `cursor` for the next page; each successful call costs cost_credit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true}},"additionalProperties":true}}}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"},"504":{"$ref":"#/components/responses/E504"}},"description":"Costs 1 credit per successful call. Required inputs are not needed when `cursor` is sent.","summary":"Website Content Crawler","operationId":"post_website_content_crawler","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"urls":{"type":"string","default":"https://docs.apify.com/academy/scraping-basics-javascript","format":"uri","description":"Start URL of the site to crawl (one per walk). Required first call."},"cursor":{"type":"string","description":"Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page."},"page_size":{"type":"integer","default":10,"minimum":1,"maximum":25,"description":"Pages returned per call. Locked in cursor."},"max_total_items":{"type":"integer","default":100,"maximum":5000,"description":"Pages returned over the whole walk. Locked in cursor."},"max_crawl_depth":{"type":"integer","default":1,"minimum":0,"maximum":10,"description":"Link hops from the start URL (0 = start URL only). Locked in cursor."},"max_crawl_pages":{"type":"integer","description":"Cap on pages fetched over the whole walk. Locked in cursor."},"include_url_globs":{"type":"string","description":"fnmatch patterns a followed URL must match. Locked in cursor."},"exclude_url_globs":{"type":"string","description":"fnmatch patterns that exclude a URL. Locked in cursor."},"save_markdown":{"type":"boolean","default":true,"description":"Fill the markdown field. Locked in cursor."},"include_html":{"type":"boolean","default":false,"description":"Add readability HTML (large). Locked in cursor."},"remove_elements_css_selector":{"type":"string","description":"CSS selectors removed before text extraction. Locked in cursor."},"readable_text_char_threshold":{"type":"integer","default":100,"description":"Minimum text length for a page to count. Locked in cursor."},"keep_url_fragments":{"type":"boolean","default":false,"description":"Locked in cursor."},"ignore_canonical_url":{"type":"boolean","default":false,"description":"Locked in cursor."},"custom_http_headers":{"type":"string","description":"JSON object of extra request headers. Locked in cursor."},"fingerprint_profile":{"type":"string","default":"chrome_windows","enum":["chrome_windows","chrome_macos","firefox_windows"],"description":"Locked in cursor."},"browser_fallback":{"type":"boolean","default":true,"description":"Camoufox escalation for bot walls. Locked in cursor."},"solve_captchas":{"type":"boolean","default":true,"description":"Allow the paid CapSolver tier. Locked in cursor."},"use_proxy":{"type":"boolean","default":true,"description":"Use Scrapier's residential proxy pool when true (default: true)"},"raw_data":{"type":"boolean","default":false,"description":"When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes."}},"required":["urls"]}}}}}},"/me":{"get":{"tags":["account"],"summary":"Validate an API key and return its account and credit balance (free)","operationId":"get_me","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"The account behind the key.","content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"},"key_id":{"type":"string"},"email":{"type":"string"},"name":{"type":"string","nullable":true},"credits":{"type":"object","properties":{"balance":{"type":"integer"}}},"plan":{"type":"string"}}}}}},"401":{"description":"Missing API key (send it as X-API-Key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}