From 27e85d39cad8d5d3fe4f61ee8d1a170fd3f0b9d8 Mon Sep 17 00:00:00 2001 From: Usman Barki Date: Fri, 7 Sep 2018 15:40:13 +0100 Subject: [PATCH 1/2] Update _reviews.md --- source/includes/_reviews.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/source/includes/_reviews.md b/source/includes/_reviews.md index f531909af85..83dd5ef8d9b 100644 --- a/source/includes/_reviews.md +++ b/source/includes/_reviews.md @@ -511,13 +511,20 @@ start-page | See [paging](#paging) table below for details. ## Paging -We support up to 500 reviews per request to a given directory. If you need to retrieve more than 500 reviews you can use the start-page parameter and submit multiple requests to pick up older reviews. For example with Google to fetch 1000 reviews you'd need to make two requests: +We support up to 500 reviews per request to a given directory. If you need to retrieve more than 500 reviews you can use the start-page parameter and submit multiple requests to pick up older reviews. For example with Google to fetch 1000 reviews you’d need to make two requests: 1. Without start-page (or with start-page=1) to fetch reviews 1 - 500. 2. With start-page=51 (Google returns 10 reviews per page) to fetch reviews 501 - 1000. +For directories such as DemandForce and Facebook, you will be returned next-start-page parameter with a string value in your payload. Pass that value in the start-page parameter of next request to pick up older reviews. For example with Facebook to fetch 1000 reviews you’d need to make two requests: + +1. Without start-page to fetch reviews 1 - 500. Then take the string value returned in the next-start-page parameter, and +2. Pass next-start-page parameter's string value (from the previous request) in start-page parameter of your next request to fetch reviews 501 - 1000. + ### Supported Directories -Directory | Number Reviews Per Page ---------- | ----------------------- -Google | 10 +Directory | Number Reviews Per Page +----------- | ----------------------- +Google | 10 +DemandForce | - +Facebook | - From 5f66cfcad9f977a83e532d884ae32361d958bf06 Mon Sep 17 00:00:00 2001 From: Usman Barki Date: Fri, 7 Sep 2018 15:48:58 +0100 Subject: [PATCH 2/2] Update _reviews.md --- source/includes/_reviews.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/source/includes/_reviews.md b/source/includes/_reviews.md index 83dd5ef8d9b..62241d06475 100644 --- a/source/includes/_reviews.md +++ b/source/includes/_reviews.md @@ -162,6 +162,7 @@ profile-url | Required For requests to country | Required sort | 'rating' or 'date'. By default 'date'. reviews-limit | Positive number or 'all'. By default 100. +next-page | Number for Google and a string value for the rest of directories. date-from | Date Format: Y-m-d or Y-m-d H:i:s. By default not specified. start-page | See [paging](#paging) table below for details. @@ -315,6 +316,7 @@ else "country": "USA", "date-from": null, "reviews-limit": 250, + "start-page": 51, "sort-type": "date", "api-key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } @@ -345,6 +347,7 @@ else "country": "USA", "date-from": null, "reviews-limit": 250, + "next-page": "100001023529042%3A292061516392", "sort-type": "date", "api-key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } @@ -400,6 +403,7 @@ else "country": "USA", "date-from": null, "reviews-limit": 250, + "next-page": 51, "sort-type": "date", "api-key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "parent-id": 549612293 @@ -437,6 +441,7 @@ else "country": "USA", "date-from": null, "reviews-limit": 250, + "start-page": "100001023529042%3A292061516392", "sort-type": "date", "api-key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "parent-id": 549612304 @@ -506,6 +511,7 @@ country | Required Only USA. telephone | A valid telephone number. Providing this will improve the quality of results returned. sort | 'rating' or 'date'. By default 'date'. reviews-limit | Positive number or 'all'. By default 100. +next-page | Number for Google and a string value for the rest of directories. date-from | Date Format: Y-m-d or Y-m-d H:i:s. By default not specified. start-page | See [paging](#paging) table below for details. @@ -526,5 +532,5 @@ For directories such as DemandForce and Facebook, you will be returned next-star Directory | Number Reviews Per Page ----------- | ----------------------- Google | 10 -DemandForce | - -Facebook | - +DemandForce | +Facebook |