How to Check a Creator Country Requirement Before UGC Work

What a profile row gives you

Use Instagram Profile build 0.1.26. The input name is startUrls. You may send 1 to 1,000 public profile URLs, @handles, or plain handles. The same input string is checked once. One row is one attempted input. A row is still one row when the profile is unavailable.

A row can include input, channelId, eimuId, fbid, channelUrl, handle, displayName, and description. It can also include externalUrl, bioLinks, biographyEntities, detectedEmails, and detectedLinks. It can also include businessContactMethod, businessEmail, businessPhoneNumber, businessAddress, and shouldShowPublicContacts. It also includes status, statusReason, observedAt, and isBillable.

Spell the identity field eimuId. Do not shorten it. fbid is an id linked to Meta. Meta is the company behind Instagram and Facebook. fbid is not a Facebook Page ID. Stable identity fields can be null. Optional public facts can be null. Null means the value was not returned. It does not mean zero.

There is no country field on the row. There is no private audience field. The Actor does not open private accounts. It does not collect posts or list followers. It does not find age or discover a location. It does not crawl links off the profile. It does not test email delivery. It does not recover old handles.

A profile status can be ok, partial, private, login_required, or not_found. It can also be blocked, challenge, rate_limited, parser_miss, invalid_input, or failed. Keep statusReason with the status. Keep observedAt. observedAt is the time of that check. An unavailable status does not prove the account was deleted. It does not prove zero followers.

isBillable marks a useful row that can be charged. A status row and a useful row are different counts. isBillable is not a receipt. A receipt is the proof of a charge.

OUTPUT is the run summary. It is not a field on each row. OUTPUT can show requestedChannels, acceptedProfileInputs, and rejectedInputs. It can also show datasetRows, usefulRows, billableRows, and nonUsefulRows. It also shows statusCounts. Read those totals from your own run. Do not fill a missing total with zero. datasetRows counts attempted rows. usefulRows counts useful rows. They are not the same number. nonUsefulRows counts rows that are not useful. statusCounts groups rows by status. A blocked row still counts as a row.

One checked run used one profile. The returned channelId matched the target. The returned channelUrl was the main profile URL. The handle matched the target. The description was not empty. externalUrl was present. detectedLinks was present. Five bioLinks were present. status was ok. detectedEmails was an empty array. businessEmail was null. businessPhoneNumber was null.

An empty detectedEmails array means that run found no email in the public text. It does not prove that no email exists. A null business email or phone means no direct value was returned. It does not mean zero. That run proves identity fields can be filled. It proves link fields can be filled. It does not prove every account has contact data. It does not prove a country or a residence. It does not prove private audience facts. It did not open the link destinations. Country was not returned. Leave country unknown.

1. Write the rule before you check

Write the country rule before you look at any creator. In this method the allowed set is the United States, Canada, and the United Kingdom. Say which question you mean. A working base country for the project is one question. Presence in that country during the project is a different question. Write the project period next to the rule.

Do not swap in a different fact. Audience location is a different fact. Birthplace is a different fact. Nationality is a different fact. The region on the platform account is a different fact. If you mix those facts, you will mark the wrong people. The Actor cannot apply a country filter. For this check, send startUrls only. Do not add a country filter. Do not add maxItems.

2. Check one known profile

Start from profiles that someone already supplied. The Actor cannot find every creator in a country. It cannot return a certified physical place. It only reads the public profiles you name.

For the first test, replace the whole saved startUrls list with one profile you already know. The saved Task list has two public URLs. The URLs are https://www.instagram.com/mrbeast/ and https://www.instagram.com/nasa/. Remove both. If you only add a URL, the sample pair remains.

{
  "startUrls": [
    "https://www.instagram.com/mrbeast/",
    "https://www.instagram.com/nasa/"
  ]
}

Replace that whole list with one known public profile:

{
  "startUrls": [
    "https://www.instagram.com/REPLACE_WITH_ONE_KNOWN_PROFILE/"
  ]
}

Put your real known URL, @handle, or plain handle in startUrls. Use a public profile you already have. After the run, copy channelId, channelUrl, handle, status, statusReason, and observedAt. If channelId is null, leave it unknown. Do not invent a native id. Read the OUTPUT totals from that same run. Keep an unresolved identity separate from the country check. A profile row is not a declaration.

3. Save the public clue with its own date

Copy the exact public passage when it matters. Save the date you saw it. Save the source field, such as description. A bio such as "Toronto | travel" can be a clue. Toronto is a city. A city name does not prove a current base country. A trip word does not prove where the creator works.

status ok does not make a private home public. A filled field does not do that either. businessAddress is a public contact clue. It is not automatically the creator's home. Do not open externalUrl, bioLinks, or detectedLinks to hunt for a home. Those fields are clues only.

4. Store the declaration in a separate record

Keep a second record that you create. It is not an Actor field. Store the known account reference. Store the declared country. Store the confirmation date. The confirmation date is the date the creator gave the declaration. Store the exact question wording. Store the source of the declaration.

Ask only for the base country your rule needs. Do not ask for a street address. Do not collect a private location history. You gather this declaration in your own hiring process. This article does not send messages.

A missing declaration stays missing. Do not copy a bio into the declaration column. Do not copy an audience note into it.

5. Compare the declaration with the allowed set

Use the declaration, the allowed set, and the project period. Use only these four states.

declared_match means the declared country is inside the allowed set. The creator stated a country you accept for this project. That is not a checked home address. That is not legal eligibility to work.

declared_outside means the declared country is outside this allowed set. The state applies only to this rule. It does not judge skill. It does not judge another project with a different rule.

pending_confirmation means the declaration is missing. Missing is not outside. A blank is not a country. If you mark it outside, you treat silence as a fact.

needs_clarification means the evidence conflicts. It also covers an unclear project period. You cannot pick a fair state until the period is clear.

6. Keep both sides of a conflict

If an older public clue and a later declaration differ, record both. Keep each date on its own claim. Do not give both claims one shared time. Ask which base country applies to the project period.

Travel can create a conflict. An old bio can stay up after a change. Those facts are reasons to clarify. They are not reasons to accuse the creator. Do not say the creator lied. Do not guess exact trips from public posts. The Actor does not provide location history.

7. Keep audience country out of the base country

An audience report describes viewers. It does not say where the creator is based. The public Actor does not return private facts about the audience. A report you already hold is your own note. It is not a country field on the profile row.

Views do not fill a missing declaration. Followers do not fill it either. Do not mark a creator as inside the allowed set because many viewers are there.

8. Deliver the register for your list

Give each supplied creator one line. Include the project rule and period. Include the supplied reference and the checked identity. Include status, statusReason, and observedAt. Include the public clue with its own date and source. Include the declaration, its date, its question, and its source. Include the state and the next check.

Count people on your list. Count states on your list. Do not guess a larger group. When the project period changes, ask for a new declaration. When the allowed set changes, ask again. Do not reuse an old declaration in silence.

A blocked observation stays a source gap. A later declaration does not close that gap. It does not prove the account was deleted. You may keep the supplied name. You still must not invent a missing channelId.

Fiction register

The next four creators are original fiction. They are not a product result. They are not real accounts. No real channelId, channelUrl, or handle is used. If a cell says unknown, fill it only from your own run.

The allowed set is the United States, Canada, and the United Kingdom. The project period in this fiction is the March 2026 campaign. The stored question is: "What is your working base country for this project period?"

In this fictional reader identity-check premise, and not as actual product acceptance, each creator declaration belongs to the same reader-checked supplied account reference as its public profile record, the native channelId may remain unknown, and no native identity was invented.

Creator A is declared_match because the declaration says Canada. Canada is inside the allowed set. The bio "Toronto | travel" stays a public clue. Its date is 2026-02-10. The profile check time is 2026-03-01. Those times are different. A city clue can point toward Canada. It still does not set the base country. The match uses the declaration. No one verified a residence.

Creator B is pending_confirmation because no base-country declaration exists. The United States note is an audience report from 2026-02-12. You supplied that report. The Actor did not return it. Viewers in the United States do not put Creator B inside the allowed set. The blocked status is a source gap. It stays a gap if a declaration arrives later. Blocked does not prove deletion. It does not prove zero followers. Leave channelId unknown.

Creator C is declared_outside because the declaration says Spain. Spain is outside this allowed set. The state is about this rule only. It says nothing about a legal right to work. It says nothing about skill. A different allowed set could use a different state.

Creator D is needs_clarification. The London clue is older. Its date is 2025-06-01. The Canada declaration is newer. Its date is 2026-02-18. observedAt 2026-03-02 is only the profile check. Do not put the bio and the declaration under that one time. The March 2026 meaning is still unclear. An old bio or travel can explain the split. Record both claims. Do not pick the convenient country. Do not accuse the creator.

Four creators are on this list. One creator has each state. 1 plus 1 plus 1 plus 1 equals 4. No residence was verified.