# The current batch of sample creators (sample review stores) GET /locations/{partner\_location\_id}/creator-samples Select code sampleFetchcURL ```js const url = 'https://data.creatorain.com/partner/v1/locations/store_123/creator-samples'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```sh curl --request GET \ --url https://data.creatorain.com/partner/v1/locations/store_123/creator-samples \ --header 'Authorization: Bearer ' ``` - Production (live stores; a live key is issued per partner) - Sandbox, for integration testing (test keys, test stores) For a store with `approval_mode: sample_review`: 5 sample creators that show the range of creators the store will get, and a summary (follower range, common topics, audience). Samples are not the final list. We send `location.samples_ready` when a batch is ready. `status` is `preparing` (a batch is being prepared, `creators` is empty), `ready` (waiting for your decision) or `approved` (recruiting follows; `location.recruiting` when it starts). Public profile only: no email, phone, name or rates. EITHER CREDENTIAL: the partner key or that store’s own token. ## Authorizations - **[partnerApiKey](/partner-api/reference/#partnerapikey)** - **[storeTokenHeader](/partner-api/reference/#storetokenheader)** - **[storeTokenQuery](/partner-api/reference/#storetokenquery)** ## Parameters ### Path Parameters **partner\_location\_id** required string <= 200 characters YOUR id for the store, as you sent it to `POST /locations`. #### Example ``` store_123 ``` ## Responses ### 200 The current batch. Media typeapplication/json object **batch\_id** required string nullable **batch\_number** required integer nullable **status** required string Allowed values: preparing ready approved **prepared\_at** string format: date-time nullable **decided\_at** string format: date-time nullable **summary** object **followers\_min** integer nullable **followers\_max** integer nullable **followers\_average** integer nullable **common\_topics** Array **audience** string nullable **creators** required Array One sample creator. Public profile only. object **handle** string nullable **platforms** Array **followers** integer nullable **city** string nullable **average\_views** integer nullable **topics** Array **recent\_posts** Array object **post\_url** string **views** integer nullable #### Example ```json { "batch_id": "smp_1b4e28ba-2fa1-4d3b-a3f5-ef19b5a7633b", "batch_number": 1, "status": "preparing", "summary": { "followers_min": 7900, "followers_max": 24800, "followers_average": 14380, "common_topics": [ "food", "travel" ], "audience": "local (San Jose)" }, "creators": [ { "handle": "example_creator_2", "platforms": [ "instagram", "tiktok" ], "followers": 18200, "city": "San Jose", "average_views": 12400, "topics": [ "food" ], "recent_posts": [ { "post_url": "https://www.instagram.com/p/...", "views": 12000 } ] } ] } ``` ### 401 `unauthorized`. A missing, malformed, unknown or revoked key; or an invalid, expired or wrong-store dashboard token. One answer for every case on purpose: the holder of a bad credential learns nothing from the difference. Media typeapplication/json object **error** required object **code** required The stable value to branch on. string Allowed values: unauthorized forbidden\_ip rate\_limited validation\_error location\_already\_exists location\_not\_found location\_terminated reservation\_not\_found conflict internal\_error **message** required A human sentence. Copy, not contract; it may be reworded. string **field** The request field at fault, dotted for a nested one (`plan.term_months`). string #### Example ```json { "error": { "code": "unauthorized" } } ``` ### 404 `location_not_found`. No store of this key carries that `partner_location_id`. Media typeapplication/json object **error** required object **code** required The stable value to branch on. string Allowed values: unauthorized forbidden\_ip rate\_limited validation\_error location\_already\_exists location\_not\_found location\_terminated reservation\_not\_found conflict internal\_error **message** required A human sentence. Copy, not contract; it may be reworded. string **field** The request field at fault, dotted for a nested one (`plan.term_months`). string #### Example ```json { "error": { "code": "unauthorized" } } ``` ### 409 `conflict`. The store does not use sample review. Media typeapplication/json object **error** required object **code** required The stable value to branch on. string Allowed values: unauthorized forbidden\_ip rate\_limited validation\_error location\_already\_exists location\_not\_found location\_terminated reservation\_not\_found conflict internal\_error **message** required A human sentence. Copy, not contract; it may be reworded. string **field** The request field at fault, dotted for a nested one (`plan.term_months`). string #### Example ```json { "error": { "code": "unauthorized" } } ``` ### 429 `rate_limited`. Over this key’s requests-per-minute ceiling. Media typeapplication/json object **error** required object **code** required The stable value to branch on. string Allowed values: unauthorized forbidden\_ip rate\_limited validation\_error location\_already\_exists location\_not\_found location\_terminated reservation\_not\_found conflict internal\_error **message** required A human sentence. Copy, not contract; it may be reworded. string **field** The request field at fault, dotted for a nested one (`plan.term_months`). string #### Example ```json { "error": { "code": "unauthorized" } } ```